IDE Gateway

Connect your IDE to Clevername through a single MCP endpoint. Add the gateway URL, sign in in your browser, and your tools appear automatically.

Key Concepts

How the gateway works

The IDE gateway exposes a single MCP endpoint that aggregates all your installed integration directory servers, custom connections, and built-in tools. Your IDE connects to one URL and, in OAuth-capable clients, signs in through the browser instead of configuring each server individually.

OAuth login

Most MCP clients can discover Clevername's OAuth endpoints automatically. Add the gateway URL, accept the browser prompt, sign in, and the client stores a refreshable session without making you paste a token.

Fallback tokens

Use tokens only when needed — Older MCP clients can still authenticate with a cn-live-* personal access key as a bearer token (legacy cnk_* keys are still accepted)
Scoped access — Tokens can still be restricted by tool allowlist, budget, and expiry
Same gateway URL — OAuth and token-based clients both connect to https://clevername.net/api/hub/mcp/gateway

Step-by-Step Guide

Add the Clevername gateway URL

Use the same MCP URL in every client:

https://clevername.net/api/hub/mcp/gateway

IDE MCP settings with the Clevername gateway URL entered as a single server connection

For modern MCP clients, the gateway URL is enough to start the browser login flow.

Tip

If your client supports MCP OAuth, do not add an Authorization header. The client should prompt you to sign in instead.

Configure Claude Code

The quickest way is one command in your terminal:

claude mcp add --transport http clevername-mcp https://clevername.net/api/hub/mcp/gateway

To check the server into a project instead, add it to a .mcp.json file at the repo root (Claude Code does not read mcpServers from ~/.claude/settings.json):

{
  "mcpServers": {
    "clevername-mcp": {
      "type": "streamable-http",
      "url": "https://clevername.net/api/hub/mcp/gateway"
    }
  }
}

Note

After saving, Claude Code should open a browser login window the first time it connects.

Configure VS Code (Copilot MCP)

In VS Code, open your .vscode/mcp.json or user settings and add:

{
  "servers": {
    "clevername-mcp": {
      "type": "http",
      "url": "https://clevername.net/api/hub/mcp/gateway"
    }
  }
}

Configure Cursor

In Cursor, open Settings → MCP Servers and add a new server:

{
  "mcpServers": {
    "clevername-mcp": {
      "url": "https://clevername.net/api/hub/mcp/gateway"
    }
  }
}

Tip

All three IDEs use the same gateway URL. The only difference is the configuration file format and where each client stores it.

Sign in or use a fallback token

OAuth-capable clients should now prompt you to sign in through the browser. If your client does not support OAuth yet, create a cn-live-* personal access key at Settings → Keys → Personal Access Keys and add it as a bearer header instead.

Claude Code terminal showing a successful MCP connection after browser login

A successful connection shows all your Clevername tools available after sign-in.

Integrations Overview Integration Directory Config Import / Export MCP Connections