Ezeo connector

Add Ezeo to Claude, ChatGPT, Cursor, Codex and other assistants, sign in once, and ask about your projects in plain language.

What it is

Anyone with an Ezeo login can add Ezeo to an AI assistant from that assistant's settings, sign in once, and then ask things like "how did EquipMaxx do in Search Console this month?". It is a remote MCP server; there is nothing to install.

Every tool runs as the signed-in user, so you see exactly the projects you see in the Ezeo dashboard. Unmeasured figures come back as null with a note, never as 0. The read tools call no paid API, so a question costs Ezeo nothing: your own assistant plan pays for the model.

Server URL

Use this URL in every assistant:

https://ezeo.ai/mcp

Skip the manual steps: the connect guide has one-click setup for Claude, ChatGPT, Cursor, VS Code and terminal agents.

Open the connect guide

Add it to your assistant

Every assistant uses the same server URL. Find yours below; the steps are the ones the connect guide shows.

Verified means we signed in and got answers end to end: Claude, Claude Code, ChatGPT, OpenAI Codex and Cursor, as of 2026-10-15. The others are set up from each assistant's own documentation and have not been tested yet, so a step may differ. Gemini CLI is not verified: Google no longer lets personal accounts sign in to it, so it needs a Gemini API key or Vertex AI.

Claude

Chat assistantVerified
Open Claude
  1. Click Add custom connector, name it Ezeo and paste the URL (on Team and Enterprise, an owner adds it for the organization first).
  2. Click Connect and sign in with your Ezeo account. Claude desktop and mobile pick it up too.

Server URL

https://ezeo.ai/mcp

ChatGPT

Chat assistantVerified
Open ChatGPT
  1. Under Advanced settings, turn on Developer mode (paid plans).
  2. Click Create, name it Ezeo, paste the URL, choose OAuth and sign in with your Ezeo account.
  3. In a chat, enable Ezeo from the + menu.

Server URL

https://ezeo.ai/mcp

Grok

Chat assistantNot yet verified
Open Grok
  1. Open Connectors → New connector → Custom.
  2. Paste the URL and sign in with your Ezeo account.

Server URL

https://ezeo.ai/mcp

Custom GPT

Chat assistantNot yet verified
Open Custom GPT
  1. Open Configure → Create new action → Import from URL and paste the OpenAPI URL.
  2. Set Authentication to OAuth with the client ID and secret an Ezeo admin registered for this GPT.
  3. Save, copy the callback URL ChatGPT shows, and send it to the admin to allow.

OpenAPI URL

https://ezeo.ai/mcp/openapi.json

Cursor

Code editorVerified
  1. Cursor opens and asks to install ezeo. Click Install.
  2. In Cursor Settings → MCP, click Connect next to ezeo and sign in.

~/.cursor/mcp.json

{
  "mcpServers": {
    "ezeo": {
      "url": "https://ezeo.ai/mcp"
    }
  }
}

GitHub Copilot

Code editorNot yet verified
  1. VS Code opens and asks to install ezeo. Click Install.
  2. Sign in when VS Code asks, then use Ezeo from Copilot Chat in Agent mode.

.vscode/mcp.json

{
  "servers": {
    "ezeo": {
      "type": "http",
      "url": "https://ezeo.ai/mcp"
    }
  }
}

Windsurf

Code editorNot yet verified
  1. Paste it into ~/.codeium/windsurf/mcp_config.json.
  2. Refresh the MCP list in Cascade and sign in.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ezeo": {
      "serverUrl": "https://ezeo.ai/mcp"
    }
  }
}

Claude Code

Command lineVerified
  1. Paste it in a terminal.
  2. Type /mcp in Claude Code, pick ezeo and sign in.

Command

claude mcp add --transport http ezeo https://ezeo.ai/mcp

OpenAI Codex

Command lineVerified
  1. Paste it into ~/.codex/config.toml.
  2. Run codex mcp login ezeo and sign in.

~/.codex/config.toml

[mcp_servers.ezeo]
url = "https://ezeo.ai/mcp"

Gemini CLI

Command lineNot yet verified
  1. Paste it in a terminal.
  2. Run /mcp auth ezeo inside Gemini CLI.

Command

gemini mcp add --transport http ezeo https://ezeo.ai/mcp

Sign in

When the assistant asks you to sign in, use your Ezeo login. You land on an Ezeo page that shows the account you are signed in as and the permissions requested. Choose Allow to approve, or Deny.

The assistant then works as you. Sign-in runs on Ezeo's own sign-in service, so an assistant may briefly show a different address than the URL you pasted.

Then just ask

Once connected, ask in plain language. For example:

Try asking

  • What needs my attention in Ezeo?
  • Which keywords are closest to page one for my store?
  • Give me this week's SEO review for my main project.
  • Plan my next three articles from Ezeo's content ideas.

Tools

The connector offers 16 tools. All are read-only except request_articles, which spends content allowance and always asks first.

list_projectsadd_siteget_setup_statusget_connection_stepsget_project_overviewget_keyword_rankingsget_quick_winsget_weekly_readoutlist_articlesget_content_ideasget_sync_statuslist_waiting_runslist_cro_hypothesesget_cro_auditget_variant_briefrequest_articles

See every tool, its inputs and what it returns

request_articles: preview, then confirm

Each article uses one unit of the project's content allowance, the same as the dashboard button and "ezeo articles request". The tool always takes two calls.

  1. Without a confirmation code it spends nothing. It returns a preview, the allowance left and an 8-character code, or refuses when automation is off or you cannot see the project configuration.
  2. With the code it starts the runs and reports what started, what was already running this week and what was skipped.

The code stops an assistant from spending in a single step, from using a preview older than about 20 minutes, or from changing the count after you agreed. The assistant is told to show you the preview and wait for an explicit yes. Who may spend and whether allowance remains are decided by the database, not by the code.

Limits

  • You only see projects your Ezeo account can already see. Client accounts see a project once it has been granted to them.
  • Starting a site or CRO audit is not exposed. You can read the latest CRO audit, but not run a new one.
  • request_articles is the only tool that writes. There are no other write tools.
  • There are no personal API keys. An agent that cannot open a browser to sign in cannot connect.
  • Ezeo is not listed in the Claude or ChatGPT public directories; you add it as a custom connector.

Source of truth: docs/features/mcp-connector.md and supabase/functions/mcp in the Ezeo repository.

Stuck? Write to us. A person answers.llms.txtconnector.md