Use zaDojo with ChatGPT

The custom zaDojo connection in this guide works on ChatGPT Free and paid plans. You do not need to upgrade. On Business, Enterprise, and Edu, workspace permissions can limit access.

Connect zaDojo before asking ChatGPT to do SEO research. If you paste the setup prompt into a regular ChatGPT chat, it will walk you through the steps below; ChatGPT cannot add the connection by itself.

Choose your setup path

Where you want to work	How to connect
ChatGPT on the web	Add zaDojo as a custom MCP connection using the steps below
Codex in the ChatGPT desktop app	Open Codex and paste the agent setup prompt

zaDojo billing is separate from your ChatGPT subscription. See OpenAI's plan support for Codex access.

ChatGPT on the web

Sign in to chatgpt.com.
If your version shows it, open Settings → Security and login and enable Developer mode. Some versions expose the custom connection flow directly in Plugins.
Open Plugins, select +, then Create MCP App. In versions with the older interface, look for Settings → Apps → Advanced settings → Developer mode, then Create or Add custom app.
Enter these details:

Field Value
Name zaDojo
Server URL https://app.zadojo.com/mcp
Authentication OAuth

Type the full URL, including https://.
Review the custom connection notice and create the connection. Sign in to zaDojo in the window that opens and approve the connection. Return to ChatGPT. If the new plugin needs installation, open it under Personal and select Install or +.
Start a new chat. Open the + / tools menu and select zaDojo. In versions that show Developer mode in that menu, choose it and enable zaDojo there. If the composer offers plugin mentions, you can also type @ and select zaDojo.
Send the connection-check request below.

Field	Value
Name	`zaDojo`
Server URL	`https://app.zadojo.com/mcp`
Authentication	`OAuth`

Use OAuth for this flow. You do not need to create a zaDojo API key or paste one into ChatGPT. A custom MCP connection gives ChatGPT zaDojo tools; it does not install the SEO skill files from the repository. You can still ask for keyword research, audits, or competitor research in plain language.

See OpenAI's connection guide for its current interface.

ChatGPT desktop

If you already use Codex in the desktop app, start a new Codex chat, then copy the agent setup prompt into that chat. Codex can configure its own connection and guide you through sign-in. Approve the zaDojo login when prompted.

If you prefer manual setup, follow the Codex plugin guide, or add the MCP connection alone. Start a new Codex chat after installation if needed, then run the connection check below.

For a regular ChatGPT chat in the desktop app, check Plugins. If zaDojo is listed for your account, install it, sign in, start a new chat, and select zaDojo. If it isn't available, follow the web setup steps above.

Codex and ChatGPT web use separate connections. Run the connection check in the chat where you want to use zaDojo.

For the current mode controls, see OpenAI's desktop guide.

Check that zaDojo is connected

Send this in a new chat with zaDojo selected:

Use zaDojo to check my connection and list my projects. Do not run SEO research or create anything.

ChatGPT should call zaDojo and return your connection status and project list. An empty project list is a successful connection check too. These reads use no zaDojo credits.

If it says it cannot access zaDojo, or only describes how to connect, setup is still incomplete. Check that zaDojo is installed, signed in, and selected in this chat. Start a new chat after changing the connection.

Once the check succeeds, try:

Use zaDojo to help me choose one SEO task for my website. Ask about my goal before starting paid research.

Directory plugins may also include SEO Coach and other skills. Use the available skill picker or ask for a workflow by name. A custom MCP connection can use the tools without those skills.

Troubleshooting

What you see	What to do
No Developer mode or Create MCP App option	Check Settings → Security and login and Settings → Plugins → Developer mode. On a workspace plan, ask your admin whether custom connections are allowed.
"Error fetching OAuth configuration: Unsafe URL"	Enter the server URL in full as `https://app.zadojo.com/mcp`, with no spaces. A URL without `https://` is rejected.
No zaDojo listing	A GitHub marketplace plugin is not automatically a public ChatGPT listing. Use the custom web connection or the Codex repository plugin steps.
ChatGPT asks for a client ID or secret	Keep OAuth selected and wait for discovery. Open Advanced OAuth settings and use Dynamic Client Registration (DCR) if offered. You should not need to supply your own client credentials for hosted zaDojo.
The login window never appears	Allow the sign-in window to open, then retry authentication from the zaDojo connection's details.
Login succeeds but tools are unavailable	Finish installing the personal plugin if prompted, start a new chat, and select zaDojo from the tools menu.
ChatGPT gives general advice instead of calling zaDojo	Select zaDojo and resend the connection-check request. Check that ChatGPT calls a zaDojo tool.
Codex works, but chatgpt.com cannot find zaDojo	Connect ChatGPT web separately. It does not read your desktop Codex configuration.
You have no projects	An empty project list still confirms the connection. Create a project in zaDojo when you are ready to start research.

If setup still fails, contact hello@zadojo.com with your ChatGPT plan, web or desktop version, the step that failed, and the error message. Do not include passwords, API keys, or sign-in codes.

Update zaDojo

For a public directory plugin, start a new chat to load the tools and skills available in ChatGPT. Reconnect if ChatGPT reports that sign-in needs attention. Local Codex update commands do not update ChatGPT web.

For a custom MCP connection, open its details under Plugins, select Refresh to reload the tools, and start a new chat. Refresh updates tool definitions; it does not add repository skills. If sign-in has expired, authenticate again.

For Codex, use the agent update prompt or plugin commands in your Codex environment.