Connect CodeHerder to claude.ai or ChatGPT

CodeHerder can be added as a remote MCP connector to claude.ai and to chatgpt.com. Once connected, you can ask Claude or ChatGPT things like “what are my open CodeHerder tasks?” or “post a comment on task X” without leaving that app.

A connector is a live link from claude.ai/chatgpt.com to {{api_base}} — the same server your browser and the ch CLI already talk to. You sign in the same way you always do (your normal CodeHerder login); there is no separate password or account to create.

What you can do once connected

• List your CodeHerder tasks
• Read recent activity in a workspace or on a task
• Read a workspace wiki page
• Create a task
• Post a comment on a task
• Link one task as a dependency of another

See What Claude and ChatGPT can do with CodeHerder for what each of these actually reads or writes, what the connector cannot do, and what read-only vs read-and-write access means.

Connect claude.ai

1. In claude.ai, open Settings → Connectors.

2. Click Add custom connector.

3. Paste in this URL:

   {{api_base}}/v1/mcp

4. Claude prompts you to sign in — this is your normal CodeHerder login (via your identity provider’s sign-in page). The first time you connect, CodeHerder then shows an Allow access to your account? screen listing what the connector will be able to do. Click Allow to finish connecting, or Deny to stop — nothing is granted, and you can start over any time.

5. Once connected, start a chat and ask Claude to do something with CodeHerder — e.g. “list my open CodeHerder tasks.”

Connect ChatGPT

1. In chatgpt.com, open Settings → Connectors → Advanced, and turn on Developer mode. (Custom connectors are only available with developer mode on.)

2. Back in Connectors, click Add connector (or Create).

3. Paste in this URL:

   {{api_base}}/v1/mcp

4. ChatGPT prompts you to sign in — this is your normal CodeHerder login. The first time you connect, CodeHerder then shows an Allow access to your account? screen listing what the connector will be able to do. Click Allow to finish connecting, or Deny to stop — nothing is granted, and you can start over any time.

5. Once connected, ask ChatGPT to do something with CodeHerder — e.g. “read the latest activity in my CodeHerder workspace.”

See or disconnect what’s connected

Once you’ve connected a client, it shows up under Connected apps on your My work page — along with its access level and when you connected it. Click Revoke there to disconnect it. Revoking removes the approval and every credential CodeHerder issued for that connection, so the next time you connect that app, you’ll see the consent screen again.

What sign-in looks like

Both clients open your identity provider’s own sign-in page (the same page you’d see signing in to CodeHerder any other way) inside a popup or a new tab. After you sign in, CodeHerder shows an Allow access to your account? screen: it names the app you’re connecting, where it will redirect you, and a list headed This will let it: — for example “Read your tasks, comments, activity feed, and the workspace wiki” and “Create tasks and post comments on your behalf,” depending on what the app asked for. Click Allow to finish connecting and return to claude.ai/chatgpt.com, or Deny to stop — nothing is granted, and you can try again any time. You never type a CodeHerder password into Claude or ChatGPT itself.

This screen only appears the first time you connect a given app, or after you’ve revoked it. A later reconnect that doesn’t need any access beyond what you already approved skips straight through.

If something goes wrong

• The connector won’t add, or immediately shows an error. Double-check the URL is exactly {{api_base}}/v1/mcp (no trailing slash, no www.).
• Sign-in opens but then shows an error page instead of returning you to Claude/ChatGPT. This usually means the connector’s registration is stale — remove the connector and add it again from scratch, which re-registers it cleanly.
• The connector connects, but every request it makes fails or is refused. Try disconnecting and reconnecting once (see See or disconnect what’s connected above) — if it still fails, it’s likely a temporary server-side issue rather than something wrong with your setup. Contact your CodeHerder workspace admin.
• You’re asked to sign in every single time, rather than staying connected. This can happen if the connector’s credential expired — reconnecting refreshes it.

For the full list of what each capability does, what the connector cannot do, and what to do when something goes wrong, see What Claude and ChatGPT can do with CodeHerder.