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

0 of 2 done

WhereSettings › MCP servers, or the terminal

Add the server from the terminal.
codex mcp add dr-canary --url https://www.drcanary.com/api/mcp/
Finish sign-in in your browser. To open sign-in again, run this command.
codex mcp login dr-canary
OrIn 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

Ask your assistant

More examples

List my Dr. Canary sites.
- list_sites
What did the last check find at my store?
- list_sites
- list_reports
- get_report

If Codex loses the connection

To open sign-in again, run this command.
codex mcp login dr-canary
To sign out of the server, run this command.
codex mcp logout dr-canary
Give Codex the chance to renew an expired sign-in first. Reconnect only when renewal cannot recover it.

The connection

Server URLhttps://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

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.

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.

Compare plans