Skip to main content

Set up Claude Code with Remote MCP

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.
  • 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​

  1. 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

  2. Start Claude Code by running:

    claude

  3. In the Claude Code terminal, type:

    /mcp

  4. When prompted to authenticate, complete the OAuth flow in your browser. After successful authentication, the Atlan MCP server is available in Claude Code.

Troubleshooting​

npx is not recognized on Windows​

The OAuth setup uses mcp-remote, which requires Node.js and npm. If you see The term 'npx' is not recognized:

  1. Download and install Node.js LTS for Windows.
  2. After installation, restart your terminal.
  3. Verify npm is available by running npm --version.
  4. Re-run the Claude Code MCP setup command.

OAuth token expires and MCP stops working​

If Atlan MCP stops responding after previously working:

  1. In your terminal, run claude mcp remove atlan-oauth.
  2. Re-add the server: claude mcp add --transport http atlan-oauth https://<your-tenant>.atlan.com/mcp.
  3. Complete the OAuth flow again in your browser.

Need help?​

If you have any issues configuring Claude Code, contact Atlan Support for assistance.

See also​