# Supported clients

Every AI client with a checked setup for OnlyMCP: how it connects, through OAuth, a token or the local package, the exact commands, and when it was checked.

Any client that speaks MCP can connect to OnlyMCP. The clients below are the ones with checked setup instructions: each entry says how the client connects, which command or configuration to use, and on which date this was last checked against the client’s own documentation. The list is generated from the registry the product itself uses.

There are two routes. The remote route connects the client straight to `https://only-mcp.com/api/mcp`, with a token or through an OAuth sign-in; the code blocks below are for this route. The local route runs the onlymcp package on your machine, and the client talks to it over stdio: it needs Node.js 22 or newer, and the package signs in through `npx onlymcp login` instead of a token, see [import and sync](https://only-mcp.com/docs/import-and-sync).

In the commands, `omk_…` stands for a token. You create one in the dashboard under Connect. Clients that sign in through OAuth need no token at all: they open a browser window and ask you to allow the connection.

## Claude Code

Coding tool. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.

```bash
claude mcp add --transport http --scope user onlymcp https://only-mcp.com/api/mcp --header "Authorization: Bearer omk_…"
```

The local route instead: `npx onlymcp install --client claude-code` registers the local onlymcp package (stdio) in Claude Code. Run `npx onlymcp login` first; this route needs no token.

Checked on 2026-09-25 against [the Claude Code documentation](https://code.claude.com/docs/en/mcp-quickstart).

## Claude

Chat app. Connects through an OAuth sign-in.

Add OnlyMCP as a custom connector with the address `https://only-mcp.com/api/mcp`. The sign-in runs through OAuth, there is no token to copy.

Claude connects through OAuth. Static headers exist only in a limited beta.

Checked on 2026-09-25 against [the Claude documentation](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

## ChatGPT

Chat app. Connects through an OAuth sign-in.

Add OnlyMCP as a custom connector with the address `https://only-mcp.com/api/mcp`. The sign-in runs through OAuth, there is no token to copy.

Custom MCP connectors live in ChatGPT’s developer mode on the web, and need a paid plan.

Checked on 2026-09-25 against [the ChatGPT documentation](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt).

## Codex

Coding tool. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.

```bash
export ONLYMCP_TOKEN=omk_…
codex mcp add onlymcp --url https://only-mcp.com/api/mcp --bearer-token-env-var ONLYMCP_TOKEN
```

Codex reads ONLYMCP_TOKEN from the environment every time it starts. Put the export line in your shell profile, not just the current terminal session.

The local route instead: `npx onlymcp install --client codex` registers the local onlymcp package (stdio) in Codex. Run `npx onlymcp login` first; this route needs no token.

Checked on 2026-09-25 against [the Codex documentation](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

## Gemini CLI

Coding tool. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.

```bash
gemini mcp add --transport http --scope user onlymcp https://only-mcp.com/api/mcp --header "Authorization: Bearer omk_…"
```

The local route instead: `npx onlymcp install --client gemini-cli` registers the local onlymcp package (stdio) in Gemini CLI. Run `npx onlymcp login` first; this route needs no token.

Checked on 2026-09-25 against [the Gemini CLI documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md).

## Gemini

Chat app. Connects through an OAuth sign-in.

Add OnlyMCP as a custom connector with the address `https://only-mcp.com/api/mcp`. The sign-in runs through OAuth, there is no token to copy.

Custom connectors are limited to Gemini Spark and are not available in every country.

Checked on 2026-09-25 against [the Gemini documentation](https://support.google.com/gemini/answer/17209137).

## GitHub Copilot (VS Code)

Editor. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.

In `.vscode/mcp.json`:

```json
{
  "servers": {
    "onlymcp": {
      "type": "http",
      "url": "https://only-mcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer omk_…"
      }
    }
  }
}
```

Business and Enterprise tenants must enable the MCP policy first.

Checked on 2026-09-25 against [the GitHub Copilot (VS Code) documentation](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).

## Cursor

Editor. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.

In `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "onlymcp": {
      "url": "https://only-mcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer omk_…"
      }
    }
  }
}
```

Checked on 2026-09-25 against [the Cursor documentation](https://cursor.com/docs/mcp).

## Windsurf

Editor. Connects through a token in a header or the local onlymcp package.

In `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "onlymcp": {
      "serverUrl": "https://only-mcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer omk_…"
      }
    }
  }
}
```

An admin allowlist can block servers that are not listed.

Checked on 2026-09-25 against [the Windsurf documentation](https://docs.windsurf.com/windsurf/cascade/mcp).

## Cline

Editor. Connects through a token in a header or the local onlymcp package.

In `~/.cline/mcp.json`:

```json
{
  "mcpServers": {
    "onlymcp": {
      "type": "streamableHttp",
      "url": "https://only-mcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer omk_…"
      }
    }
  }
}
```

Checked on 2026-09-25 against [the Cline documentation](https://docs.cline.bot/mcp/mcp-overview).

## Zed

Editor. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.

In `settings.json`:

```json
{
  "context_servers": {
    "onlymcp": {
      "url": "https://only-mcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer omk_…"
      }
    }
  }
}
```

Checked on 2026-09-25 against [the Zed documentation](https://zed.dev/docs/assistant/model-context-protocol).

## Continue

Editor. Connects through a token in a header or the local onlymcp package.

In `config.yaml`:

```yaml
mcpServers:
  - name: onlymcp
    type: streamable-http
    url: https://only-mcp.com/api/mcp
    requestOptions:
      headers:
        Authorization: Bearer omk_…
```

Checked on 2026-09-25 against [the Continue documentation](https://docs.continue.dev/customize/deep-dives/mcp).

## opencode

Coding tool. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.

In `opencode.json`:

```json
{
  "mcp": {
    "onlymcp": {
      "type": "remote",
      "url": "https://only-mcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer omk_…"
      }
    }
  }
}
```

Checked on 2026-09-25 against [the opencode documentation](https://opencode.ai/docs/mcp-servers/).

## Where to go next

- [MCP explained](https://only-mcp.com/docs/mcp-explained)
- [Import and sync](https://only-mcp.com/docs/import-and-sync)
- [Connectable MCP servers](https://only-mcp.com/docs/mcp-servers)
- [Pricing](https://only-mcp.com/pricing)