MCP servers
MCP servers enable your AI agent to use external tools through the Model Context Protocol (MCP). Connect to any MCP-compatible server to add capabilities like querying databases, calling APIs, or interacting with third-party services.
How it works
- You provide an MCP server URL
- Moveo discovers authentication requirements
- You authenticate (if required)
- Moveo discovers available tools
- You select which tools to enable
- Your AI agent can use these tools during conversations
Prerequisites
Before adding an MCP server, ensure you have:
- An MCP server endpoint URL (must support Streamable HTTP transport)
- Authentication credentials (if required and not OAuth)
Add an MCP server
Navigate to your AI agent → Workflows → MCP servers, then select Add MCP server.
Step 1: Enter the server URL
Enter your MCP server URL. Moveo automatically discovers the server's authentication requirements.
SSE transport is deprecated. If your URL ends with /sse, remove it and use the base endpoint instead.
Step 2: Authenticate
OAuth authentication
For OAuth-protected servers:
- Click Connect to start the OAuth flow
- A popup window opens to the authorization server
- Sign in and authorize Moveo to access the server
- The popup closes automatically on success
If the server supports dynamic client registration (RFC7591), Moveo registers automatically. Otherwise, provide a client ID and secret manually.
Step 3: Select tools
After authentication, Moveo displays all available tools from the server. Select which tools your AI agent can use:
- Use Select all to enable all tools
- Use Select none to clear selections
- Hover over a tool to see its description
Manage MCP servers
The MCP servers table displays all configured servers with their current status.
Table columns
| Column | Description |
|---|---|
| Name | Server name and number of enabled tools |
| URL | Server endpoint |
| Created by | User who created the server |
| Last used | When the server was last called |
| Status | Connection and sync status |
| Enable | Toggle to activate/deactivate the server |
| Actions | Edit, resync, or delete |
Status indicators
| Status | Meaning |
|---|---|
| Verified | Connected; tools and authentication synced |
| Outdated | Tool definitions changed on the server |
| Error | Cannot connect to the server |
Edit an MCP server
Select a row in the table or choose Edit from the actions menu to modify a server.
The edit panel displays:
- Name: Editable server name
- Server URL: Read-only with a copy button
- Warning banner: Appears when status is "Outdated", indicating tools changed on the server
- Tools: Toggle buttons for each available tool. Hover over a tool to see its description.
When you open the edit panel, Moveo fetches the latest tools from the server. New tools added to the server appear here, allowing you to enable them.
If the server status is Outdated, resync before saving changes. The Update button is disabled until you resync.
Select Update to save changes.
Resync tools
When an MCP server updates its tool definitions, the status changes to Outdated. To update your local tool definitions:
- Select Resync from the actions menu or the edit panel
- Review the changes in the dialog:
- Updated: Tool definition changed
- Deleted: Tool no longer available on server
- Select Resync to apply changes
Resync only updates or removes existing tools. To add new tools that were added to the server, edit the server and select them from the tool list.
Enable or disable a server
Use the toggle in the Enable column to activate or deactivate an MCP server. Disabled servers remain configured but the AI agent cannot access their tools.
Delete an MCP server
From the actions menu, select Delete to remove a server. This action cannot be undone.
Troubleshooting
SSE endpoint error
The SSE transport is deprecated. If your server URL ends with /sse, remove that suffix and use the base endpoint:
- Wrong:
https://example.com/mcp/sse - Correct:
https://example.com/mcp
OAuth connection fails
If OAuth authorization fails:
- Verify the server supports OAuth and is properly configured
- If dynamic registration fails, enter client credentials manually
- Ensure your OAuth provider allows the Moveo redirect URI
- Check that required scopes are available
Tools not appearing after resync
After resyncing, new tools appear in the tool selection list but are not automatically enabled. Edit the server and select the new tools you want to use.
Server shows "Error" status
The server cannot be contacted. Verify:
- The server is running and accepting connections
- Any required authentication credentials are still valid
If the issue persists, delete the server and add it again.
Next steps
- Dialog Webhooks — trigger custom logic during conversations
- Event Webhooks — respond to conversation events