MCP setup - Scanova API Documentation

There are two ways to connect, depending on whether your AI tool has native OAuth-based connector support.

Prerequisite

Your account needs the MCP integration enabled — see Access requirements. If the Integrations → Model Context Protocol card shows Upgrade instead of Connect, the rest of this page won’t apply yet.

Step 1: Open the MCP integration

From the dashboard, go to Integrations and click the Model Context Protocol card. This opens a setup panel showing your Scanova MCP server URL:

https://mcp.scanova.io/mcp

with an OAuth badge and a copy button. This is the one URL every client below connects to.

MCP setup panel showing the server URL, client tabs, numbered setup steps, and masked Client ID and Secret fields — The MCP setup panel's Claude tab, with the server URL, numbered steps, Client ID/Secret fields, and the Open Claude Connectors shortcut

Option A: OAuth-native clients (Claude, ChatGPT, Perplexity)

The panel has a tab per client, each with its own numbered steps and a Client ID / Client Secret pair shown inline. Copy both from the panel itself — they are not reproduced here. You then complete an OAuth sign-in and approve access to your Scanova account.

Claude
ChatGPT
Perplexity

Open Connectors settings

In Claude, open Settings → Connectors.

Add a custom connector

Click + Add custom connector.

Paste the server URL

Paste https://mcp.scanova.io/mcp from the panel.

Paste the OAuth credentials

Paste the Client ID and Client Secret shown in the panel’s Claude tab.

Connect and authorize

Click Add, then Connect, and approve access. Sign in to Scanova when prompted.

Turn on developer mode

In ChatGPT, open Settings → Apps → Advanced settings and turn on Developer mode.

Create an app

Create an App and paste https://mcp.scanova.io/mcp as the server URL.

Paste the OAuth credentials

Click Advanced OAuth settings and paste the Client ID and Client Secret shown in the panel’s ChatGPT tab.

Authorize

Authorize Scanova when prompted, then enable it from the tools menu in your chat.

Add a custom connector

In Perplexity, open Customise → Connectors and click + Add Custom Connector.

Name it and paste the server URL

Add a name and paste https://mcp.scanova.io/mcp as the server URL.

Paste the OAuth credentials

Click the Advanced toggle and paste the Client ID and Client Secret shown in the panel’s Perplexity tab.

Add and authorize

Click Add, authorize Scanova when prompted, and start using it in your Perplexity conversations.

Option B: Config-file clients (Cursor, VS Code, Claude Desktop, or anything else)

For MCP clients that don’t have a native OAuth connector UI — they take a JSON config file instead — expand Use a token instead at the bottom of the panel. This generates a Scanova Management API key with environment=mcp, the same token type described in Creating & managing API keys. Click Generate token, then copy the value shown (masked in the panel; copy button reveals the full value to your clipboard). Add it to your client’s MCP config as the Authorization header value — this is the exact format documented in the server’s own README:

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

Put the raw token value in the Authorization header — no Bearer prefix. The server reads whatever’s in that header (it also accepts X-API-Key or Scanova-API-Key) and forwards it as-is to Scanova’s Management API, which rejects anything other than the bare key.

Restart your IDE/client after saving the config.

Revoking access

Token clients: back in the panel’s expanded Use a token instead section, click the trash icon next to the token and confirm. This immediately disables every MCP client using that token. OAuth clients (Claude/ChatGPT/Perplexity): remove the connector from that AI tool’s own connector/settings list — it uses a standard OAuth access token issued to that specific client, independent of the token fallback above.

Troubleshooting

“Invalid token” / tool calls failing with a 401 — the token was revoked or has expired. Generate a new one and update your client’s config.
Tool not found after adding the server — restart your IDE or client; most MCP clients only fetch the tool list once, at startup or connection time
Connection errors — double check the URL is exactly https://mcp.scanova.io/mcp (not /health or the bare origin) and that your network can reach it

Next step

See Available tools for everything your AI assistant can now do.

MCP overview — what the server does, access requirements, and the INTEGRATION_MCP quota gate
Available tools — every tool available once you are connected
Creating & managing API keys — the same key type the token-fallback option here generates, with environment=mcp
Management API overview — the raw-key auth scheme the token fallback authenticates against

​Prerequisite

​Step 1: Open the MCP integration

​Option A: OAuth-native clients (Claude, ChatGPT, Perplexity)

​Option B: Config-file clients (Cursor, VS Code, Claude Desktop, or anything else)

​Revoking access

​Troubleshooting

​Next step

​Related

Prerequisite

Step 1: Open the MCP integration

Option A: OAuth-native clients (Claude, ChatGPT, Perplexity)

Option B: Config-file clients (Cursor, VS Code, Claude Desktop, or anything else)

Revoking access

Troubleshooting

Next step

Related