Connect AgentGateway to Claude

AgentGateway exposes its full management API as a remote Model Context Protocol (MCP) server, which means Claude can use it as a tool. This guide walks through connecting Claude to your AgentGateway account.

What you can do

Once connected, Claude can:

• Manage agent relays — create, list, update, delete, and inspect your agents
• Handle credentials — store API keys in the vault, link them to agents, rotate them safely
• Audit traffic — query request logs, view audit events, summarize error rates and latency
• Configure routing — inspect and update rate limits and circuit breakers
• Monitor usage — check plan limits, health scores, and monthly spend
• Send and read emails — use AgentGateway's email relay to read threads, send replies, or compose drafts
• Set up alerts — create, update, and delete alert rules based on your own conditions

All actions respect your role (admin, manager, or operator) and are scoped to your organization.

Prerequisites

Before connecting, make sure you have:

• An AgentGateway account — sign up if you don't already have one
• Claude Pro, Max, Team, or Enterprise — custom connectors are not available on the Free plan
• A Claude client — Claude.ai (web), Claude Desktop, or Claude Code

Setup instructions

Claude.ai (web) and Claude Desktop

1. Open Claude and go to Settings → Connectors
2. Scroll to the bottom and click Add custom connector
3. Enter the following details:
   • Name: AgentGateway
   • URL: https://app.agentgateway.com/api/mcp
4. Click Add, then Connect
5. A new browser tab will open to the AgentGateway consent page
6. Log in to AgentGateway if prompted
7. Review the requested permissions — AgentGateway will request access to agents, credentials, audit logs, alerts, email, and usage data
8. Click Allow Access

You'll be redirected back to Claude automatically. The connector will show as connected.

That's it. You can now talk to AgentGateway directly from any Claude conversation.

Claude Code

1. Open your MCP config file (~/.config/claude-code/mcp.json on macOS/Linux, or the equivalent path on Windows)
2. Add AgentGateway as a server:

{
  "mcpServers": {
    "agentgateway": {
      "url": "https://app.agentgateway.com/api/mcp"
    }
  }
}

3. Restart Claude Code
4. The first time you invoke an AgentGateway tool, Claude Code will open a browser window to complete OAuth
5. Log in and click Allow Access, then return to Claude Code

Your tokens are stored securely and refreshed automatically. You won't need to re-authenticate unless you explicitly revoke access.

Example prompts

Once connected, try asking Claude any of the following:

You can chain these together conversationally — Claude remembers context within a session, so follow-up questions like "now delete the one from that list with the lowest health score" work naturally.

How it works

AgentGateway's MCP connector uses OAuth 2.0 with PKCE — the same standard used by major SaaS providers for secure authorization. You never paste API keys into Claude. Instead:

1. Claude redirects you to AgentGateway
2. You log in and explicitly grant permission
3. AgentGateway issues a short-lived access token to Claude
4. Claude uses that token to make authenticated requests on your behalf

Tokens refresh automatically, so you stay connected until you revoke access. All actions Claude takes on your behalf are logged in AgentGateway's audit trail, so you always have a full record of what was done and when.

Managing access

You can revoke Claude's access at any time:

From Claude

Go to Settings → Connectors, find AgentGateway, and click Disconnect.

From AgentGateway

Log in to your AgentGateway dashboard, go to Settings → Connected Apps, and revoke the Claude session. This will immediately invalidate any tokens Claude holds, even if you don't disconnect from the Claude side.

Troubleshooting

Security & privacy

• Your credentials stay in AgentGateway. Claude never sees plaintext API keys or secrets — all credentials are fetched and used server-side within AgentGateway.
• Scoped access. Tokens are scoped to your user and organization. Claude cannot access other orgs' data.
• Audit logged. Every action Claude takes is recorded in your audit log with full context.
• Revocable. You can cut Claude off at any time from either side.

What's next

Need help?

• Docs: agentgateway.com/docs
• Support: support@agentgateway.com
• Status: status.agentgateway.com