Skip to main content

Set up Claude Desktop with Remote MCP

Connect Claude Desktop to the Atlan Remote MCP server to access Atlan metadata from your local environment without switching to a browser. Requires the mcp-remote npm package. Supports both OAuth (per-user) and API Key (service or automation) authentication.

Prerequisites​

Before you begin, make sure you have:

  • An Atlan tenant with Remote MCP enabled.
  • Claude Desktop installed and updated to the latest version.
  • Node.js installed on your machine (required for npx).
  • An Atlan API key if you plan to use API Key authentication. Generate one from Admin Settings → API Keys / Tokens.

Set up Claude Desktop 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. Open Claude Desktop and go to Settings → Developer → Edit Config.

  2. Add the following configuration:

    {
      "mcpServers": {
        "atlan": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://<your-tenant>.atlan.com/mcp"
          ]
        }
      }
    }

  3. Restart Claude Desktop.

  4. A login prompt appears to complete authentication. After login, Claude Desktop connects to the Remote MCP server using your Atlan roles and permissions.

  5. You can now use Atlan MCP tools inside Claude Desktop.

Need help?​

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

See also​