Connect a client

Sign in with your browser

Clients that support MCP OAuth only need the URL. Your browser opens on OCPPLab: sign in, choose the organization the agent may use, and select Allow. No token to copy, and the client refreshes its access on its own.

claude mcp add --transport http ocpplab https://api.ocpplab.io/mcp

This works the same way in Cursor, VS Code, claude.ai connectors and ChatGPT: add https://api.ocpplab.io/mcp with no credentials.

• Reconnecting the same app skips the consent screen and keeps the organization you chose.
• Disconnect an app in Studio under Settings → Connected apps. It loses access within an hour.

Use an SDK token

For CI, scripts and headless agents, where no browser can open, send an SDK token as a header. The examples use the cpo server; swap the name and URL for any other domain.

claude mcp add --transport http ocpplab-cpo https://api.ocpplab.io/mcp/cpo \
  --header 'Authorization: Bearer ${OCPPLAB_TOKEN}'

{
  "mcpServers": {
    "ocpplab-cpo": {
      "type": "http",
      "url": "https://api.ocpplab.io/mcp/cpo",
      "headers": { "Authorization": "Bearer ${OCPPLAB_TOKEN}" }
    }
  }
}

Test the connection

curl -sS -X POST https://api.ocpplab.io/mcp/cpo \
  -H "Authorization: Bearer $OCPPLAB_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

A working setup answers with "name": "ocpplab-cpo" in serverInfo. To browse tools interactively, run npx @modelcontextprotocol/inspector, choose Streamable HTTP, and enter the URL.

Troubleshooting