Prerequisites
Before you begin, make sure you have:- Operator or Admin access in Cora
- The MCP server URL from the provider (usually found in their docs or settings page)
Connecting an MCP Server
Most MCP servers use OAuth, so the setup is straightforward: paste the URL, save, and sign in with the provider.1
Navigate to Tools
Go to Settings → Organization Settings → Tools
2
Add the tool
Click + Add Tool in the top-right
3
Enter the MCP server URL
Enter a name and the MCP server URL provided by the service
4
Save and initiate connection
Click Add Tool. The dialog stays open and transitions to a Connect view.
5
Authorize with the provider
Click Connect. You’ll be redirected to the provider’s login page to authorize access.
6
Confirm the connection is active
Once authorized, the dialog closes automatically and the connection is active: Cora can start using it in chat and agents right away.
Advanced: Other Authentication Methods
If the provider requires a different authentication method, expand Advanced Settings when adding the connection.- Bearer Token — paste a token provided by the service
- API Key — paste an API key from the provider
- Manual OAuth — if auto-discovery doesn’t work, toggle Show advanced options to manually enter Client ID, Client Secret, Authorization URL, Token URL, and Scopes
Testing Your Connection
After connecting, click the test icon (play button) next to the entry in the list. Cora will verify it can reach the MCP server and show how many capabilities were discovered at the endpoint.Private vs. Shared
By default, an MCP server you connect is private — only you can use it in chat and only your agents can access it. If you want your whole team to have access, click the share icon on the entry, then switch visibility from Only me to Everyone in organization in the dropdown. Only the person who created the connection can change this setting. Visibility applies to both chat and agents: private connections are only available to the creator, while organization-wide connections are available to everyone.Reconnecting
If an OAuth token expires or is revoked, open the entry (click the edit icon) and click Connect in the dialog footer. You can also click the Reconnect link that appears when a connection has lapsed.Troubleshooting
Connection fails when clicking Connect An error message will appear in the dialog explaining the issue (for example, invalid client, server unreachable). Verify your URL is correct and that the provider’s MCP server is running. OAuth errors Check that the provider has authorized Cora as a client. If you’re using manual OAuth settings, double-check the Client ID, Client Secret, and redirect URLs match what the provider expects. Need help? Reach out to us at support@cora.ai and we’ll help you get connected.Editing and Removing Connections
Use the inline action icons next to each entry:- Pencil icon — edit the name, URL, auth settings, or status
- Trash icon — remove the connection (with confirmation)