Servidor MCP

Qué es

MCP (Model Context Protocol) es el estándar abierto que usan Claude y otros agentes para llamar a herramientas externas. kinapi-mcp-server expone toda la API v1 como un conjunto de herramientas: crear y consultar check-ins, comprobar el parte en SES, descargar el contrato firmado, gestionar propiedades. El agente ya sabe cuándo y cómo usarlas — no le explicas endpoints ni le escribes un cliente.

Frente a integrar la API REST directamente

No sustituye la API — es otra forma de hablar con ella. Cambia lo que tienes que construir tú:

• Sin cliente HTTP. Instalas el paquete y ya está: nada de gestionar cabeceras de autenticación, serializar JSON ni mapear respuestas a mano.
• Errores que el agente entiende, no JSON que hay que parsear. Un 404 no llega como {"error":"not found"} suelto: llega como «no existe ese check-in, comprueba el reservationId», así que el agente puede reaccionar o preguntarte en vez de romperse.
• Encadena llamadas sin que programes la orquestación. «Cancela la reserva R-2026-0412 y confírmame que se hizo» son dos llamadas API resueltas por el agente en una sola petición tuya.
• Lo usa cualquiera del equipo, no solo quien programa. Soporte u operaciones puede pedirle a Claude el estado de un huésped sin tocar código ni entrar al panel.
• Una línea de instalación. npx lo descarga y ejecuta; no hay que clonar nada ni compilar TypeScript.

Instalación

En Claude Desktop, Claude Code o cualquier cliente MCP, añade esto a su configuración (`claude_desktop_config.json` o `.mcp.json`):

{
  "mcpServers": {
    "kinapi": {
      "command": "npx",
      "args": ["-y", "kinapi-mcp-server"],
      "env": {
        "KINAPI_API_KEY": "kinapi_…"
      }
    }
  }
}

La API key es la misma que generas en el panel (Configuración → API) — ver Autenticación.

Herramientas disponibles

Paquete

Publicado en npm como kinapi-mcp-server. La versión 0.8.0 añade las exportaciones de registros, el justificante de comunicación y el filtro por propietario de kinapi_list_checkins (ver Exportación y fin del servicio).