Documentation / MCP tools
MCP tools
Connect your agent to tools provided by an external MCP server.
An MCP tool lets your agent use actions offered by an external server.
Before you start
Have the server's HTTP/HTTPS URL, permission to create tools and any credentials the server requires. Inspect its available actions and choose those your agent needs.
Connect the server
- In Tools, create a tool in the MCP category.
- Open its configuration and enter the full server URL.
- Select a credential if authentication is required.
- Configure the tool filter when you want to restrict the catalog used.
- Save and refresh the catalog to inspect discovered tools.
- Attach the tool to the agent or step where it will be used.
Guide the agent
Explain in the instructions when to use the tool and what to do if it fails. Do not request an action that the server catalog does not offer.
For an order lookup, for example, the server must provide a lookup tool and the agent must collect its required inputs before execution.
Test the connection
Ask a question requiring the tool. Inspect the response, parameters and execution result. Refresh the catalog before testing again if the server changed its tools.
| Problem | What to check |
|---|---|
| Cannot connect | URL, availability and backend access to the server |
| Authentication rejected | Selected credential and authorized server access |
| Missing tool | Updated catalog and configured filter |
| Wrong action | Description, parameters and agent instructions |
A call may change external data. Use appropriate server permissions and test credentials when validating writes. Filtering the catalog does not replace authorization in the external system.