Skip to content

Add mcp-remote procedure for other clients #410

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 19, 2025
Merged

Add mcp-remote procedure for other clients #410

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 31 additions & 1 deletion console/intelligence/mcp-server.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,8 @@ Axiom MCP Server works with all AI agents that support MCP.
<Tabs>
<Tab title="Claude">

### Claude

If you’re on the Pro, Team, or Enterprise plan:

1. Add Axiom to the list of remote MCP servers:
Expand Down Expand Up @@ -83,13 +85,19 @@ If you’re on the Free plan:
</Tab>
<Tab title="Cursor">

### Cursor

1. Install [Cursor](https://cursor.com/home).
1. [Install Axiom MCP Server](https://cursor.com/en/install-mcp?name=axiom&config=eyJ1cmwiOiJodHRwczovL21jcC5heGlvbS5jby9tY3AifQ%3D%3D).
1. Authenticate the request in your browser.

</Tab>
<Tab title="Other clients">

### Other clients

If your agent supports connecting to remote MCP servers directly:

1. In your AI agent, add a remote MCP connection with the following details:

- **Name:** `Axiom`
Expand All @@ -99,6 +107,28 @@ If you’re on the Free plan:

1. Authenticate the request in your browser. You can later revoke access on the Profile page of the Axiom Console.

If your agent doesn’t support connecting to remote MCP servers directly, use the [mcp-remote library](https://www.npmjs.com/package/mcp-remote):

1. Add the `mcp-remote` library to the configuration file of your AI agent. For example:

```json
{
"mcpServers": {
"axiom": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.axiom.co/mcp"
]
}
}
}
```

1. Restart your AI agent.
1. Authenticate the request in your browser.

</Tab>
</Tabs>

Expand Down Expand Up @@ -245,4 +275,4 @@ To revoke access:
1. In Axiom, go to <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Profile**.
1. In the Sessions section, find the session where you authorized your AI client, and then click <img src="/doc-assets/icons/delete.svg" className="inline-icon" alt="Delete icon" /> **Delete** on the right.

If you connected to Axiom MCP Server by adding `mcp-remote` to `claude_desktop_config.json`, clear the `.mcp-auth` folder. This is where Axiom MCP Server stores credential information. On a Mac, the default path is `~/.mcp-auth`.
If you connected to Axiom MCP Server using the `mcp-remote` library, clear the `.mcp-auth` folder. This is where Axiom MCP Server stores credential information. On a Mac, the default path is `~/.mcp-auth`.