# MCP para agentes de IA


# MCP para agentes de IA

El **Model Context Protocol (MCP)** es un estándar abierto para dar a los asistentes de IA acceso seguro y estructurado a herramientas y datos. En lugar de escribir código de pegamento, apuntas un asistente como Claude a un servidor MCP y este puede descubrir las herramientas disponibles y llamarlas en tu nombre. Los productos de imatic exponen servidores MCP para que un agente pueda hacer trabajo real — comprobar disponibilidad y reservar una reunión, enviar y resumir respuestas de encuesta, ejecutar una votación en vivo — usando los permisos de tu cuenta.

## Lo que te da MCP

- **Descubrimiento de herramientas** — el asistente pregunta al servidor qué puede hacer y obtiene una lista tipada de herramientas, así no escribes integraciones a mano.
- **Acciones reales, no solo chat** — las herramientas leen y escriben tus datos reales (dentro de los ámbitos que concedes).
- **Un protocolo, muchos productos** — el mismo patrón de conexión funciona para Calendar, Survey y Voice Portal.

## Qué herramientas expone cada producto

### Calendar

Calendar incluye un servidor MCP de producción con **7 herramientas**:

- `list_event_types` — lista los tipos de reunión que ofreces.
- `list_slots` — encuentra espacios libres para un tipo de evento en una ventana de tiempo.
- `create_booking` — reserva un espacio para un invitado.
- `cancel_booking` — cancela una reserva.
- `reschedule_booking` — mueve una reserva a una nueva hora.
- `list_bookings` — lista las reservas existentes.
- `get_booking` — lee una sola reserva por id.

Esto hace de Calendar un encaje natural para un asistente de agendamiento con IA: puede descubrir tus tipos de evento, comprobar disponibilidad real y reservar sin duplicar reservas. Consulta [Calendar para desarrolladores](/calendar/developers).

### Survey

Survey ejecuta un servidor MCP en vivo en `POST /mcp` (JSON-RPC 2.0) con **10 herramientas** para trabajar con formularios, respuestas y votaciones:

- `whoami` — identifica al llamante autenticado y la organización.
- `list_forms` — lista los formularios de tu organización.
- `get_form` — lee la estructura de un solo formulario.
- `submit_response` — envía una respuesta a un formulario.
- `list_responses` — lista las respuestas de un formulario.
- `get_response` — lee una sola respuesta.
- `get_response_stats` — agrega estadísticas de respuesta para un formulario.
- `create_poll` — crea una votación rápida.
- `cast_vote` — emite un voto en una votación.
- `live_poll_results` — lee el recuento en vivo de una votación.

Consulta [Survey para desarrolladores](/survey/developers).

### Voice Portal

Voice Portal aborda MCP desde la otra dirección: en lugar de (solo) ser un servidor MCP, te permite **registrar servidores MCP externos** para que tus agentes de voz puedan usar sus herramientas durante una llamada. En el portal, ve a **Integraciones → Servidores MCP** para registrar un servidor, almacenar sus credenciales, descubrir sus funciones y vincular esas herramientas a un agente. Consulta [Herramientas y MCP para agentes](/voice/agents/tools-mcp).

## Transporte

El MCP de Calendar admite tanto HTTP como stdio, para que puedas conectar un asistente remoto o uno local; el MCP de Survey solo admite HTTP (JSON-RPC).

- **HTTP** — el asistente se conecta al endpoint `/mcp` del servidor por HTTPS. Úsalo para agentes alojados/remotos.
- **stdio** — el servidor se ejecuta como un proceso local que el asistente lanza y con el que habla por entrada/salida estándar. Úsalo para herramientas de escritorio locales.

## Autenticación y aislamiento

La credencial que espera un servidor MCP depende del producto:

- **Calendar** — se autentica con una **clave de API con ámbitos** que lleva el ámbito `mcp`, enviada como token Bearer. Los ámbitos de la clave siguen limitando lo que puede hacer cada llamada a herramienta, y las llamadas están confinadas a la organización de la clave. Genera una clave dedicada por agente en **Desarrolladores → claves de API**.
- **Survey** — se autentica con tu **JWT del portal** (un token de sesión), enviado como token Bearer. La organización del token limita cada llamada, así que un agente solo ve los formularios y respuestas de esa organización.
- **Voice Portal** — no te autenticas *a* un servidor MCP de Voice; en su lugar, **registras servidores MCP externos** en el portal y almacenas sus credenciales allí (ver abajo).

En todos los casos, las llamadas están confinadas a la cuenta u organización a la que pertenece la credencial — un agente no puede alcanzar los datos de otro cliente.

:::danger[Da a los agentes la credencial más estrecha]

Para Calendar, crea una clave de API dedicada para cada agente con solo los ámbitos que necesita, y recuerda que la clave **se muestra una sola vez** al crearla — cópiala entonces. Si un agente se comporta mal o su clave se filtra, revoca esa clave en el área de desarrolladores sin afectar tus otras integraciones.

:::

## Conectar desde Claude

Los clientes MCP (como Claude Desktop) leen una pequeña configuración JSON que les dice cómo alcanzar un servidor. La forma de abajo es ilustrativa — usa el endpoint exacto y cualquier indicador de la página para desarrolladores del producto, y pega una clave de API que hayas creado para este propósito:

```json
{
  "mcpServers": {
    "imatic-calendar": {
      "url": "https://<calendar-host>/mcp",
      "headers": {
        "Authorization": "Bearer cal_abc123.s3cr3t_keymaterial"
      }
    }
  }
}
```

Para una conexión local (stdio), el cliente lanza el comando del servidor en lugar de conectarse a una URL — de nuevo, sigue la página para desarrolladores del producto para conocer el comando exacto. Una vez conectado, pregunta al asistente qué herramientas tiene; para Calendar debería reportar las siete herramientas listadas arriba, y puedes pedirle, por ejemplo, "encuentra mi próximo espacio libre de 30 minutos y resérvalo para alex@example.com".

## Relacionado

- [API REST](./api) — las claves de API y los ámbitos con los que se autentica MCP.
- [Visión general de la plataforma](./overview) — cómo encajan las cuentas, las claves y los productos.
- [Calendar para desarrolladores](/calendar/developers) — el servidor MCP de 7 herramientas de Calendar.
- [Herramientas y MCP para agentes](/voice/agents/tools-mcp) — registra servidores MCP para agentes de voz.