> ## Documentation Index
> Fetch the complete documentation index at: https://docs.klatt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP connections

> Connect a customer-managed MCP server so its selected tools can be used by an agent with explicit authentication and filtering.

Connect a customer-managed MCP server so its selected tools can be used by an agent with explicit authentication and filtering.

## Prerequisites

* An MCP server reachable from the Klatt runtime.
* A credential only if the server requires authentication.

## Add an MCP connection

1. Open **Tools** and choose **Create tool**.
2. Select **MCP Server** and enter the server URL.
3. Choose a managed credential or leave authentication empty when the server is intentionally public.
4. Add a comma-separated tool filter when the agent should see only selected tools.
5. Save the tool, attach it to an Agent node, and test a read-only action first.

## Constraints and failure states

The server URL must begin with `http://` or `https://`. An unreachable server, invalid credential, or filtered-out tool makes the action unavailable to the agent. The server controls the tool schema and remains an external dependency.

## Protect your data

Prefer HTTPS, narrow the tool filter, and use a credential with the least privilege. Review every tool schema before allowing it to mutate customer data or trigger an external action.

## Related

* [Tool lifecycle](/voice-agent/tools/introduction)
* [HTTP tool](/voice-agent/tools/http-api)
* [Tracing configuration](/configurations/tracing)


## Related topics

- [Tool lifecycle](/voice-agent/tools/introduction.md)
- [Add an agent to a website](/voice-agent/add-to-website.md)