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 four 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.
Claude Code Plugin: Install the official Atlan plugin from the Claude Code marketplace for a zero-configuration setup with no API keys required.

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

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
```
Save the connector.
In the Chat UI, go to Search and Tools → Add Custom Connector → Your Connector.
Select the Atlan connector and complete the OAuth login flow. Once you complete authentication, the connector is ready to use.
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
API Key

Open Claude Desktop and go to Settings → Developer → Edit Config.

Add the following configuration:

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

Restart Claude Desktop.
A login prompt appears to complete authentication. After login, Claude Desktop connects to the Remote MCP server using your Atlan roles and permissions.
You can now use Atlan MCP tools inside Claude Desktop.

In Atlan, generate an API key from Admin Settings → API Keys / Tokens and copy it securely.
Once the API key is generated, open Claude Desktop and go to Settings → Developer → Edit Config.

Add the following configuration:

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

Restart Claude Desktop. The server is available with API Key authentication.
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.

OAuth
API Key

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
```
Start Claude Code by running:
```
claude
```
In the Claude Code terminal, type:
```
/mcp
```
When prompted to authenticate, complete the OAuth flow in your browser. After successful authentication, the Atlan MCP server is available in Claude Code.

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

In your terminal, add the API Key-based Remote MCP server for Claude Code by running:

claude mcp add-json atlan-api-key '{"type":"http","url":"https://tenant.atlan.com/mcp/api-key","headers":{"Authorization":"Bearer <API_KEY>"}}'

Start Claude Code by running:
```
claude
```
In the Claude Code terminal, type:
```
/mcp
```
Confirm that the Atlan MCP server is listed and connected.

Set up Claude Code Plugin

The Atlan Claude Code Plugin is available on the Claude Code marketplace and connects to Atlan via OAuth. No API keys or manual MCP configuration are required.

You can set up the Claude Code Plugin if you want the same Atlan metadata access in Claude Code with zero configuration. Install the plugin from the marketplace and sign in once with your Atlan account; the plugin provides the same MCP tools (search, lineage, governance, data quality, data mesh, and more) as the manual Claude Code setup.

In your terminal, start Claude Code by running:
```
claude
```

Inside Claude Code, add the marketplace and install the Atlan plugin:

/plugin marketplace add atlanhq/agent-toolkit
/plugin install atlan@atlan-marketplace

When prompted, complete the OAuth login flow in your browser. The plugin connects automatically to Atlan.
You can now use Atlan MCP tools inside Claude Code.

To run the plugin from a local clone of the repository instead of the marketplace, use claude --plugin-dir ./claude-plugin. The plugin source is available at github.com/atlanhq/agent-toolkit.

Need help?

If you have any issues while configuring Claude Connector, Desktop, Code, or the Claude Code Plugin, contact Atlan Support for assistance.

Prerequisites​

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

Set up Claude Desktop​

Set up Claude Code​

Set up Claude Code Plugin​

Need help?​

See also​