# Connect CodeHerder to claude.ai or ChatGPT

Source: https://codeherder.com/docs/connect-to-claude-or-chatgpt/

Connect CodeHerder to claude.ai or ChatGPT to manage tasks from either app.

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](https://codeherder.com/docs/mcp-tools/) 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](https://codeherder.com/docs/my-work/#connected-apps) 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](https://codeherder.com/docs/connect-to-claude-or-chatgpt/#see-or-disconnect-whats-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](https://codeherder.com/docs/mcp-tools/).