> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seomator.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Claude, ChatGPT and other AI tools

> Add SEOmator to Claude, ChatGPT, Claude Code, Cursor or VS Code through MCP so the tool can read your projects and run SEOmator tools.

Add SEOmator to the AI tool you already use, so the tool can read your projects and run SEOmator tools through MCP (Model Context Protocol).

## Before you start

* You need a SEOmator account in at least one organization.
* Find your tool's setup line: in the sidebar, click **MCP**. The **MCP clients** section on the [Integrations](https://docs.seomator.com/settings/integrations.md) page lists each supported tool with its URL or command and a **Copy** button.

![The Integrations page with a Copy button on each MCP client row and the Connected apps list](https://mintcdn.com/se-omator/LHKLDWeFBDdpYX2o/images/integrations.light.png?fit=max\&auto=format\&n=LHKLDWeFBDdpYX2o\&q=85\&s=c2be8589eac46b5a8e881276ba186950)

The server URL is:

```text theme={null}
https://api.seomator.com/mcp
```

## Add SEOmator to your tool

> [tab] Claude
>
> **1. Copy the URL**
>
> On the Integrations page, click **Copy** in the **Claude** row.
>
> **2. Add a connector**
>
> In Claude, add a custom connector with this URL.
>
> **3. Sign in**
>
> Sign in to SEOmator when Claude asks, then [approve the
> connection](#approve-the-connection).

> [tab] ChatGPT
>
> **1. Copy the URL**
>
> On the Integrations page, click **Copy** in the **ChatGPT** row.
>
> **2. Add a connector**
>
> In ChatGPT, add a connector with this URL.
>
> **3. Sign in**
>
> Sign in to SEOmator when ChatGPT asks, then [approve the
> connection](#approve-the-connection).

> [tab] Claude Code
>
> **1. Copy the command**
>
> On the Integrations page, click **Copy** in the **Claude Code** row.
>
> **2. Run it**
>
> Run the command in your terminal:
>
> ```bash theme={null}
> claude mcp add --transport http --scope user seomator https://api.seomator.com/mcp
> ```
>
> **3. Sign in**
>
> In Claude Code, run `/mcp` and sign in to SEOmator.
>
> **4. Approve**
>
> [Approve the connection](#approve-the-connection) in your browser.

> [tab] Cursor
>
> **1. Add it**
>
> On the Integrations page, click **Add to Cursor**. Cursor opens and adds
> SEOmator.
>
> **2. Sign in**
>
> Sign in to SEOmator when Cursor asks, then [approve the
> connection](#approve-the-connection).

> [tab] VS Code
>
> **1. Add it**
>
> On the Integrations page, click **Add to VS Code**. VS Code opens and
> adds SEOmator.
>
> **2. Sign in**
>
> Sign in to SEOmator when VS Code asks, then [approve the
> connection](#approve-the-connection).

Another MCP client that supports remote servers can use the same URL.

## Approve the connection

When you sign in from your tool, SEOmator opens an **Authorize** page in your browser.

**1. Check the account**

Check the email you're signed in with. To use a different account, click
**Use another account**.

**2. Choose the organization**

Under **Organization**, choose the organization the tool may use. A
connection works with one organization only.

**3. Allow it**

Read what the tool can do, then click **Allow**. To refuse, click **Deny**.

The tool is connected and shows under **Connected apps** on the Integrations page. It stays connected while you use it.

A connection can read the organization's projects, reports and AI answers. If it also asks to make changes, it can change projects, prompts and competitors, as your role allows.

## Connect with an API key

Scripts and tools that can't sign in through the browser can use an organization API key instead.

**1. Create a key**

Create a key on the [API keys](https://docs.seomator.com/settings/api-keys.md) page.

**2. Point the client at the key endpoint**

Set the client's server URL to `https://api.seomator.com/mcp/key`.

**3. Send the key**

Send the key in the `x-api-key` header, or as `Authorization: Bearer <key>`.

The client can now use SEOmator tools with the key's access. A read-only key can only use read tools.

## If it doesn't work

* The page says "This consent link is not valid": start the connection again from your tool.
* The page says to create an organization first: create one in SEOmator, then connect again.
* The tool lost access: it may have been disconnected or unused for too long. See [Integrations](https://docs.seomator.com/settings/integrations.md), then connect it again.

## Related

> [card] [Integrations](https://docs.seomator.com/settings/integrations.md)
>
> See and disconnect the apps you approved.

> [card] [API keys](https://docs.seomator.com/settings/api-keys.md)
>
> Create keys for scripts and MCP clients.

> [card] [Agent](https://docs.seomator.com/agent/overview.md)
>
> Ask the same questions inside SEOmator.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.