Set up Cursor with Remote MCP
You can connect Cursor, an AI-powered editor, with the Atlan Remote MCP server. This lets you search for assets, explore lineage, update metadata, create glossary terms, and more directly from your development environment.
The fastest way to connect is the Atlan Cursor plugin, which registers the hosted MCP server for you and handles OAuth automatically.
Prerequisites
Before you begin, make sure you have:
- An Atlan tenant with Remote MCP enabled.
- Cursor installed and updated to the latest version.
Set up Remote MCP Recommended models: GPT-5, Sonnet 4+, Gemini 3.0 Pro
Choose the setup method that fits your use case.
- Select the Atlan plugin if you want a fast, one-click install with automatic OAuth.
- Choose Manual configuration if you can't install plugins or need API key authentication instead of OAuth.
- Atlan plugin
- Manual (OAuth)
- Manual (API key)
You can use the Atlan plugin if you want the fastest, one-click setup with automatic OAuth. The plugin registers Atlan's hosted MCP server (https://mcp.atlan.com/mcp) with Cursor, so no API key or JSON editing is required.
The Atlan plugin lives in Cursor's plugin marketplace (used to register MCP servers and agents), not the extension marketplace in the sidebar. Make sure you're in the right place before searching.
-
In Cursor, press
Cmd+Shift+J(macOS) orCtrl+Shift+J(Windows/Linux) to open Cursor settings, then go to Plugins. -
Search for Atlan and click Install on the Atlan plugin.
-
Open any chat in Cursor and trigger an Atlan tool (for example, "search Atlan for the customers table"). On first use, Cursor opens the Atlan login page (SSO is supported). Once you log in, Cursor connects to the Remote MCP server using your Atlan roles and permissions.
-
To verify the connection, return to Cursor settings and go to Features → Model Context Protocol. The
atlanserver appears in the list. -
Start using MCP tools directly inside Cursor. For more information, see the list of Atlan MCP tools.
You can use manual configuration with OAuth if you prefer to add the MCP server JSON yourself. OAuth uses your Atlan login and permissions.
-
In Cursor, go to Settings → Cursor Settings → Tools and Integration from the left-hand panel.
-
Click New MCP Server and add the configuration:
{"mcpServers": {"atlan": {"type": "http","url": "https://mcp.atlan.com/mcp"}}} -
Save and return. Cursor prompts you to log in with your Atlan account.
-
After selecting log in, you are redirected to the Atlan login page (SSO is supported). Once you complete the login, Cursor connects to the Remote MCP server using your roles and permissions.
-
After setup, you can use MCP tools directly inside Cursor. For more information, see the list of Atlan MCP tools.
You can use manual configuration with an API key if you want Cursor to connect using a static token for automation or service-to-service use cases.
-
In Atlan, generate an API key by going to Admin Settings → API Keys / Tokens.
-
Once the API key is generated, open Cursor and navigate to Settings → Cursor Settings → Tools and Integration from the left-hand panel.
-
Click New MCP Server and add the configuration:
{"mcpServers": {"Atlan MCP Remote API Key": {"url": "https://mcp.atlan.com/mcp/api-key","headers": {"Authorization": "<your-api-key>"}}}} -
Save the configuration. The server is ready with API key authentication, and Cursor connects to Atlan metadata through Remote MCP.
-
After setup, you can use MCP tools directly inside Cursor. For more information, see the list of Atlan MCP tools.
Need help?
If you have any issues while configuring the integration, contact Atlan Support for assistance.