Claude

Configure Anthropic’s Claude Desktop app or Claude Code CLI to use agentgateway as an MCP server.

ℹ️

This page covers connecting Claude as an MCP client. To proxy Claude Code’s LLM traffic (prompts and responses) through agentgateway, see the Claude Code LLM client guide.

Before you begin

Install and run agentgateway.
Confirm agentgateway is up by opening the agentgateway UI.
Use the same MCP endpoint and port that your local config exposes. Common examples include:
- http://localhost:15000/mcp/sse
- http://localhost:15000/mcp/http
- If you run agentgateway on a different host or port, replace localhost:15000 in the examples accordingly.

Claude Desktop

Add agentgateway to your Claude Desktop configuration file.

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:15000/mcp/sse"
    }
  }
}

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:15000/mcp/sse"
    }
  }
}

Claude Code CLI

Configure Claude Code to connect to agentgateway.

claude mcp add agentgateway --transport sse http://localhost:15000/mcp/sse

Or, add to your project’s .mcp.json.

{
  "mcpServers": {
    "agentgateway": {
      "type": "sse",
      "url": "http://localhost:15000/mcp/sse"
    }
  }
}

Streamable HTTP Transport

For better performance, use the streamable HTTP transport.

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:15000/mcp/http"
    }
  }
}

Authentication

If agentgateway requires authentication, include the token in the URL or headers.

{
  "mcpServers": {
    "agentgateway": {
      "url": "http://localhost:15000/mcp/sse",
      "headers": {
        "Authorization": "Bearer your-token-here"
      }
    }
  }
}

Cursor