Ask Claude questions about your Corvidae reporting data in plain English, for example "How did paid search perform last week?" or "Which channels drove the most revenue this month?".
Claude connects to Corvidae through a secure connector. It can only read data, it cannot change anything, and you only ever see the companies you are authorised for.
What you need
-
A Corvidae login (the one you use to sign in to Corvidae).
-
Claude, either claude.ai (web or desktop) or Claude Code.
Connector address: https://api.corvidae.ai/reporting/mcp
Client ID (for sign-in): NSSv01pbmM1X6bmToojbyiLIfrDkNnUQ
Option 1: claude.ai (sign in with your Corvidae login)
Step 1: Your organisation adds the connector (once)
Only an owner or admin of your organisation's Claude account can add a custom connector. Other people in your organisation will not see the option. Everyone else skips to Step 2 once it has been added.
-
In claude.ai, go to Customize, then Connectors.
-
Select Add, then Add custom connector.
-
Name:
Corvidae AI -
URL:
https://api.corvidae.ai/reporting/mcp -
Open Advanced settings and enter the OAuth Client ID:
NSSv01pbmM1X6bmToojbyiLIfrDkNnUQ -
Leave the client secret empty.
-
Save.
Step 2: Each person connects (once)
-
Go to Customize, then Connectors.
-
Next to Corvidae AI, select Connect.
-
Sign in with your normal Corvidae login.
-
Back in claude.ai, start a chat and ask a question about your data.
[Screenshot: add the production screenshot of the Corvidae AI connector and its tool list here, then delete this line.]
You will see 17 read-only tools, such as "Find company", "Get channel performance" and "Get traffic". Claude chooses the right one for your question.
API keys cannot be used with claude.ai. Sign in with your Corvidae login.
Option 2: Claude Code (sign in, or use an API key)
A. Sign in with your Corvidae login
-
Add the connector:
claude mcp add --transport http corvidae https://api.corvidae.ai/reporting/mcp --client-id NSSv01pbmM1X6bmToojbyiLIfrDkNnUQ --callback-port 3118(Run
claude mcp add --helpif an option name differs in your version.) -
Start Claude Code and type
/mcp. -
Select corvidae, then Authenticate. A browser opens: sign in with your Corvidae login.
-
/mcpnow shows corvidae as connected.
If sign-in fails after an earlier attempt, remove the entry (claude mcp remove corvidae) and add it again under a new name, for example corvidae2.
B. Use an API key (no browser sign-in)
An API key is useful for scripts or shared machines.
-
Ask a Corvidae administrator in your organisation to create a key in Corvidae under Settings, API Key. The key is shown only once, so copy it straight away. Each company can have up to 2 active keys, and keys expire (6 months by default). See Creating an API Key.
-
Add the connector with the key:
claude mcp add --scope user --transport http corvidae-key https://api.corvidae.ai/reporting/mcp --header "X-API-Key: <your key>" -
Restart Claude Code and type
/mcp. corvidae-key should show as connected.
A message such as "Dynamic Client Registration rejected (HTTP 404)" when using a key is harmless. Ignore it.
Keep your key secret. Treat it like a password: do not paste it into chats, emails, tickets or shared documents. If it may have been exposed, revoke it in Settings, API Key and create a new one.
An API key only gives access to the companies it was created for.
What you can ask
-
"Find the company called ..." (Claude looks up the company first.)
-
"Show channel performance for the last 7 days."
-
"Which campaigns drove the most revenue last month?"
-
"Compare Corvidae and Google Analytics revenue by channel."
-
"What are the busiest hours and weekdays for conversions?"
Good to know
-
You only see companies you are authorised for. Ask your Corvidae contact if one is missing.
-
Inactive companies are hidden unless you ask for them.
-
If you give no dates, Claude uses the last 7 complete days, ending yesterday. Today's data is imported the next day.
-
Results show the company's currency (for example GBP, EUR or USD).
-
Raw transaction data is limited to 7 days at a time.
Troubleshooting
|
What you see |
What to do |
|---|---|
|
No "Add custom connector" option in claude.ai |
Only an owner or admin of your organisation can add it. Ask them. |
|
Sign-in page does not appear or fails |
Check you used the exact URL above, then try again. For Claude Code, re-add it under a new name. |
|
Connected, but a company is missing |
You are not authorised for it, or it is inactive. Ask your Corvidae contact. |
|
API key rejected |
The key may be revoked, expired or copied incompletely. Create a new key. |
Need help? Contact your Corvidae account manager.