Connect any MCP client through the AtmanID gateway
Each MCP server you register in AtmanID has a standard MCP endpoint on the gateway:
https://<your AtmanID host>/v1/mcp/<server id>/mcpIt speaks the MCP protocol’s Streamable HTTP transport, so any MCP client that can send a header connects to it unchanged: Claude Code, Cursor, VS Code, and the OpenAI and Claude agent SDKs. The client sees one MCP server. Every tool call it makes goes through the gateway’s checks before it reaches the real server.
1. Get the agent’s token
The agent authenticates with its AtmanID token, minted for this server (token flow). The token decides which tools the agent may call on this server.
2. Add the server to your client
Claude Code
claude mcp add --transport http github-via-atmanid \ https://<your AtmanID host>/v1/mcp/<server id>/mcp \ --header "Authorization: Bearer <agent token>"Cursor (.cursor/mcp.json)
{ "mcpServers": { "github-via-atmanid": { "url": "https://<your AtmanID host>/v1/mcp/<server id>/mcp", "headers": { "Authorization": "Bearer <agent token>" } } }}VS Code (.vscode/mcp.json)
{ "servers": { "github-via-atmanid": { "type": "http", "url": "https://<your AtmanID host>/v1/mcp/<server id>/mcp", "headers": { "Authorization": "Bearer <agent token>" } } }}Google Antigravity (~/.gemini/config/mcp_config.json; some builds use ~/.gemini/antigravity/mcp_config.json.
The editor’s Manage MCP servers → View raw config opens the right one.)
{ "mcpServers": { "github-via-atmanid": { "serverUrl": "https://<your AtmanID host>/v1/mcp/<server id>/mcp", "headers": { "Authorization": "Bearer <agent token>" } } }}Antigravity takes serverUrl, not url: a config copied from Cursor loads no server. The file allows no comments,
and Antigravity reads it at start-up, so restart it after an edit. Its own file, terminal and browser tools never pass
through an MCP server, so turn down what you want governed: terminal auto-execution to ask first, and the browser
agent off.
An agent SDK: use its Streamable HTTP client with the same URL and header.
Tokens expire. A client that keeps a static header needs a fresh token before then; an agent that mints its own token at start-up does not.
If your organisation requires DPoP-bound agent tokens (the Agent Token Policy page), a client that can only send a header — Claude Code, Cursor, VS Code — can’t add the per-request DPoP proof, and the token endpoint refuses it a plain token. Give that agent a time-boxed exception on the same page. Agents built on an SDK that signs DPoP proofs don’t need one.
What the client sees
| The client asks for | What it gets |
|---|---|
| The tool list | The tools the server’s owner approved, limited to the agent’s grant. A tool whose definition changed since approval isn’t shown until the owner approves the change. |
| A tool call that is allowed | The server’s answer, after response inspection (and redaction, for servers marked as handling personal data). |
| A tool call that a policy refuses | A tool result marked as an error, with the reason in plain words, so the model can tell its user why. |
| A tool call held for approval | A tool result saying the call is waiting for a person. Once it’s approved, the same call with the same arguments goes through. |
| Resources, prompts or other non-tool features | “Method not found”. The gateway governs tools only. |
An expired or invalid token is an HTTP 401, which MCP clients treat as “re-authenticate”.
Every call is an event in MCP Gateway → Events and on the audit trail, whichever way it ends.
Which servers this works with
The server behind the endpoint can be:
- a standard MCP server you host, or a vendor’s hosted server such as GitHub, Slack or Stripe (put a hosted server behind AtmanID); or
- a server that implements AtmanID’s tool API (
POST …/tools/<tool>).
You choose which per server in MCP Gateway → Settings, in the protocol choice under the upstream URL. The client doesn’t need to know.
Local servers that a client starts on the same machine (stdio) never cross the network, so the gateway can’t see them (local servers).
© AtmanID · Privacy