MCP Client Configuration Examples

Every common MCP client configuration for CrossTrade in one place. For step-by-step screenshots and OAuth, use the per-client tutorials linked at the bottom.

Server URL

https://app.crosstrade.io/v1/api/mcp

That is the only URL most clients need. OAuth, dynamic client registration, and scope handling are handled automatically.

Claude Desktop

Edit the config from Settings → Developer → Edit Config:

{
  "mcpServers": {
    "crosstrade": {
      "url": "https://app.crosstrade.io/v1/api/mcp"
    }
  }
}

Save and restart Claude Desktop. On the next tool call, Claude opens a browser tab for OAuth consent.

For a screenshot walkthrough, use the Claude Desktop setup tutorial.

Claude Code

claude mcp add --transport http crosstrade https://app.crosstrade.io/v1/api/mcp

On the first tool call, Claude Code prints an OAuth URL. Open it in a browser, approve the scope, and return to the terminal.

For a step-by-step walkthrough, use the Claude Code setup tutorial.

Cursor

Settings → Features → MCP → Add MCP Server:

{
  "crosstrade": {
    "url": "https://app.crosstrade.io/v1/api/mcp"
  }
}

Reload the MCP servers list. Cursor prompts for OAuth on the next call.

For a step-by-step walkthrough, use the Cursor setup tutorial.

Cline

Cline accepts a standard MCP config block. Add CrossTrade to the mcpServers map and reload:

{
  "mcpServers": {
    "crosstrade": {
      "url": "https://app.crosstrade.io/v1/api/mcp"
    }
  }
}

For a step-by-step walkthrough, use the Cline setup tutorial.

Continue

Continue accepts the same standard MCP config:

{
  "mcpServers": {
    "crosstrade": {
      "url": "https://app.crosstrade.io/v1/api/mcp"
    }
  }
}

For a step-by-step walkthrough, use the Continue setup tutorial.

OpenAI API remote MCP

For agents built with the OpenAI SDK, pass the CrossTrade URL as the remote MCP connector. Exact parameter shape depends on the SDK and language; the SDK opens the browser tab for OAuth consent and stores the token.

# Pseudocode pattern; consult the current OpenAI SDK docs for the exact API.
agent.add_mcp_server(
    name="crosstrade",
    url="https://app.crosstrade.io/v1/api/mcp",
)

ChatGPT plans (custom connectors / developer mode)

For ChatGPT plans that support remote MCP connectors, add the CrossTrade URL via the plan's connectors UI. The label varies by plan and region: "Apps", "Connectors", "Developer mode", or similar.

For a step-by-step walkthrough, use the ChatGPT setup tutorial.

OAuth notes

All clients above use OAuth 2.1 with PKCE and RFC 7591 dynamic client registration. The handshake is:

1. Client requests /v1/api/mcp without a token.
2. Server returns 401 with WWW-Authenticate: Bearer resource_metadata=....
3. Client follows the link, discovers the auth server, self-registers, and opens the consent screen.
4. User approves the scope.
5. Client exchanges the code for an access token at /v1/oauth/mcp/token.

See MCP Authentication and ChatGPT MCP Authentication for the full reference.

Troubleshooting

Symptom	Most common cause	Fix
Tools missing	Client cached old metadata	Remove and re-add the server
401 unauthorized	Token expired or revoked	Reauthorize
403 Elite required	Account below Elite	Upgrade
408 timeout	NT8 closed or add-on disconnected	Open NT8

For a deeper table, see MCP Troubleshooting and Troubleshoot 401, 403, and 408 Errors (Learn).

Version history

Date	Change
2026-05-06	MCP server launched at https://app.crosstrade.io/v1/api/mcp
2026-05-16	This page added with the canonical client config snippets