# 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

In your terminal

1. Add Dr. Canary as an HTTP server.

   ```
   claude mcp add --transport http --scope user dr-canary https://www.drcanary.com/api/mcp/
   ```

2. In Claude Code, run /mcp, select dr-canary, and authenticate. Finish sign-in in the browser on the same device.

## 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.

- [What a connection can and cannot do](https://www.drcanary.com/mcp/permissions/)

## If Claude Code loses the connection

1. Run `/mcp` in Claude Code, select dr-canary, and authenticate again.
2. Finish sign-in in the browser on the same device.
3. Reconnecting does not grant access your account does not have.

## The connection

- · Server URL: `https://www.drcanary.com/api/mcp/`
- · Scope: mcp
- · Transport: Streamable HTTP
- · Sign-in: OAuth 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.

## Ask your assistant

- “List my Dr. Canary sites.” Uses `list_sites`.
- “What did the last check find at my store?” Uses `list_sites`, `list_reports`, `get_report`.

More examples: https://www.drcanary.com/mcp/examples/

## 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.

## Related

- [Connect](https://www.drcanary.com/mcp/) · [markdown](https://www.drcanary.com/mcp.md)
- [Permissions](https://www.drcanary.com/mcp/permissions/) · [markdown](https://www.drcanary.com/mcp/permissions.md)
- [Troubleshooting](https://www.drcanary.com/mcp/troubleshooting/) · [markdown](https://www.drcanary.com/mcp/troubleshooting.md)
- [ChatGPT](https://www.drcanary.com/mcp/chatgpt/) · [markdown](https://www.drcanary.com/mcp/chatgpt.md)
- [Claude](https://www.drcanary.com/mcp/claude/) · [markdown](https://www.drcanary.com/mcp/claude.md)
- [Codex](https://www.drcanary.com/mcp/codex/) · [markdown](https://www.drcanary.com/mcp/codex.md)

https://www.drcanary.com/mcp/claude-code/ · updated 2026-11-11