How to Connect an MCP Server
To connect a new MCP Server, follow these steps:- Open MCP Servers from the left navigation.
- Click + Create MCP Server.

- In the configuration panel, enter the connection details:
- Name: An identifier used to recognize and manage this MCP server in your workspace.
- URL: The endpoint URL of the external MCP server.
- Authentication (Auth): The security method required by the server (None, Token, or Custom Header).
Secure Authentication with Bot Fields
ChatbotX supports referencing Bot Fields when configuring authentication for MCP servers and tools, keeping your sensitive credentials centralized and secure:- When selecting Token or Custom Header authentication, click the variable icon (
</>) on the right side of the input field to select the corresponding bot field. - This capability specifically utilizes Bot Fields (bot-level configuration values and secret keys), rather than contact-level custom fields.
- Referencing bot fields eliminates the need to hardcode sensitive API keys directly into connection settings. It enhances security and allows you to update or rotate API keys centrally in Bot Fields without modifying each MCP server individually.

- After filling in the URL and authentication settings, click Get Tools. ChatbotX will scan the MCP server and retrieve the list of Available Tools.
- Select the checkboxes for the tools you want to make accessible to your AI Agent, then click Confirm to complete the connection.

Enable MCP Tools for an AI Agent
After adding an MCP Server successfully:- Open the configuration of the AI Agent that should use these tools.
- In the Agent’s AI Functions settings, select the connected MCP tools to grant access.
