Set up Claude with Remote MCP Private Preview

You can connect Claude with the Atlan Remote MCP server to access Atlan metadata in your conversations or desktop environment. This enables you to search for assets, explore lineage, update metadata, create glossary terms, and more directly from Claude.

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 Connector or Claude Desktop installed and updated to the latest version.

Set up Claude connector

You can connect Claude Connector to Atlan Remote MCP using OAuth, which enables users to log in with their Atlan account and use their existing roles and permissions. API Key authentication isn't supported for Claude Connector.

1. In Claude, navigate to Settings → Connectors → Organisation Connector → Add custom connector, and provide the MCP server URL. This step must be completed by an administrator.

   https://<your-tenant>.atlan.com/mcp

2. Save the connector.

3. In the Chat UI, go to Search and Tools → Add Custom Connector → Your Connector.

4. Select the Atlan connector and complete the OAuth login flow. Once you complete authentication, the connector is ready to use.

5. You can now use Atlan MCP tools directly in your Claude conversations.

Set up Claude Desktop

Claude Desktop integrates with Remote MCP through the mcp-remote npm package. This provides a way to connect Claude Desktop with Atlan using either OAuth or API Key authentication.

You can set up Claude Desktop with Remote MCP if you want to access Atlan metadata directly from your desktop environment, without switching to the web interface. This is useful for developers and analysts who prefer working locally while still leveraging Atlan’s metadata context.

OAuth

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.

API Key

1. In Atlan, generate an API key from Admin Settings → API Keys / Tokens and copy it securely.

2. Once the API key is generated, open Claude Desktop and go to Settings → Developer → Edit Config.

3. Add the following configuration:

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

4. Restart Claude Desktop. The server is available with API Key authentication.

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

Troubleshooting

• If you encounter InvalidGrantError: Code not valid, this typically indicates that OAuth was retried too quickly. Quit Claude Desktop, wait 5 minutes, and then reopen the application.
• If tools stop functioning after Claude Desktop has been open for an extended period, restart the application, the authentication token may have expired and not refreshed correctly.
• If you have any issues while configuring Claude Connector or Claude Desktop, contact Atlan Support for assistance.

See also

• Set up the Atlan MCP server locally
• Atlan MCP tools