Claude Code

Claude Code is Anthropic's official CLI for agentic coding tasks. It supports MCP servers with OAuth out of the box — connecting MCPGate takes a single command and a browser approval.

Tip

Claude Code uses OAuth to authenticate with MCPGate. No API key is needed in the URL or config — just paste the base endpoint and complete the OAuth flow when prompted.

Method 1: CLI (Recommended)

Run this command in your terminal to register MCPGate globally:

bash

claude mcp add --transport http mcpgate https://api.mcpgate.sh/mcp

Then run /mcp inside a Claude Code session and click Authenticate when prompted. Your browser will open the MCPGate authorization page — approve access and return to your terminal. MCPGate tools will be available immediately.

Note

Use --scope local (default) to add MCPGate for the current project only, --scope project to share it via .mcp.json with your team, or --scope user to enable it across all your projects.

Method 2: Project Config (.mcp.json)

To share the MCPGate connection with everyone on your team, commit a .mcp.json file at the root of your project:

.mcp.json

json

{
  "mcpServers": {
    "mcpgate": {
      "type": "http",
      "url": "https://api.mcpgate.sh/mcp"
    }
  }
}

Team members who clone the repo will be prompted to authenticate with MCPGate via OAuth the first time they use Claude Code in the project — no manual key distribution required.

Verify the Connection

Run the following command to confirm MCPGate is registered:

bash

claude mcp list

You should see mcpgate listed with your endpoint URL. Start a new Claude Code session and ask it to use one of your connected tools — for example, “List my open GitHub issues” — to confirm end-to-end connectivity.

Troubleshooting

If tools are not appearing, run /mcp to check the server status and re-authenticate if needed. You can also run claude mcp remove mcpgate and re-add it with the command above. Make sure the MCP App in your dashboard has at least one connector enabled and that the tool allowlist is not empty.