# Codex hears it from the bird.

Connect Dr. Canary to Codex from the terminal, or from the Codex app, in Codex’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 Codex

Settings › MCP servers, or the terminal

1. Add the server from the terminal.

   ```
   codex mcp add dr-canary --url https://www.drcanary.com/api/mcp/
   ```

2. Finish sign-in in your browser. To open sign-in again, run this command.

   ```
   codex mcp login dr-canary
   ```

3. In the Codex app, Settings › MCP servers › Add server takes the same URL as Streamable HTTP, then Authenticate.

## What you approve at the Dr. Canary sign-in

The page is titled Connect Codex. 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 Codex loses the connection

1. To open sign-in again, run this command.

   ```
   codex mcp login dr-canary
   ```

2. To sign out of the server, run this command.

   ```
   codex mcp logout dr-canary
   ```

3. Give Codex the chance to renew an expired sign-in first. Reconnect only when renewal cannot recover it.

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

### Terminal or the Codex app?

Either. The terminal takes `codex mcp add`. In the Codex app, Settings › MCP servers › Add server takes the same URL as Streamable HTTP, then 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 `codex mcp login dr-canary` and finish sign-in in the browser on the same device.

### How do I disconnect Codex?

Run `codex mcp logout dr-canary`. Disconnecting does not delete what Codex 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)
- [Claude Code](https://www.drcanary.com/mcp/claude-code/) · [markdown](https://www.drcanary.com/mcp/claude-code.md)

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