Skip to main content

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.

Atlan Remote MCP supports three ways to use Claude, depending on how you prefer to work:

  • Claude Connector: Use Atlan MCP directly in the Claude web UI for conversational metadata access.

  • Claude Desktop: Access Atlan metadata from the Claude desktop app, ideal for local and offline-first workflows.

  • Claude Code: Work with Atlan metadata from the terminal, designed for developers who prefer a CLI-based experience.

Prerequisites​

Before you begin, make sure you have:

Set up Claude connector Recommended models: Claude Sonnet 4+​

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.

  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.

Set up Claude Code​

Claude Code is a terminal-based interface for interacting with Claude. You can set up Claude Code if you prefer working from the command line and want to access Atlan metadata while developing, scripting, or debugging—without using the web or desktop UI.

  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 while configuring Claude Connector, Desktop, or Code, contact Atlan Support for assistance.

See also​