Skip to main content

Set up Windsurf with Remote MCP Private Preview

You can connect Windsurf with the Atlan Remote MCP server to bring Atlan metadata into your AI-driven flows. Windsurf supports API Key authentication, OAuth isn't available.

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.
  • Windsurf installed and updated to the latest version.

Set up Remote MCP in Windsurf​

You can set up Windsurf with the Remote MCP server using API Key authentication.

  1. In Atlan, generate an API key by going to Admin Settings → API Keys / Tokens, creating a new key, and copying it securely.

  2. For Remote MCP with API Key, use the following endpoint:

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

  3. In Windsurf, open the MCP configuration file and add the following configuration:

    {
      "mcpServers": {
        "Atlan MCP Remote": {
          "serverUrl": "https://<your-tenant>.atlan.com/mcp/api-key",
          "headers": {
            "Authorization": "<your-api-key>"
          }
        }
      }
    }

  4. Save the configuration. Windsurf is now connected to Atlan Remote MCP with API Key authentication.

    After setup, you can use MCP tools directly inside Windsurf. For more information, see the list of Atlan MCP tools.

Need help?​

If you have any issues while configuring Windsurf with Remote MCP, contact Atlan Support for assistance.