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.
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.
| Tool | Type | What it does | Inputs | Returns |
|---|---|---|---|---|
list_members | Read | List active people in the company. | None | Array of members: userId, displayName, email, role. |
list_meetings | Read | List upcoming company calendar meetings (next 14 days, up to 50). | None | Array of meetings with title, times, room, organizer and attendees. |
list_channels | Read | List chat channels in the company. | None | Array of channels: id, name, createdAtUtc, archived. |
list_channel_messages | Read | Read recent root messages in a company channel. | channelId (uuid, required), take (integer 1 to 50, default 20) | messages (oldest first) and hasMore. |
post_channel_message | Write | Post 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.”
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
401withWWW-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 atPOST /oauth/register. - Authorization code flow with PKCE (
S256only). Access tokens last about an hour and are bound to the/mcpresource. Refresh tokens last about 30 days and rotate on every use. - Redirect URIs must use
https, orhttponlocalhost,127.0.0.1or::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:
Authorization: Bearer vo_pat_your_tokenCompany 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
403with{"error":"MCP is disabled for this company."}. - Tool allowlist. Each tool can be turned off per company. Disabled tools disappear from
tools/listand are rejected bytools/call. - Rate limit. 60 requests a minute per company by default. Over the limit,
/mcpreturns429with aRetry-Afterheader. - 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.
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
| Symptom | What to check |
|---|---|
401 Unauthorized | The 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. |
429 | Your company hit its per-minute limit. Wait for the Retry-After seconds and try again. |
| A tool is missing | An 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.