Set up Claude Code with Remote MCP Private Preview
You can connect Claude Code to the Atlan Remote MCP server to access Atlan metadata directly from your terminal. This is designed for developers who prefer a CLI-based experience and want Atlan metadata context while coding, scripting, or debugging—without switching to a web or desktop UI.
Claude Code supports both OAuth and API Key authentication for connecting to Atlan Remote MCP.
Prerequisites
Before you begin, make sure you have:
- An Atlan tenant with Remote MCP enabled. If you don't have access, contact Atlan support or your Atlan customer team to request it.
- Claude Code installed and available in your terminal.
- An Atlan API key if you plan to use API Key authentication. Generate one from Admin Settings → API Keys / Tokens.
Set up Claude Code
- OAuth
- API Key
-
In your terminal, add the OAuth-based Remote MCP server for Claude Code by running:
claude mcp add --transport http atlan-oauth https://<your-tenant>.atlan.com/mcp -
Start Claude Code by running:
claude -
In the Claude Code terminal, type:
/mcp -
When prompted to authenticate, complete the OAuth flow in your browser. After successful authentication, the Atlan MCP server is available in Claude Code.
-
In Atlan, generate an API key from Admin Settings → API Keys / Tokens and copy it securely.
-
In your terminal, add the API Key-based Remote MCP server for Claude Code by running:
claude mcp add-json atlan-api-key '{"type":"http","url":"https://tenant.atlan.com/mcp/api-key","headers":{"Authorization":"Bearer <API_KEY>"}}' -
Start Claude Code by running:
claude -
In the Claude Code terminal, type:
/mcp -
Confirm that the Atlan MCP server is listed and connected.
Need help?
If you have any issues configuring Claude Code, contact Atlan Support for assistance.