Uso de MCP | Horato

Las herramientas MCP exponen lectura segura y escrituras con aprobación sobre el mismo modelo de acciones que REST.

Modelo de herramientas

Las herramientas son bindings ligeros sobre recursos de Horato. El catálogo debe incluir esquema de entrada, capacidad requerida, política de aprobación y forma de salida.

`email.search` lee mensajes e hilos.
`calendar.availability` lee libre/ocupado y disponibilidad de reservas.
`booking.create` crea o mantiene una reserva.
`email.send` requiere aprobación antes de enviar correo visible externamente.

Configuración del servidor

Configura la API key y la URL base en el entorno del servidor MCP.

Entorno del servidor MCPbash

HORATO_API_KEY=hr_live_...
HORATO_API_BASE_URL=https://api.hora.to

Config del agentejson

{
  "mcpServers": {
    "horato": {
      "command": "npx",
      "args": ["@horato/mcp"],
      "env": {
        "HORATO_API_KEY": "hr_live_..."
      }
    }
  }
}

Política de aprobación

Exige aprobación para operaciones que envían mensajes, crean reservas, modifican eventos, eliminan datos, rotan keys, reproducen entregas o inician jobs de exportación.

Escritura con aprobacióntypescript

tools.register("email.send", {
  requiresApproval: true,
  inputSchema: sendEmailSchema,
  handler: horato.mcp.email.send
});

Historial de ejecuciones

Cada ejecución de agente debe estar visible en `/v1/mcp/runs` y vinculada con aprobaciones, operaciones de proveedor y eventos webhook. Usa replay de ejecuciones para flujos de reparación después de fallos transitorios del proveedor.