# Connect Semactic to Claude

Connect the Semactic MCP server to Claude in a few steps. Once connected, Semactic tools are available in your Claude conversations: you query your SEO and GEO data in plain language.

## Before you start

- The MCP server requires the **MCP** add-on on your Semactic account.
- You need your **Semactic API key**: it is on the **Semactic API** card of the **Integration** page. See [Semactic API and MCP server](https://docs.semactic.com/integrations/semactic-api).

> [!NOTE]
> Adding a custom connector may be restricted by your Claude plan or by your organization's administrator. If **Add custom connector** does not appear, ask the owner of your Claude workspace.

## Step 1 — Open Customize

In Claude's left sidebar, click **Customize**.

![MCP_claude_semactic_connector_step1.png](https://docs.semactic.com/api/docs/images/991af8ce-77eb-4c05-a354-ea5558f845ba/content/)

## Step 2 — Add a custom connector

Open the **Connectors** tab, click the **+** button, then choose **Add custom connector**.

![MCP_claude_semactic_connector_step2.png](https://docs.semactic.com/api/docs/images/214d2568-a0d7-498c-8060-3fdea74886b5/content/)

## Step 3 — Fill in the connector

Enter `Semactic` as the name and paste the MCP server URL in the **Remote MCP server URL** field, then click **Add**.

```
https://mcp.semactic.com/mcp
```

![MCP_claude_semactic_connector_step3.png](https://docs.semactic.com/api/docs/images/ea487e10-ee6a-4a4c-8413-6f2a2615dd72/content/)

## Step 4 — Connect

Semactic appears in the **Not connected** list. Click it, then click **Connect**.

![MCP_claude_semactic_connector_step4.png](https://docs.semactic.com/api/docs/images/45e85886-b966-48c2-85e4-2cf78f70772a/content/)

## Step 5 — Enter your API key and authorize

The **Semactic MCP** authorization page opens. Paste your API key in the **API Key** field and click **Authorize**.

![MCP_claude_semactic_connector_step5.png](https://docs.semactic.com/api/docs/images/fe1e3382-5106-4c45-be85-3b2b9b2b5429/content/)

## Step 6 — Check the connection

Semactic moves to the list of connected connectors and its tools are available in your Claude conversations. Try for example: "Which keywords gained the most this month?"

![MCP_claude_semactic_connector_step6.png](https://docs.semactic.com/api/docs/images/98d88b73-e554-4191-a7bb-58e8dfbf6202/content/)

## Troubleshooting

| Problem | What to check |
|---|---|
| **Add custom connector** is missing | Your Claude plan or workspace may not allow custom connectors. Ask the workspace owner. |
| "Invalid API key." on the authorization page | Copy the key again from the **Semactic API** card. If the key was refreshed, the old one no longer works. |
| Semactic stays in **Not connected** | Remove the connector and add it again from step 2. |
| Answers are about another market | Name the market, domain or country in your question. |

For an AI agent or a command-line MCP client, see [Connect Semactic to an agent or another MCP client](https://docs.semactic.com/mcp/connect-agent).
