Sign in

MCP Server

Connect Evergreen to AI coding tools like Claude Code, Cursor, and Claude Desktop using the Model Context Protocol (MCP).

Evergreen exposes a Model Context Protocol (MCP) server that lets AI coding tools query your website intelligence data directly. Access it from Settings → MCP Server in your organization.

Two authentication methods are available:

MethodBest for
OAuth (recommended)Interactive clients — Claude Code, Cursor, Claude Desktop, and any MCP client that supports the OAuth browser flow
API keysScripts, CI pipelines, and clients that cannot complete a browser-based OAuth flow

OAuth (Recommended)

OAuth lets you authorize Evergreen through your browser — no secrets to copy or rotate.

Key properties:

  • One-click browser authorization
  • Tokens auto-refresh automatically
  • Revocable per connected client
  • Scoped to the account you authorize (personal or organization)

Connecting via OAuth

Run the following command in your terminal, replacing the endpoint URL with the one shown on your MCP Server settings page:

claude mcp add --transport http evergreen <your-mcp-endpoint-url>

Your MCP client will open a browser window to complete the authorization flow. Once approved, the client receives a scoped token that refreshes automatically.

API Keys

API keys are long-lived bearer tokens for use in scripts, CI environments, or MCP clients that do not support OAuth.

Key properties:

  • Paste directly into your MCP client configuration
  • Read-only access, same permission scopes as OAuth
  • Revoke any key at any time from the settings page

Creating an API Key

  1. Open Settings → MCP Server and scroll to the API keys section.
  2. Click Create API key.
  3. Give the key a descriptive name (e.g. ci-pipeline or cursor-local).
  4. Copy the key immediately — it is shown only once.

Using an API Key

Add the Evergreen MCP server to your AI tool's MCP configuration and replace your-api-key-here with the key you created.

Example configuration snippet (exact format depends on your client):

{
  "mcpServers": {
    "evergreen": {
      "url": "<your-mcp-endpoint-url>",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

Revoking an API Key

Navigate to Settings → MCP Server, find the key in the list, and click Revoke. The key is invalidated immediately.

Supported Clients

Any MCP-compatible client works with Evergreen's MCP server. Clients confirmed to support the OAuth browser flow:

  • Claude Code
  • Cursor
  • Claude Desktop

Clients without browser-based OAuth support (headless scripts, CI pipelines) should use API keys.

Related

PreviousNotification PreferencesNextOAuth 2.0 & API Access