MCP Setup

Use this page to configure Claude with your secure MCP endpoint.

1) Required environment variables

Set these on your deployed server before connecting:

MCP_API_KEY=replace-with-long-random-secret
COGNITO_USER_POOL_ID=...
COGNITO_CLIENT_ID=...
DATABASE_URL=...
CLOUDFLARE_R2_ACCOUNT_ID=...
CLOUDFLARE_R2_ACCESS_KEY_ID=...
CLOUDFLARE_R2_SECRET_ACCESS_KEY=...
CLOUDFLARE_R2_BUCKET_NAME=...
OPENAI_API_KEY=...
GEMINI_API_KEY=...

2) MCP endpoint details

MCP API keySession ID (for SSE)Access token

MCP JSON-RPC URL: https://your-domain.com/api/mcp?mcp_api_key=<YOUR_MCP_API_KEY>&access_token=<YOUR_JWT>

SSE URL: https://your-domain.com/api/mcp/sse?sessionId=<SESSION_ID>&mcp_api_key=<YOUR_MCP_API_KEY>&access_token=<YOUR_JWT>

URL auth params: mcp_api_key and access_token

Optional header fallback: Authorization: Bearer <jwt> and x-mcp-api-key

3) Quick verification with curl

curl -X POST "https://your-domain.com/api/mcp?mcp_api_key=<YOUR_MCP_API_KEY>&access_token=<YOUR_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/list",
    "params":{}
  }'

4) Claude MCP config values

URL: https://your-domain.com/api/mcp?mcp_api_key=<YOUR_MCP_API_KEY>&access_token=<YOUR_JWT>
SSE URL: https://your-domain.com/api/mcp/sse?sessionId=<SESSION_ID>&mcp_api_key=<YOUR_MCP_API_KEY>&access_token=<YOUR_JWT>