Agent door

Connect Claude

Add Yellowhead as a custom connector in Claude. Claude asks you to sign in the first time a request needs your account, and can then read your Diagnostics and reports, and start a new Diagnostic when you ask.

Claude connects to your account through the agent door, a Model Context Protocol (MCP) server at https://api.yellowhead.digital/mcp. You add it to Claude yourself as a custom connector, and you sign in with your Yellowhead Digital account the first time Claude needs it. It works on every Yellowhead plan, Free included. These steps are for Claude on the web at claude.ai.

Before you start

You need a Yellowhead Digital account for anything that reads your data. Adding the connector does not ask you to sign in; Claude asks the first time a request needs your account.
Your Claude plan has to allow custom connectors. Anthropic decides which plans do, and how many custom connectors each allows; its help page on custom connectors says which.
On a Claude Team or Enterprise plan, an owner of your Claude organization adds the connector first, and then each person connects to it themselves. Anthropic's help page has the steps.

Add the connector

In Claude, open Settings › Connectors. Anthropic's help page currently calls this Customize › Connectors.
Choose Add custom connector.
Name it Yellowhead. Any name works: it is the name you see in Claude's connector list and the one you use in a chat.
Enter the URL https://api.yellowhead.digital/mcp.
Leave the OAuth Client ID blank, and leave any client secret blank too. Yellowhead does not ask you for a client ID or secret; Claude identifies itself when it connects.
Confirm to add it. You are not asked to sign in at this step: Claude adds the connector and can see its tools straight away.

Before you sign in, the connector answers one thing: what Yellowhead is, its plans and prices, and a link to start a Diagnostic. Everything that reads your account waits for you to sign in.

Switch it on in a chat

Start a chat and open the tools menu (the + button at the lower left, then Connectors). Switch Yellowhead on. Connectors are switched on per conversation, so check the switch when a new chat does not use it.

The first time you ask for something that needs your account, such as "Using Yellowhead, list my Diagnostics", Claude shows its own sign-in card in the chat. Claude changes the card's labels from time to time, so take these as examples: it may first offer Connect, which for Yellowhead completes without a sign-in, and then Use. When the request needs your account, the card says something like "Authorization required", with a Reconnect or Connect button. It can say Reconnect even the first time you sign in.

That button opens app.yellowhead.digital/oauth/authorize, Yellowhead Digital's consent page. If you are not signed in, sign in there first. The page then shows:

Who is asking. The heading names the app and, under it, the verified web address that sent the request. If the app registered itself automatically, the page says so and that it cannot verify who made it.
Where you go back to once you decide.
Which account it can read. Your Personal account and any Team accounts you belong to. Pick one. An account that cannot be connected is greyed out, with the reason.
What it will be able to do in the account you picked. The list follows that account's Yellowhead plan, so it can change when you pick a different account. You see it before you approve.
A note that what it reads is sent to the app and kept under the app's own policies.

Choose Allow to connect, or Deny. Either way you go back to Claude.

Claude does not retry your request on its own after you sign in. Ask again, for example "Using Yellowhead, list my Diagnostics", and it works.

What the list can include

On the consent page	Which accounts
Read the Diagnostics and reports in this account	Every plan
Read its action items	Pro, Enterprise, any Agency plan (Consultant, Studio or Firm) and custom plans
See this account's plan usage	Every plan
Read published Strategic Assessments	Every plan
Start a Diagnostic using one of your account's included monthly Diagnostics	Every plan. On a plan with workspaces, the line adds that it can file the run in one of your workspaces. On an Agency plan (Consultant, Studio or Firm) or a custom plan, it adds that it can also create a new prospect or client workspace for the business when you ask for one.
See the Portfolio: your client workspaces and how their scores moved	Team accounts on an Agency plan, Business Enterprise or a custom plan
Read published Infrastructure Audits	Every plan
Read its Citation, Crawlability and Accessibility Scans	Every plan

