diff --git a/console/intelligence/mcp-server.mdx b/console/intelligence/mcp-server.mdx index 0d974bf5..8b9eaa55 100644 --- a/console/intelligence/mcp-server.mdx +++ b/console/intelligence/mcp-server.mdx @@ -129,7 +129,27 @@ If your agent doesn’t support connecting to remote MCP servers directly, use t ``` 1. Restart your AI agent. -1. Authenticate the request in your browser. +1. Authenticate the request in your browser. You can later revoke access on the Profile page of the Axiom Console. + +### Header-based authentication + +If your AI agent doesn’t support browser-based OAuth authentication (for example, Agent Builder from OpenAI), authenticate by passing headers directly: + +1. [Create a personal access token](/reference/tokens#personal-access-tokens-pat). +1. [Determine organization ID](/reference/tokens#determine-organization-id). +1. Configure your AI agent to use the server URL `https://mcp.axiom.co/mcp`. +1. Configure your AI agent to send the following headers with each request to the server URL: + + - **Authorization:** `Bearer PERSONAL_ACCESS_TOKEN` + - **x-axiom-org-id:** `ORGANIZATION_ID` + + + Replace `PERSONAL_ACCESS_TOKEN` with the personal access token you have generated. + + Replace `ORGANIZATION_ID` with the organization ID. + + + If your AI agent only supports setting the Authorization header, pass the organization ID as a URL parameter: `https://mcp.axiom.co/mcp?org-id=ORGANIZATION_ID`