MCP
Introduction
MCP (Model Context Protocol) allows your bot to connect to an external MCP server and use the tools it exposes. Instead of building a custom integration for every system, you register the MCP server once, and your bot can call any tool the server provides.
This enables your bot to retrieve additional tools from external systems and use them autonomously during a conversation, without you having to configure each tool one by one.
Common Use Cases
MCP can be used in various scenarios, such as:
- Connecting your bot to an internal or third-party MCP server that exposes business tools (e.g., order lookup, inventory check, ticket creation)
- Giving your bot access to a growing set of tools without reconfiguring the bot every time a tool changes
- Standardizing how your bot integrates with external systems using an open protocol
Requirements
You also need at least basic technical or scripting skills, since MCP relies on an external MCP server endpoint that already exposes the tools you want your bot to use.
Where to Access MCP
You can access MCP from the bot configuration area.
Go to:
Bots → Select your bot → Tools → MCP
From this tab, you can add an MCP integration and manage the tools retrieved from your MCP server. You can register up to 20 MCP integrations per bot.
Click Add MCP (Model Context Protocol) to create a new integration.
MCP Form Explanation
Below are the explanation of each field to configure an MCP integration and how to use them effectively.
Name
This field defines the name of your MCP integration.
Use a clear and descriptive name so it is easy to identify its purpose later, especially if you have multiple MCP integrations configured.
Example:
Redirect to detail page
URL
This is the Model Context Protocol (MCP) server endpoint used for retrieving additional tools.
The URL must point to a running MCP server that your bot can reach.
Example:
https://example.com
Bearer Token
This is the bearer token used for authentication with the MCP server, if your server requires one.
Leave this field empty if your MCP server does not require authentication.
MCP Tools
Once the connection to your MCP server is established, the tools exposed by that server are listed here. The chatbot can leverage any of the tools shown in this table.
Click Test Connection to retrieve the list of available tools from the server. Each tool is shown with its Title, Description, and Parameters, so you can review what the bot will be able to do before activating the integration.
You can use the search field to find a tool by name if your MCP server exposes many tools.
Final Step
After completing all required fields, click Test Connection to confirm your bot can reach the MCP server and retrieve its tools, then click Save & Activate to enable the integration.
Once activated, your chatbot will be able to call the tools exposed by your MCP server during a conversation.
Best Practices
To ensure optimal performance and reliability:
- Make sure the URL points to a valid and reachable MCP server
- Use Test Connection to verify the integration before activating it
- Keep your Bearer Token secret and rotate it if you suspect it has been exposed
- Review the tools listed under MCP Tools to confirm only the intended tools are exposed to your bot
