Connecting your AI assistant to Chainels
Connect Claude, Microsoft Copilot, or ChatGPT to your Chainels community with the Chainels MCP server.
You can connect AI assistants such as Claude, Microsoft Copilot, and ChatGPT to your Chainels community using the Chainels MCP server. Once connected, your assistant can read and act on your Chainels data — messages, events, bookings, and services — on your behalf.
Note: The Chainels MCP server is currently in beta. The available tools and their behaviour may change. Need help? Contact Chainels support.
The assistant acts on your behalf. When connected, it uses your Chainels account and permissions: it can read what you can read and post what you can post. Always review any message, event, or booking before you confirm it.
What can you do with it?You can ask your assistant to work with your community data in plain language. For example: "Summarize this week's messages in my community and draft a reply to the most urgent one."
Your assistant can help with:
-
- Messages & timeline — read, draft, post, and edit messages
- Events & questions — create and manage them
- Bookings — browse bookable services and time slots, and view reservations
- Context — look up your user, communities, and channels
All assistants connect to the same server URL: https://mcp.chainels.com/mcp
-
- Claude — no preparation needed. Claude registers itself automatically; you only sign in to Chainels.
- Microsoft Copilot and ChatGPT — you first need to create an OAuth client in the Chainels developer portal to get a Client ID and Client Secret.
Creating your OAuth client (Copilot and ChatGPT only)
-
- Go to www.chainels.com/developer
- Create a new OAuth client of type Authorization Code
- Leave the redirect URI blank for now — you'll add your client's callback URL once it is shown during setup
- Note your Client ID and Client Secret
Some clients also ask for these OAuth endpoints:
-
- Authorization:
https://www.chainels.com/oauth/authorize - Token:
https://www.chainels.com/oauth/access_token - JWKS:
https://www.chainels.com/oauth/jwks.json
- Authorization:
Note: For now you have to accept all scopes when authorizing. This may be narrowed down to per-use-case scopes in a later release.
Connecting Claude-
- Open Claude and go to Settings → Connectors
- Click Add custom connector
- In Remote MCP server URL, paste
https://mcp.chainels.com/mcp - Click Add
- A popup opens — sign in to Chainels with your account
- Approve the requested access (accept all scopes)
- The connector now shows as connected. Open a chat and ask "Who am I?" to confirm
You don't need to change anything under Advanced settings — Claude doesn't require a Client ID or Secret for Chainels.
Connecting Microsoft Copilot (Copilot Studio)This connects a Microsoft 365 Copilot agent built in Copilot Studio to the Chainels MCP server. Make sure you have created your Client ID and Client Secret first (see Before you start).
-
- Go to copilotstudio.microsoft.com and open (or create) your agent
- In the left sidebar, click Tools
- Click + Add a tool → New tool, then choose Model Context Protocol (MCP)
- Enter the server details: a name (e.g. Chainels MCP), the server URL
https://mcp.chainels.com/mcp, and authentication type OAuth 2.0 - Copilot Studio shows three OAuth 2.0 options. Choose "Manual" — Chainels does not support automatic client registration, so Dynamic discovery and Dynamic will fail
- Fill in the Manual fields: your Client ID and Client Secret, Authorization URL
https://www.chainels.com/oauth/authorize, Token URL and Refresh URLhttps://www.chainels.com/oauth/access_token, and accept all scopes - Click Create. Copilot Studio shows a callback URL — copy it and add it as a redirect URI on your OAuth client at www.chainels.com/developer, then click Next
- Sign in to Chainels in the popup and approve access
- Toggle on the tools you want, click Add to agent, then Save
- Test by asking "Who am I?" — it should return your Chainels username
Custom MCP connectors require Developer Mode, which a workspace admin or owner needs to enable (available on ChatGPT Business, Enterprise, and Edu, as well as Plus, Pro, and Team). You also need your Client ID and Client Secret (see Before you start).
Admin (one-time):
-
- Open Workspace Settings
- Go to Permissions & Roles → Connected Data
- Enable Developer Mode / custom MCP connectors
Connect:
-
- Go to Settings → Connectors
- Click Add custom connector
- Paste the server URL:
https://mcp.chainels.com/mcp - Choose OAuth as the authentication type
- Enter your Client ID and Client Secret
- Click Connect, sign in to Chainels, and approve access (accept all scopes)
- Enable the tools you want, then ask "Who am I?" to confirm
Ask your assistant: "Who am I?" If it replies with your Chainels username, the connection works.
Trying it out safely firstWant to test before connecting to production? Use the Chainels demo environment. The setup steps are identical — just swap in these values:
-
- MCP server URL:
https://mcp.demo.chainels.com/mcp - Developer portal: demo.chainels.com/developer
- Authorization:
https://demo.chainels.com/oauth/authorize - Token:
https://demo.chainels.com/oauth/access_token - JWKS:
https://demo.chainels.com/oauth/jwks.json
- MCP server URL:
Note: You need a separate Chainels account and OAuth client on the demo environment — production credentials don't work on demo.
Troubleshooting-
- 401 Unauthorized during setup — the callback/redirect URL is not whitelisted. Copy the redirect URL shown by your client and add it to your OAuth client at www.chainels.com/developer.
- 401 Unauthorized after setup — wrong Client ID/Secret or an expired token. Re-enter your credentials in the connection settings.
- invalid_scope — a requested scope isn't allowed on your OAuth client. Check the allowed scopes in the developer portal.
- The tools list is empty — wrong server URL. Confirm it is exactly
https://mcp.chainels.com/mcp(including the/mcppath). - A tool disappeared or behaves differently — this can happen during the beta. Re-check the tool list in your client.
Still stuck? Contact Chainels support.