π What this article covers
This article explains how to connect Search Atlas to Claude. In Claude Desktop, you add a custom connector and sign in with OAuth. You do not paste an API key. Claude Code uses a Search Atlas API key sent as the X-API-KEY header. If a connection fails, the credential is expired, revoked, incomplete, or copied incorrectly. Your email address is not the credential.
β Before you connect
Confirm these items before you start:
- You are signed in to the Search Atlas account you want Claude to use.
- For Claude Code, you can create an API key while signed in to the Search Atlas account. Open Settings, select the API Key tab, and choose Generate. Claude Desktop does not use that key.
- You are using a current version of Claude that supports custom MCP connectors.
- You copy the token once and store it somewhere private. Do not share it in email or chat.
βοΈ Create a fresh token in Search Atlas
- Sign in to Search Atlas with the account you want to connect.
- Open Settings and select the API Key tab. You can also generate the key from the Claude Code connection steps.
- For Claude Code, generate a new Search Atlas API key. Do not reuse an old key if you are unsure it is still active. Revoked keys and incomplete copies are rejected. Claude Desktop does not use this key. It asks you to authorize Search Atlas after you add the connector.
- Copy the full token immediately. Select the entire value, with no spaces before or after it.
- If the screen shows the token only once, paste it into the connector right away. If you lose it, create a new one.
π Add the connector in Claude
- In Claude Desktop, open Customize, then Connectors.
- Select Add, then Add custom connector. Name it searchatlas and set the MCP URL to https://mcp.searchatlas.com/mcp/. Then select Add and Connect, and finish the Search Atlas authorization.
- For Claude Code, put the API key only in the X-API-KEY header. Do not paste your email address, password, or account name into that header. Do not start an OAuth flow for Claude Code. Claude Desktop does not ask you to paste a key.
- After Claude Desktop finishes the Search Atlas authorization, the connector is connected. For Claude Code, the setup command or setup prompt finishes by checking that Search Atlas tools are available.
- Ask Claude to use a Search Atlas tool, such as checking a site or keyword data for your account, to confirm the connection works.
π οΈ Fix the invalid token message
If Claude cannot connect, or Search Atlas reports that the token or API key is invalid, expired, revoked, or not accepted, work through this list.
- Create a new token. The previous token may be expired, revoked, or only partly copied.
- Paste the complete value. A missing character at the start or end makes the token invalid.
- Remove extra characters. Delete spaces, line breaks, and quotation marks around the token.
- Use the correct field. Put the token in the authorization or token field, not in a label, URL, or email field.
- Match the account. Generate the token while signed in to the Search Atlas account you intend to use. Connecting an email address alone does not authorize Claude.
- Remove the old connector. Delete the failed Claude connector, add it again, and paste only the new token.
- Start a new chat. An existing chat may keep using the rejected token.
π‘ Good practices
- Use one token per connector so you can revoke it without affecting other tools.
- Revoke a token immediately if it was pasted into the wrong place or shared with someone else.
- Do not send tokens to support. Our team can help you check the connection without seeing the secret value.
π¬ Still need help
If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.