Connect · Claude

Use SignalPilot in Claude

Add SignalPilot to Claude as a connector. After that, any chat can ask questions about your data, and every query is checked, limited, and logged before it reaches your database.

You need two things: a SignalPilot account with at least one database connected, and a Claude plan that allows custom connectors. The whole setup takes about five minutes and you never leave the browser.

1. 1

   Copy your SignalPilot API key

   Open SignalPilot, go to Settings → API Keys, and choose Create key. Give it a name you will recognise later, such as claude, and keep the default read and query permissions.

   The key starts with sp_ and is shown once. Copy it now. If you lose it, delete it and create a new one.
2. 2

   Open Claude's connector settings

   In Claude, open Settings → Connectors. Choose Add, then Add custom connector.

3. 3

   Fill in the connector form

   Use these values exactly. Paste your own key in place of the placeholder.

   Name

   SignalPilot

   URL

   https://gateway.signalpilot.ai/mcp

   Authentication

   None

   The API key travels as a request header instead.

   Request header name

   x-api-key

   Request header value

   sp_your_key_here

   Replace with the key from step 1.

   Choose Add. Claude connects to SignalPilot and lists the tools it found.

4. 4

   Allow SignalPilot's domain

   Still in Claude's settings, find the domain allowlist for connectors and set it to All domains. Without this, Claude may refuse to call the connector even though it was added successfully.

5. 5

   Ask your first question

   Start a new chat, open the connector menu, and make sure SignalPilot is switched on. Then ask something you already know the answer to:

   Which five customers had the highest revenue last quarter?

   Claude calls SignalPilot, SignalPilot runs a governed read-only query, and the answer comes back with the SQL it used. Checking a known number first is the fastest way to confirm everything is wired up.

Your key is a password

Anyone with the key can read the data your workspace exposes, within the limits you set. Do not paste it into shared documents or chats. You can revoke a key at any time under Settings → API Keys, and it stops working immediately.

What Claude can do once connected

• Answer questions in plain language. Claude explores your schema, writes SQL, runs it read-only, and explains the result.
• Use your team's definitions. Anything in the knowledge base (what counts as an active customer, which table is the source of truth) is applied automatically.
• Stay inside the guardrails. Writes are blocked, result sizes are capped, sensitive columns can be hidden, and every query lands in the audit log.

If something does not work

What you see	What to do
Claude says the connector could not be reached	Check the URL is exactly https://gateway.signalpilot.ai/mcp with no trailing slash.
"Authentication required"	The header name must be x-api-key and the value must be the full key including the sp_ prefix.
Tools appear but every question fails	Set the domain allowlist to All domains (step 4), then start a new chat.
Claude answers but the numbers look wrong	Add the missing business definition to the knowledge base and ask again.

Next

• Connect a database if you have not added one yet.
• Add other MCP servers so SignalPilot's own chat can reach tools like Notion or Slack.
• Prefer a coding tool? See Claude Code or Cursor and other tools.