MCP server

Let Claude, ChatGPT, Cursor, VS Code and other AI assistants work with your office: look up people and meetings, catch up on channels and post updates.

Server URLhttps://collabiro.com/mcp
TransportStreamable HTTP (remote MCP server)
AuthOAuth 2.1 sign-in, personal access token, or company API key

The Model Context Protocol (MCP) is an open standard that lets AI assistants call tools in other apps. Collabiro runs a hosted MCP server, so an assistant can look up who is in your company, check upcoming meetings, read a channel and post an update for you. Nothing to install: add the URL to your AI tool and sign in.

Connect your AI tool

Pick your client for step-by-step setup with copy-ready config:

Tools

Five tools are available. Every tool is scoped to one company, and nothing destructive is exposed: no deletes, edits, role changes or direct messages.

ToolTypeWhat it doesInputsReturns
list_membersReadList active people in the company.NoneArray of members: userId, displayName, email, role.
list_meetingsReadList upcoming company calendar meetings (next 14 days, up to 50).NoneArray of meetings with title, times, room, organizer and attendees.
list_channelsReadList chat channels in the company.NoneArray of channels: id, name, createdAtUtc, archived.
list_channel_messagesReadRead recent root messages in a company channel.channelId (uuid, required), take (integer 1 to 50, default 20)messages (oldest first) and hasMore.
post_channel_messageWritePost a message to a company channel as the signed-in member or key owner. Not for DMs or deletes.channelId (uuid, required), content (string, required)The created message.

Things you can ask once connected:

  • “Who is in our Collabiro company, and who are the admins?”
  • “What meetings do we have tomorrow, and which room is each one in?”
  • “Summarize the last 30 messages in #design.”
  • “Post in #general that the release moved to Thursday.”
Tip. post_channel_message is the only write tool. Most AI clients ask before calling it. An admin can turn it off for the whole company, which leaves the assistant read-only.

Authentication

The server accepts three kinds of credential. Use OAuth when your client supports it.

1. OAuth sign-in (recommended)

Add https://collabiro.com/mcp to your client and it will open a Collabiro sign-in page. The Connect to Collabiro screen shows the app's name, where it will send you back, your company and the tools it will be able to use, with post_channel_message marked as a write tool. Choose Allow and you are done.

  • Clients discover everything themselves: an unauthenticated request gets 401 with WWW-Authenticate: Bearer resource_metadata="https://collabiro.com/.well-known/oauth-protected-resource/mcp".
  • Authorization server metadata is at https://collabiro.com/.well-known/oauth-authorization-server. Dynamic client registration is at POST /oauth/register.
  • Authorization code flow with PKCE (S256 only). Access tokens last about an hour and are bound to the /mcp resource. Refresh tokens last about 30 days and rotate on every use.
  • Redirect URIs must use https, or http on localhost, 127.0.0.1 or ::1.

2. Your own OAuth client

Some clients ask for a client ID and secret instead of registering themselves. In Collabiro, open Settings → AI tools / MCP, pick your tool, check the redirect URI and create a client. The secret is shown once. The token endpoint accepts it with HTTP Basic or client_secret_post.

3. Personal access token

For clients that take a request header, create a token in Settings → AI tools / MCP. Tokens look like vo_pat_…, last 30, 90 or 365 days, act as you, and can be revoked any time. Send it as:

HTTP
Authorization: Bearer vo_pat_your_token

Company API key

A company API key also works on /mcp, in X-Api-Key or Authorization: Bearer. It acts as the admin who created it, so prefer OAuth or a personal token for people, and keep keys for shared bots.

Admin controls

  • On or off. MCP can be switched off for a company. Calls then return 403 with {"error":"MCP is disabled for this company."}.
  • Tool allowlist. Each tool can be turned off per company. Disabled tools disappear from tools/list and are rejected by tools/call.
  • Rate limit. 60 requests a minute per company by default. Over the limit, /mcp returns 429 with a Retry-After header.
  • Personal credentials. Admins can stop members creating their own OAuth clients and personal tokens.
  • Audit. Recent calls are recorded with time, company, credential prefix, tool and status. Arguments and secrets are not stored.
  • Revoke. Members see every connection in Settings → AI tools / MCP → Saved connections and can revoke a token, client or grant there.

Test the server by hand

To check a token without an AI client, send an MCP initialize request. A 200 with server info means the token works, and 401 means it does not.

Shell
curl -i https://collabiro.com/mcp \
  -H "Authorization: Bearer $COLLABIRO_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Troubleshooting

SymptomWhat to check
401 UnauthorizedThe token expired or was revoked, or the header is missing Bearer . Sign in again or create a new token.
403 “This API key cannot use MCP.”The company key does not include the mcp scope. Use a key with public,mcp, or a personal token.
403 “MCP is disabled…”An admin turned MCP off for your company. Ask them to turn it on.
429Your company hit its per-minute limit. Wait for the Retry-After seconds and try again.
A tool is missingAn admin disabled it for your company, so it is hidden from tools/list.
“Conversation not found.”The channel id is wrong, belongs to another company, or is a DM or private group. Ask the assistant to call list_channels first.

Questions

What is the Collabiro MCP server URL?

https://collabiro.com/mcp. It is a remote MCP server using the Streamable HTTP transport, with OAuth 2.1 sign-in.

Which AI tools work with Collabiro?

Any client that supports remote MCP servers, including Claude (web, Desktop and mobile), Claude Code, ChatGPT, Cursor, VS Code with GitHub Copilot and Perplexity.

Can the assistant post messages without asking?

post_channel_message is the only write tool. Most clients ask for approval before a write tool runs, and admins can disable it for the company.

Can the assistant see direct messages?

No. Only company channels are exposed. Direct messages and private groups are never returned.

Last updated 20 November 2026. Something missing or wrong? Tell us.