# 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.

URL: https://www.ghosty.studio/docs/protocolos/mcp

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 [Conectores](/docs/conectores). |

## 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 [Eventos](/docs/api/eventos#catalogo).

## Traer tus propios servidores MCP

Con la [API de configuración](/docs/configurar) 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"]}
  ]}'
```

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).