The bird perches in Claude Code.
Connect Dr. Canary to Claude Code in two steps, in Claude Code’s own labels.
The path ends at the Dr. Canary sign-in, where you see what the connection can read and change before you approve it. Then ask your assistant to list your Dr. Canary sites.
Connect Claude Code
0 of 2 done
WhereIn your terminal
claude mcp add --transport http --scope user dr-canary https://www.drcanary.com/api/mcp/
What you approve at the Dr. Canary sign-in
The page is titled Connect Claude Code. Sign-in returns to an address on your own device. Start sign-in and finish it on the same device. It says the connection uses your full Dr. Canary account permissions, then lists what it can do.
- Read your account: the sites, saved shoppers, checks and reports you can already access.
- Manage secret shoppers: create or edit them, set their calendar, or retire them. Saving does not start a check.
- Request site checks: checks may submit test inquiries and use your current allowance.
Choose Allow connection to finish, or Deny to stop.
Ask your assistant
More examplesList my Dr. Canary sites.
list_sites
What did the last check find at my store?
list_siteslist_reportsget_report
If Claude Code loses the connection
Run
/mcpin Claude Code, select dr-canary, and authenticate again.Finish sign-in in the browser on the same device.
Reconnecting does not grant access your account does not have.
The connection
- Server URL
https://www.drcanary.com/api/mcp/ - Scopemcp
- TransportStreamable HTTP
- Sign-inOAuth 2.1 with PKCE, your Dr. Canary account
What it does not do
- Your account’s permissions apply. What you cannot do in the portal, your assistant cannot do either.
- Your assistant follows its app’s approval controls for changes and checks.
- It reads what the report shows. Hidden prompts, internal notes, and other accounts stay out.
Questions
Where do I add Dr. Canary in Claude Code?
In your terminal, with claude mcp add and the HTTP transport. Then run /mcp inside Claude Code to authenticate.
Which URL do I paste?
Paste https://www.drcanary.com/api/mcp/. It is the same server URL for every app.
It did not open the Dr. Canary sign-in.
Run /mcp, select dr-canary, and authenticate. Finish sign-in in the browser on the same device you run Claude Code on.
How do I disconnect Claude Code?
Claude Code’s /mcp holds the connection controls for dr-canary. Disconnecting does not delete what Claude Code already received.

Give your assistant something to read.
A checkup is one report. Monitoring keeps the bird shopping your site on a schedule, so there is a fresh report every time you ask.
