Saltar al contenido principal
API & MCP
Ver como Markdown

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.

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.

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.

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.

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:

{
  "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​

Última actualización en