Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Installation

Detailed setup instructions for every supported editor and environment.

Cursor

The fastest way. Click Install to Cursor on your dashboard and Cursor will configure the MCP server automatically.

Alternatively, add to your .cursor/mcp.json:

{
  "mcpServers": {
    "gateway": {
      "type": "http",
      "url": "https://gateway-mcp.oxc.dev/mcp"
    }
  }
}

Claude Code (CLI)

claude mcp add gateway --transport http https://gateway-mcp.oxc.dev/mcp

This registers the Gateway MCP server. Claude Code handles OAuth authentication automatically — it will open a browser window for you to authorize on first use.

OpenCode

Add to your opencode.json at the project root:

{
  "mcp": {
    "gateway": {
      "type": "http",
      "url": "https://gateway-mcp.oxc.dev/mcp"
    }
  }
}

Other MCP Clients (Bearer Token)

For any MCP client that supports HTTP transport with custom headers:

  1. Go to your Gateway dashboard
  2. Open the Other tab in the MCP integration section
  3. Copy the configuration with your embedded bearer token
{
  "gateway": {
    "type": "http",
    "url": "https://gateway-mcp.oxc.dev/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_TOKEN"
    }
  }
}

The bearer token is a JWT valid for 90 days. It authenticates you the same way OAuth does — your connected providers and permissions are identical.

Verifying Your Connection

After installation, ask your AI assistant:

Search for available Gateway actions

You should see a list of your connected providers and their available actions. If you see "no providers connected", go back to your dashboard and connect at least one provider.

Troubleshooting

"No providers connected"

You've installed the MCP server but haven't connected any providers yet. Go to gateway.oxc.dev and click Connect on Linear, Notion, or Slack.

OAuth window doesn't open

Some MCP clients don't support OAuth. Use the bearer token method instead (Other tab on your dashboard).

Token expired

Bearer tokens expire after 90 days. Go to your dashboard and copy the updated configuration from the Other tab.