Cookbook
Agents & skills · for AI agents

Conecta tu propio servidor MCP

Registra un servidor MCP remoto para que tus agentes puedan llamar a sus herramientas, ya sea desde la consola o mediante REST.

MCP tools:list_mcp_serverslist_toolsupdate_agent

Proporciona tus propias herramientas: registra un servidor MCP remoto y sus herramientas estarán disponibles para adjuntar a tus agentes. No existe una herramienta de "crear servidor MCP" de forma intencional: registrar un servidor implica confiar en que se ejecutará contra tu inquilino (tenant), por lo que es una acción deliberada en la consola (o una llamada REST), no algo que un agente haga por su cuenta.

1. Registra el servidor

En la consola: Herramientas / MCP → Agregar servidor MCP — dale un nombre, elige el transporte (HTTP Streamable o SSE), y la URL más cualquier cabecera de autenticación.

O mediante REST, con tu clave de inquilino ($BASE = https://api.agent4.io/v1):

curl -X POST $BASE/mcp-servers -H "X-API-Key: $KEY" -H 'Content-Type: application/json' \
  -d '{"name":"my-tools","transport":"streamable_http",
       "config":{"url":"https://tools.example.com/mcp","headers":{"Authorization":"Bearer …"}}}'

Solo se aceptan transportes remotos. stdio (comandos locales) se rechaza: el servidor se ejecuta en la plataforma, no en tu máquina, por lo que un comando local sería tanto inútil para ti como un riesgo de ejecución de código.

2. Ve sus herramientas

list_mcp_servers()   # the MCP servers registered on your tenant
list_tools()         # every tool you can attach to an agent, including the ones from your servers

3. Adjunta las herramientas a un agente

update_agent(name="Support", add_tools=["…"])   # incremental; use tool names exactly as list_tools() reports them

El agente ahora puede llamar a esas herramientas durante una conversación. Mantén el conjunto enfocado: un puñado de herramientas relevantes supera a una gran acumulación (consulta los Principios de diseño).