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

# Connect Claude Code

After you connect, an AI can read notes and data published on Exploratory. You register the Exploratory server in Claude Code and sign in through your browser.
It takes about 3 minutes. You need an Exploratory account and Claude Code.

If you already added Exploratory as a connector in the [Claude app](https://docs.exploratory.io/en/mcp/server/clients/claude.md), you do not need to add it again here. Claude Code signed in with the same claude.ai account shows it automatically as "claude.ai Exploratory", and you can use it as is. In Claude Code, open `/mcp` to check. For the steps to add it, see [Connect the Claude app](https://docs.exploratory.io/en/mcp/server/clients/claude.md).

![The /mcp list in Claude Code, with claude.ai Exploratory](https://mintcdn.com/exploratory-inc/WFw15qmp062pMw1-/en/mcp/server/clients/images/en/claude-code-claudeai-connector.png?fit=max\&auto=format\&n=WFw15qmp062pMw1-\&q=85\&s=f55f5e0a4f4aa76e5563462a1692a6f5)

## Requirements

* An Exploratory account
* Claude Code
* You do not need an API key or a client ID.

## Steps

### Register and sign in

This registers only the server, without the plugin or skill.

1. Run this command.

   ```sh theme={null}
   claude mcp add --transport http exploratory-server https://exploratory.io/mcp
   ```

2. Start a new session.

3. Open `/mcp`.

4. Choose the exploratory-server connection.

5. Sign in through the browser.

### Check that it is connected

1. In the new session, send this.

   ```text theme={null}
   Using the connected Exploratory Server, list up to three items I can view, with their URLs. If none are found, say so.
   ```

If items appear with their URLs, the connection works. An empty result does not necessarily mean that authentication or the connection failed. To tell them apart, see [Your content does not appear](https://docs.exploratory.io/en/mcp/server/troubleshooting.md#zero).

A skill gives an AI instructions for using a service. It is separate from the MCP connection settings.

## Add by asking in chat

Instead of running the command yourself, you can ask Claude Code in the chat to add the server.

### Ask in the chat

1. In Claude Code, send this.

   ```text theme={null}
   Add https://exploratory.io/mcp as an MCP server named Exploratory
   ```

   The image below used this request with "Please respond in English." added, so that the reply is in English.

![Asking Claude Code in the chat to add the Exploratory server](https://mintcdn.com/exploratory-inc/WFw15qmp062pMw1-/en/mcp/server/clients/images/en/claude-code-chat-01-add.png?fit=max\&auto=format\&n=WFw15qmp062pMw1-\&q=85\&s=4234d13f37f41f5aeca3948d4a2632ae)

Claude Code ran `claude mcp add` and answered that the server was added to the local config, and that you run `/mcp` to sign in if authentication is required. Which command and which scope (this folder only, or all projects) the AI chooses can differ from run to run, so read its answer.

### Sign in and check

1. Start a new session.

2. Open `/mcp` and check that Exploratory is listed.

3. Choose Exploratory and sign in through the browser.

4. In the new session, send a request such as the one below.

   ```text theme={null}
   Find the "Sales Orders" data on Exploratory.
   ```

Claude Code searches through the Exploratory server and finds the data.

![Claude Code finding the Sales Orders data through the Exploratory server](https://mintcdn.com/exploratory-inc/WFw15qmp062pMw1-/en/mcp/server/clients/images/en/claude-code-chat-02-search.png?fit=max\&auto=format\&n=WFw15qmp062pMw1-\&q=85\&s=77ebe6bdca6ddb005f05e83fef736a89)

If you have more than one Exploratory connection (for example exploratory-server, or a connector added in the Claude app), name the connection to search with, such as "Use the Exploratory MCP server."

## Connect with an API key

If your environment cannot open a browser, register the server with an API key instead of signing in through the browser. Create the key in Account Settings > API Keys. Set it in EXPLORATORY\_API\_KEY through your environment's secret-management facility, such as your operating system's credential store or the secrets of your CI, not through your shell's startup file. Do not write the key itself on the command line or in a configuration file. The steps below assume that this environment variable is already set.

Write the header in .mcp.json (in your project) so that Claude Code reads the key from the environment variable.

```json theme={null}
{
  "mcpServers": {
    "exploratory-server": {
      "type": "http",
      "url": "https://exploratory.io/mcp",
      "headers": {
        "Authorization": "Bearer ${EXPLORATORY_API_KEY}"
      }
    }
  }
}
```

If you type the key on a command line or write it in a settings file as it is, it stays in your shell history or in that file. Read it from an environment variable as above.

Use one way only: the OAuth sign-in above or this one.

* [Connect with an API key](https://docs.exploratory.io/en/mcp/server/auth.md#apikey) - What a key can read and the errors it can return.

## Troubleshooting

| What you see | What to do |
| - | - |
| You are asked to sign in | Open /mcp and sign in again. |
| The same tools appear twice | Use one way only: the plugin from your app's official directory, the direct URL, or the connector on claude.ai. If you later install the plugin from the official directory, first remove the direct entry with claude mcp remove exploratory-server. |

* [Troubleshooting](https://docs.exploratory.io/en/mcp/server/troubleshooting.md) - Fixes by symptom for the Server MCP as a whole.

## Disconnect

Use the steps below for a connection registered directly by command. For a connector inherited from the Claude app, follow "Disconnect" on the [Claude app page](https://docs.exploratory.io/en/mcp/server/clients/claude.md#remove).

```sh theme={null}
claude mcp remove exploratory-server
```

This is the name used in the steps above. If you added the server by chat, use the name you gave it (Exploratory in the example) instead. If the AI added it in a different scope from the default, also add `--scope` with that scope. To see the names you have, run `claude mcp list`.

Removing the registration does not revoke the access you approved. To revoke it, also remove the client under Connected AI Apps in Account Settings on exploratory.io.


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