CodeHerderSearch⌘KRequest access →

Connect CodeHerder to claude.ai or ChatGPT

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

CodeHerder can be added as a remote MCP server 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 connected app 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 workspaces, or check that you can access one
  • List the tasks in a workspace, and read one task in full
  • See a task’s sub-tasks, agent questions, blockers, and comments
  • Read recent activity for you, a workspace, or a task
  • List and read pages in the workspace wiki
  • Search everything you can see
  • Read the CodeHerder guides
  • 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 app cannot do, and what read-only vs read-and-write access means.

Connect claude.ai

On a Team or Enterprise plan, only an owner (or a role with the right permission) can add CodeHerder to the workspace. Other members then click Connect on it.

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

  2. Click + Add, then Add custom connector.

  3. Enter a name, and paste in this URL:

    https://api.codeherder.com/v1/mcp
  4. Click Continue, and review the sign-in settings Claude shows. If Claude asks for an OAuth client, choose Register automatically. The other options don’t work with CodeHerder.

  5. Click Add, then Connect. Claude prompts you to sign in with your normal CodeHerder login (via your identity provider’s sign-in page). CodeHerder then shows an Allow access to your account? screen listing what the app can do. Click Allow to finish, or Deny to stop. Nothing is granted if you deny, and you can start over any time.

  6. Start a chat and ask Claude to do something with CodeHerder, such as “list my open CodeHerder tasks.”

Connect ChatGPT

Use ChatGPT on the web. Your ChatGPT workspace’s permissions decide whether you can add a custom MCP server.

  1. In chatgpt.com, open the Plugins page.

  2. Click the plus button, then Add custom MCP server.

  3. Enter a name and, if you like, a description. Under Connection, paste in this URL:

    https://api.codeherder.com/v1/mcp
  4. Set authentication to OAuth.

  5. Read the risk warning, and click I understand and want to continue.

  6. Click Create as a plugin, then review the tools ChatGPT found.

  7. Find the new plugin in your plugins, and install it. ChatGPT prompts you to sign in with your normal CodeHerder login. CodeHerder then shows the Allow access to your account? screen. Click Allow to finish, or Deny to stop.

  8. Ask ChatGPT to do something with CodeHerder, such as “read the latest activity in my CodeHerder workspace.”

claude.ai and ChatGPT rename these menus from time to time. If a label differs, check their own help page for the current path.

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. To disconnect it, open the row’s More menu, choose Revoke, and confirm. 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, after you’ve revoked it, or after you remove and re-add the app. A later reconnect that doesn’t need any access beyond what you already approved skips straight through.

If something goes wrong

  • The app won’t add, or immediately shows an error. Check the URL is exactly https://api.codeherder.com/v1/mcp (no trailing slash, no www.). In Claude, also check the OAuth client is Register automatically.
  • Sign-in opens but then shows an error page instead of returning you to Claude or ChatGPT. The app’s registration is probably stale. Remove the app and add it again.
  • Sign-in is refused with “sso_sign_in_required”. Your account turns on SSO-only sign-in, so signing in with email or Google doesn’t work here. Sign in through your company SSO instead. If you’re not sure how, ask your CodeHerder administrator. See SSO-only sign-in.
  • Requests fail with “SSO required” after you connect. Your account requires a recent SSO sign-in. The error includes a sign-in link. See When your account requires SSO.
  • You’re asked to sign in every single time. The app’s credential probably expired. Revoke it (see See or disconnect what’s connected) and connect again.

For requests that fail after you connect, see What Claude and ChatGPT can do with CodeHerder.

Last updated

Try it on one repository for two weeks.

File a task. An agent builds it. A person reads every request. You see the cost of each task.

Try "pricing", "connect a device", or "who reviews the code"

↑↓ move · ↵ open · esc close