A connection can do only what you can do in the account it is connected to. Creating a prospect or client workspace needs you to be an owner or admin of the team account. A connection made by signing in holds no action-item write capability: it cannot change, comment on or close an action item. You make those changes in the Yellowhead Digital app. See Capabilities for the detail.

Ask by name

Claude can answer from its own knowledge instead of calling a connector. Name Yellowhead in your question so it uses your account, for example "Using Yellowhead, what Diagnostic reports do I have?". If you gave the connector another name, use that name.

Starting a Diagnostic

When you ask Claude to start a Diagnostic, the first step is a preview, and it starts nothing: the website, the business name, the self-ratings, what the run will be recorded as and where it will be filed, and which of your included monthly Diagnostics it uses. The run starts only when Claude confirms that preview, and any change needs a new preview. Claude may confirm without asking you again, so if you want to approve each run, ask it to show you the preview and wait for your go-ahead. A Diagnostic uses only your account's included monthly Diagnostics. When none are left, nothing is charged, and Claude is told the reset date. One person can also start only so many from an assistant in a day.

You can say what the Diagnostic is for, with the same choices as the app: your own business, a client, a competitor or research, and, on an Agency plan, a prospect (an owner or admin of the team account can have a new prospect created for it). A competitor or research run of a website none of your workspaces holds is filed in no workspace, and no workspace is created for it. A website one of your client or brand workspaces already holds is filed in that workspace, as it is in the app.

A Diagnostic takes 5 to 10 minutes, and you also get an email when it completes. Ask "Using Yellowhead, is my Diagnostic ready yet?" to check on it.

Manage or remove the connection

Your own connections. In the Yellowhead Digital app, open Settings › AI assistants (app.yellowhead.digital/dashboard/settings/ai-assistants). It lists each assistant you have connected, the account it is connected to, and what it can do. Remove cuts off its access within about a minute. To use it again, connect it again from Claude.
Owners and admins of a team account see everyone's connections to that account under Access › AI assistants, and can remove any of them. The setting Members may connect AI assistants is on by default. Turning it off ends members' current connections and stops new ones. Owners and admins keep theirs.

Troubleshooting

Claude asks you to reconnect, or does nothing after you sign in: Claude's sign-in card can say "Reconnect" the first time you sign in; use it to sign in. After you approve on the consent page, Claude does not retry the request by itself, so ask your question again. See Sign in and approve the connection.
Claude answers from memory instead of from Yellowhead: Check that the connector is switched on for this chat, then name it in your question ("Using Yellowhead, …"). See Ask by name.
A "not in plan" refusal: Your Yellowhead plan does not include that feature, so nothing was read. Reading action items needs Pro or above, for example. The plans page says which plan includes what.
"This connection was set up before that was available to this account": The account gained the feature, or Yellowhead switched it on, after you connected, for example after an upgrade. Reading Citation, Crawlability and Accessibility Scans is one such feature: a connection made before Yellowhead added scan reads on 2026-11-06 gets this message for them. Remove the connector in Claude's connector settings and add it again; the new connection gets what the account can do now.
"A connection made by signing in from an assistant cannot do that on any plan": The request needs access a sign-in connection never has, such as changing an action item. Do it in the Yellowhead Digital app instead.
"The sign-in for this connection has expired or was revoked": The connection was removed, or went unused for 30 days, or, for a member of a team account, ended when an owner or admin turned off Members may connect AI assistants. Connect it again from Claude. While that setting is off, a member needs an owner or admin to turn it back on first.
An account is greyed out on the consent page: The reason is shown next to it: the team account is paused, you have client access there (which cannot be connected to an AI assistant yet), or its owners and admins have turned off AI assistants for members.
"You already have 10 AI connections to this account": One person can have up to 10 connections to an account. Remove one you no longer use at Settings › AI assistants, then try again. A connection that goes unused for 30 days also frees its place on its own.
You cannot find Add custom connector: Your Claude plan may limit how many custom connectors you can have, so you may need to remove another one first. On a Claude Team or Enterprise plan, an owner of your Claude organization adds the connector, and you then connect to it.