Supported clients
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.
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.
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.
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.
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.
Codex
Coding tool. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.
export ONLYMCP_TOKEN=omk_…
codex mcp add onlymcp --url https://only-mcp.com/api/mcp --bearer-token-env-var ONLYMCP_TOKENCodex 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.
Gemini CLI
Coding tool. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.
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.
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.
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:
{
"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.
Cursor
Editor. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.
In ~/.cursor/mcp.json:
{
"mcpServers": {
"onlymcp": {
"url": "https://only-mcp.com/api/mcp",
"headers": {
"Authorization": "Bearer omk_…"
}
}
}
}Checked on 2026-09-25 against the Cursor documentation.
Windsurf
Editor. Connects through a token in a header or the local onlymcp package.
In ~/.codeium/windsurf/mcp_config.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.
Cline
Editor. Connects through a token in a header or the local onlymcp package.
In ~/.cline/mcp.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.
Zed
Editor. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.
In settings.json:
{
"context_servers": {
"onlymcp": {
"url": "https://only-mcp.com/api/mcp",
"headers": {
"Authorization": "Bearer omk_…"
}
}
}
}Checked on 2026-09-25 against the Zed documentation.
Continue
Editor. Connects through a token in a header or the local onlymcp package.
In config.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.
opencode
Coding tool. Connects through a token in a header, an OAuth sign-in or the local onlymcp package.
In opencode.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.