Anthropic Messages API

The Messages API MCP connector reaches Servicebay from Anthropic's side. You do not run an MCP client in your process.

curl https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Who am I in Servicebay?"}],
    "mcp_servers": [
      {
        "type": "url",
        "url": "https://oauth.servicebay.io/mcp",
        "name": "servicebay",
        "authorization_token": "sk_live_YOUR_KEY"
      }
    ],
    "tools": [
      { "type": "mcp_toolset", "mcp_server_name": "servicebay" }
    ]
  }'

Field	Required	Notes
`type`	yes	`"url"` only
`url`	yes	Must be `https://`
`name`	yes	Must match exactly one `mcp_toolset.mcp_server_name`
`authorization_token`	for Servicebay	API key or OAuth access token

The current beta header is mcp-client-2025-11-20 (mcp-client-2025-04-04 is deprecated). Each server needs exactly one matching mcp_toolset.

Python:

response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "List customers named Jane"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://oauth.servicebay.io/mcp",
        "name": "servicebay",
        "authorization_token": key,
    }],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "servicebay"}],
    betas=["mcp-client-2025-11-20"],
)

Compatibility matrix · Troubleshooting