Skip to content

Building agents from ChatGPT and Codex

You can build and improve Donkit agents from ChatGPT or Codex instead of the Builder chat. ChatGPT or Codex does the thinking and writing on your own OpenAI plan; the agent itself lives and runs on Donkit, exactly like an agent made in the Builder.

What you need

  • A Donkit account. If you don't have one yet, you can create it on the sign-in page when you first connect.
  • ChatGPT on the web, or Codex (the app, the terminal or the IDE extension).

Connect from ChatGPT

  1. In ChatGPT on the web, open Plugins, find Donkit and add it.
  2. When ChatGPT asks you to sign in, a Donkit page opens and asks you to allow access. Check the workspace name, then allow. New agents ChatGPT creates go to that workspace.
  3. Start a chat, type @ in the prompt box, select Donkit and ask for an agent.

ChatGPT uses Donkit for the message where you select it. When a follow-up needs Donkit again, type @ and select Donkit again. ChatGPT may ask you to confirm before an action that changes an agent.

If Donkit isn't under Plugins

A ChatGPT Business or Enterprise workspace can add Donkit as a custom MCP server. On Business, only workspace admins and owners can do this; on Enterprise, also the members an admin allowed. Other ChatGPT plans can't add a custom server that changes data: use Codex there.

  1. In ChatGPT on the web, open Plugins, select +, then Add custom MCP server.
  2. Enter Donkit as the name and, under Connection, https://app.donkit.ai/api/mcp-server/mcp as the server URL.
  3. For authentication, choose OAuth and leave the client ID and secret empty: ChatGPT registers itself with Donkit.
  4. Read the risk warning, select I understand and want to continue, then Create as a plugin.
  5. Sign in to Donkit and allow access when asked, as above. A workspace admin can then publish the plugin for the rest of the workspace.

Connect from Codex

In the Codex app:

  1. Open Settings, then MCP servers, and select Add server.
  2. Enter Donkit as the name, choose Streamable HTTP and enter https://app.donkit.ai/api/mcp-server/mcp as the URL.
  3. Save, then select Restart.
  4. Select Authenticate. A browser page opens and asks you to allow access. Check the workspace name, then allow. New agents Codex creates go to that workspace.

In a terminal:

  1. Run codex mcp add donkit --url https://app.donkit.ai/api/mcp-server/mcp.
  2. Run codex mcp login donkit. A browser page opens and asks you to allow access. Check the workspace name, then allow.

In the IDE extension, open the gear menu, then MCP servers, and follow the steps for the app; after saving, select Restart extension. The app, the terminal and the IDE extension share one setup, so you connect Donkit once.

Your connections

Each connection is listed in Donkit under Devices → Apps, under the name of the app that connected. Open it there to see what is connected, and remove a connection to cut off access at once.

Example requests

  • "Build a Donkit agent that answers customer questions from our FAQ at https://example.com/faq, then publish it."
  • "Make a Donkit agent where my team logs expenses and sees a monthly total by category."
  • "Open my Donkit agent Lead qualifier, add a company size field to the form, and run the checks."
  • "List my Donkit agents and tell me which ones aren't published yet."

Donkit asks ChatGPT and Codex to read its build guides before they start. If one skips them, ask it to read the Donkit build guides first.

What it can do and see

ChatGPT and Codex get the same tools, access and limits as Claude, so these parts of Building agents from Claude apply as written: what it can and cannot do, what it can see, the preview, checkpoints, checks and publishing and limits. In short:

  • It edits agents you are allowed to build, and creates new ones in the workspace you approved.
  • It works as you: it sees your own records and the agent's shared data, never other people's records.
  • It publishes only after every check passes.

Credits

Building from ChatGPT or Codex does not use Donkit credits for the assistant's own work, because that runs on your OpenAI plan. Test runs of the agent during the build use credits like any other run of the agent.

Troubleshooting

  • Donkit isn't under Plugins. Add it as a custom MCP server (see If Donkit isn't under Plugins), or connect from Codex.
  • Sign-in expired. In ChatGPT, connect Donkit again from Plugins. In Codex, run codex mcp login donkit, or select Authenticate again under MCP servers.
  • "Someone else is editing this agent." Another person (or the Builder) is working on it right now. Wait until they finish, then try again.
  • A rate-limit message. You made too many calls in a short time, or created too many agents today. The message says which limit and when it resets.
  • The connection is missing under Devices → Apps. It was removed. Connect again as described above.

Get help

Email [email protected] from the address of your Donkit account. Name the agent, say what you asked ChatGPT or Codex to do, and what happened instead.

To build without an assistant, see The Builder.