You can connect one or more MCP servers to an AI agent to extend its capabilities. Once connected, the agent can use the tools, resources, and prompts exposed by the selected MCP server at runtime.
Before you begin, make sure you have:
Note
Only enabled MCP servers appear in the list of available connections.
-
An AI agent. For more information, see Create AI agent.
-
At least one enabled MCP server. For more information, see Create MCP servers.
Perform the following steps to create an MCP server while creating an agent:
-
Enter a Name for the connection.
-
(Optional) Enter a Description.
-
Enter the MCP URI.
-
(Optional) Add any required HTTP headers as key-value pairs.
-
In the Add capabilities page, on the top of the page select MCP connections.
-
On the top right, click + Create an MCP connection to create a new connection. For setup details, see MCP server.
-
In the General section:
-
In Application details:
-
In Configure authentication, select an auth type and fill in the fields for that type:
Token:
-
HHTP body
-
HTTP header
-
URL parameter
-
Enter the Token.
-
Select how to send the token using the Send token via dropdown.
Note
For security reasons, the token must be re-entered each time you edit this connection.
OAuth 2.0
-
Select or create an OAuth 2.0 client using the dropdown. Click + to create a new client or the edit icon to modify an existing one.
-
(Optional) Enter the required Scope.
Custom
-
In Custom encrypted fields, enter your credentials as a JSON object. These fields are encrypted at rest.
-
(Optional) In Custom unencrypted fields, enter any additional fields as a JSON object.
-
-
Click Test connection to verify that Celigo can connect to the MCP server.
-
If the test succeeds, click Save & close.
The connection is added to the MCP connections list.
The selected capabilities are added to the agent and are available whenever the agent runs. Expand the MCP Connection to see a list of tools, resources and prompts provided by the MCP.
If the connection test fails, verify that:
-
The MCP URI is correct and the server is reachable.
-
The authentication credentials are valid.
-
Any required HTTP headers are configured correctly.
-
The MCP server is running and accessible from integrator.io.
An MCP server can expose one or more of the following capabilities:
-
Tools – Allow the agent to perform actions or retrieve information from connected systems.
-
Resources – Provide read-only reference files, such as schemas, lookup tables, configuration files, or policy documents, that the agent can use to answer requests. Resource files must be smaller than 3 MB.
-
Prompts – Reusable prompt templates that standardize how the agent performs common tasks.
Important
The capabilities available to an agent depend on what is configured and enabled on the connected MCP server.
After you create the connection, choose the capabilities the AI agent can access.
-
Tools
-
Resources
-
Prompts
-
Expand the MCP connection.
-
Select the required:
-
Click Save.
Only the selected capabilities are available to the AI agent at runtime.
Note
Restricting access to only the capabilities an agent needs helps improve security and ensures predictable agent behavior.
After you add an MCP connection, you can manage it from the Tools & capabilities section of the agent.
-
Select the Settings (⚙️) icon to configure a capability.
-
Select the Delete icon to remove a capability from the agent.
Removing a capability from the agent does not remove it from the MCP server.
I can't find my MCP server
Verify that the MCP server is enabled in AI Studio > MCP servers. Disabled servers are not available for selection.
I don't see all the expected tools, resources, or prompts
Check that the required capabilities are configured and enabled on the MCP server. If they were recently added or updated, refresh the page and reopen the connection.
The agent can't access a resource
Verify that:
-
The resource still exists in Celigo File Storage.
-
The file size is less than 3 MB.
-
The resource is enabled on the MCP server.