Skip to main content

Set up Claude Desktop with Remote MCP Private Preview

You can connect Claude Desktop to the Atlan Remote MCP server to access Atlan metadata directly from your desktop environment. This is useful for developers and analysts who prefer working locally while still leveraging Atlan's metadata context—without switching to the web interface.

Claude Desktop connects to Atlan Remote MCP through the mcp-remote npm package and supports both OAuth and API Key authentication.

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

  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.

See also​