Protocolos

MCP — herramientas del agente

Qué herramientas tiene un agente de Ghosty, cómo se nombran y cómo llegan a cada motor por el Model Context Protocol.

Actualizado 2026-09-16

Las herramientas del agente llegan por MCP (Model Context Protocol). Son las mismas para todos los motores: una tool nueva en la plataforma la ve cualquier agente sin tocar su máquina.

De dónde salen

Origen	Ejemplos	Quién las da
La máquina	leer y escribir archivos, terminal, `pdf-reader`, render de PDF, TTS	El motor, dentro de la máquina.
La plataforma	`programar_seguimiento` (turno futuro), búsqueda web	Studio, por turno.
El espacio de Teams	documentos, formularios, recordatorios, correo, memoria, marca, prospección	Teams, con una credencial de 5 minutos por turno.
Tus conectores	Gmail, Calendar, Drive, GitHub, Odoo…	En tu nombre; ver .

Cómo se nombran

Dentro del modelo cada tool va con el prefijo de su servidor MCP: ghosty__doc_read, ghosty__form_create, ghosty__reminder_create. Si le pides al agente «usa doc_read» lo encuentra igual: el prefijo es del transporte, no del nombre.

Familias en Teams: chat_*, doc_*, form_*, reminder_*, email_send, memory_*, brand_*, prospect_*.

Alcance por canal

El alcance lo decide el turno, no el agente:

DM o canal privado: todas las tools del espacio y los conectores de quien invoca.
Canal público (WhatsApp): sin conectores personales ni acciones destructivas; el agente puede escalar a una persona.
Editor por ACP: las de la máquina más las del espacio si el agente está activado en uno.

Un agente sólo puede hacer lo que la persona que lo invocó podría hacer.

Permisos

Algunas acciones piden confirmación (borrar, enviar a terceros). El cliente recibe un evento permission con opciones y contesta; si nadie contesta en diez minutos se deniega. Ver .

Traer tus propios servidores MCP

Con la le pones a tu agente sus propios servidores MCP (http o stdio). La lista se reemplaza entera y el agente se reinicia:

bash

curl -X PUT https://www.ghosty.studio/api/v2/agents/$GHOSTY_AGENT_ID/mcp \  -H "Authorization: Bearer $GHOSTY_AGENT_TOKEN" -H "Content-Type: application/json" \  -d '{"servers":[    {"name":"notion","type":"http","url":"https://mcp.notion.com/mcp","headers":{"Authorization":"Bearer …"}},    {"name":"fs","command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","/data/work"]}  ]}'

curl -X PUT https://www.ghosty.studio/api/v2/agents/$GHOSTY_AGENT_ID/mcp \  -H "Authorization: Bearer $GHOSTY_AGENT_TOKEN" -H "Content-Type: application/json" \  -d '{"servers":[    {"name":"notion","type":"http","url":"https://mcp.notion.com/mcp","headers":{"Authorization":"Bearer …"}},    {"name":"fs","command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","/data/work"]}  ]}'

Sólo en motores con máquina propia (Ghosty · Lite y Goose). Un servidor stdio necesita que el binario exista en la máquina (Node y Python están).

← Anterior

A2A — agente a agente

MCP de la documentación