Collabute
Try for free
DocumentationAPI Reference

Connect coding agents to Collabute MCP

Connect your coding agent to Collabute when you want it to use your team's meetings, connected work, conversations, and deployment context.

Warning

Collabute opens a browser so you can sign in and approve access. Do not add personal access tokens or manual authorization headers.

Supported agents

Before you connect

  • You need an active Collabute account and organization.
  • You need access to the integrations you want your agent to use.
  • Connect those integrations first in Settings > Integrations.

MCP URL for every agent:

https://api.collabute.ai/api/mcp

Set up your agent

Claude Code

Add Collabute:

claude mcp add --transport http collabute https://api.collabute.ai/api/mcp

Start Claude Code, run /mcp, and approve access in your browser.

Check the connection:

claude mcp list

Codex

Add Collabute:

codex mcp add collabute --url https://api.collabute.ai/api/mcp

Open Codex MCP management and approve access in your browser when prompted.

Check the connection:

codex mcp list

Hermes Agent

Add Collabute to ~/.hermes/config.yaml:

mcp_servers:
  collabute:
    url: https://api.collabute.ai/api/mcp
    auth: oauth

In a Hermes session, run /reload-mcp and approve access in your browser when prompted.

Check the connection:

hermes mcp test collabute

Cursor

Open Cursor MCP settings and add a remote server:

  • Name: collabute
  • URL: https://api.collabute.ai/api/mcp

Open a Cursor chat and approve access in your browser.

OpenCode

Start setup:

opencode mcp add

Choose a remote HTTP server named collabute, enter https://api.collabute.ai/api/mcp, and select OAuth when prompted.

Approve access in your browser, then check the connection:

opencode mcp list

OpenClaw

Add Collabute:

mcporter config add --transport http collabute https://api.collabute.ai/api/mcp

Sign in and approve access:

mcporter config login collabute

Check the connection:

mcporter list collabute --schema

Amp

Add Collabute:

amp mcp add collabute https://api.collabute.ai/api/mcp

Approve access in your browser when prompted.

Check the connection:

amp mcp list

Use it

Once connected, ask questions that need team context, for example:

  • What decisions and action items came from my most recent meeting?
  • What changed in our Linear work this week?
  • Summarize the latest discussion about the onboarding rollout.
  • Show the latest production deployment for project X.

If the response includes the expected organization context, you are connected. Keep ordinary coding questions in your agent without MCP.

Troubleshooting

I cannot sign in

  • Start the connection again and complete browser approval in the same session.
  • Confirm that you are signing in to the correct Collabute organization.
  • Ask an admin if your role is allowed to use the relevant integration.

The agent cannot connect

  • Configure Collabute as a remote HTTP server, not a local command or legacy server.
  • Update your agent if it does not support modern remote MCP connections.

The agent has no useful context

  • Check that the relevant integration is connected in Settings > Integrations.
  • Confirm that the connected account can access the project, team, or channel you asked about.
  • Add a project, team, channel, or time period to your question.

Tips

  • Connect one Collabute account per person.
  • Remove the MCP connection when you no longer need access.

For org-level permission issues, use Troubleshooting. For the public API, see Developer resources.