Skip to content
CodeBook

Connect ChatGPT

Add CodeBook to ChatGPT as a custom MCP server, sign in with Bookbag, and see your factory board and stories as cards in the chat. Install the connector, review permissions and verify a story across clients.

ChatGPT connects to the same connector as Claude: https://app.codebook.work/mcp, signed in with your Bookbag account. In ChatGPT you can see your factory's board and follow your stories, drawn as cards in the chat. You can start a story, approve a waiting station or send work back for changes. CodeBook can run a story in the cloud. When a story is set to Run here, a local worker executes the station. You can follow it from ChatGPT.

Can your account add it?

OpenAI decides who can add a custom MCP server in ChatGPT. It depends on your plan, and in a Business, Enterprise or Edu workspace, your admin's settings and policies apply. Your administrator can tell you whether custom plugins are enabled and whether CodeBook is already available to install. OpenAI’s ChatGPT plugin guide

Sign in to app.codebook.work once before you start. A Bookbag account that has never opened CodeBook has no factories to show.

Add CodeBook

On ChatGPT on the web:

  1. Open Plugins (chatgpt.com/plugins), select +, then Add custom MCP server.
  2. Enter a name, CodeBook, and, if you like, a description.
  3. Under Connection, enter the server URL: https://app.codebook.work/mcp.
  4. For authentication, choose OAuth.
  5. Read ChatGPT's warning about custom servers, then select I understand and want to continue, then Create as a plugin.
  6. Sign in with your Bookbag account. Review the requested access. Read access lets ChatGPT inspect factories you can see. Run access lets it act on work you can operate. Creating agents or configuring stations requires the separate permission to manage factories. A personal grant applies to the factories your account can already manage.
  7. Open the resulting plugin in your personal plugins. Install it, then start a fresh conversation. Type @ and select CodeBook. OpenAI’s plugin quickstart

If the option to add a server is missing, check your current ChatGPT workspace and its plugin policy with your administrator. OpenAI documents the web setup and tool discovery in Connect and test your plugin.

Use it

Verify the connection with “@CodeBook which factories can I see?” Compare the names with your CodeBook account. Then mention @CodeBook in a message and ask. For example: "@CodeBook show me the board of the Payments factory", or "@CodeBook how is story #57 going?".

  • The board and a story are drawn as cards. The factory board shows its stations, a selection of their stories, and the ones waiting for you. Stories that have not entered a station are counted separately in the backlog. A story card shows each station as done, now or next.
  • Clicking a story's row on the board sends a message asking how that story is going, and ChatGPT answers with the story's card.
  • Start a story by saying what it should make and in which factory. The agent stations run in CodeBook, as they do for a story started on the website.
  • Approve or send back a station that waits for you by saying so in the chat. Ask what approving does first: a factory may merge the story's pull request when its station is approved.

Each connector action uses your CodeBook account permissions. Every move it makes is recorded on the card in your name, with the app you used.

Find a story that has not started

Open the factory board, pick the workflow, and choose View backlog. The backlog is the queue before the workflow. A station called Backlog is a separate place: a story at that station has already entered the workflow. Owned or proposed stories in the unplaced backlog may still need a decision before anyone starts them.

Use the page controls to see more, or select a story to read its brief. You can also ask “Show the first 15 unplaced backlog stories for Payments / Delivery” and then “Show the next page.” Opening a backlog or reading a proposal does not start work. If your interactive board has the button but the chat cannot request a page, ask the plugin owner to refresh its tools.

Verified in ChatGPT

In November 2026, an engineer signed in with Bookbag and exercised the installed CodeBook plugin in a private test factory. Opening a row on the factory board displayed the matching story. The engineer started work, approved one station decision and sent another back. A pull worker completed an assigned run and the story moved to Done.

If you can see the board but a newer action such as story history is missing, open ChatGPT Settings, select CodeBook, open Manage app, and choose Refresh tools. Start a fresh conversation, select @CodeBook, and ask for the story history again. Refreshing updates the available tool list. Bookbag still checks the permission required by each action.

During the signed-in test, ChatGPT blocked the stop action before it reached CodeBook. If the host declines an operation, inspect the story in the factory to see its current state.

Request repository proof from ChatGPT

  1. Open a story and ask “Which repository and proof recipe does this story use?” Check that the repository, revision and saved test command match the change you want to verify.
  2. Ask “Request proof for this story.” Confirm the request if prompted and note the proof number. An eligible repository and recipe must already be configured in Factory settings.
  3. For a proof assigned to your computer, open Claude Code in the registered checkout and enter /factory prove followed by that number. For example, /factory prove 12 claims proof 12 and runs its recipe. Set up local proof
  4. Return to the story in ChatGPT and ask “Which commit passed, how many tests passed or failed, and which acceptance criteria are still open?” Check the commit against the change under review. A reviewer can then sign off any remaining human criteria.

Which client to use

  • Work in your checkout. ChatGPT can follow the station and request proof. Install the native plugin to run the local commands. Connect Claude Code
  • Ask you by itself. ChatGPT doesn't watch your stories. Ask how a story is going, and the card shows the station that waits for you.
  • The Factory pane and /factory. These come with the Claude Code plugin.

Update or disconnect

Cloud connector tools are served by CodeBook. If an installed plugin still shows an older list, open Settings → Plugins → CodeBook → Manage app → Refresh tools, review any requested changes, then start a fresh conversation. On a managed workspace an administrator may need to refresh or approve the change. To remove a personally installed plugin, open it in the plugin browser and choose Uninstall plugin. Disconnect the Bookbag account separately if you want to end a connected MCP integration. A workspace-managed installation may require an administrator. Manage ChatGPT plugins

If something is off

  • Sign-in repeats or shows the wrong organization. Disconnect the Bookbag connection, reconnect using the intended account, and compare the result of “which factories can I see?” with the website.
  • There is no Factory pane or slash command. In ChatGPT, type @ and select the CodeBook plugin. Local station execution, the checkout guard, and local proof belong to Claude Code.

Next: what you can do from the chat.