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 https://api.codeherder.com — 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 memory entry
• Create a task
• Post a comment on a task

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:

   https://api.codeherder.com/v1/mcp

4. Claude will prompt you to sign in — this is your normal CodeHerder login (via your identity provider’s sign-in page). There’s no separate step: signing in here connects the tool AND authenticates you in one flow.

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:

   https://api.codeherder.com/v1/mcp

4. ChatGPT will prompt you to sign in — this is your normal CodeHerder login. There’s no separate step.

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

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, you’re returned straight back to claude.ai/chatgpt.com, already connected — you never type a CodeHerder password into Claude or ChatGPT itself.

If something goes wrong

• The connector won’t add, or immediately shows an error. Double-check the URL is exactly https://api.codeherder.com/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 — 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.