Skip to main content

Set up Claude Code with Remote MCP

Connect Claude Code to the Atlan Remote MCP server to query, explore, and update Atlan metadata directly from your terminal—no browser or desktop UI required. Supports OAuth (per-user) and API Key (service or automation) authentication.

This guide covers both setup methods.

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 Recommended models: Sonnet 4+, Opus 4.5+​

Choose the setup method that fits your use case. Select OAuth if you want to authenticate using your Atlan account. Choose API Key if you need a static token for automation or service-to-service use cases.

You can use OAuth if you want to authenticate using your Atlan account and roles automatically.

  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.

Need help?​

If you have any issues configuring Claude Code, contact Atlan Support for assistance. For common issues, see Troubleshooting Claude Code with Remote MCP.

See also​