Servidor MCP

La misma API, hablada directamente por Claude y otros agentes — sin que escribas un cliente HTTP.

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`):

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

20 tools

Campo	Tipo	Descripción
`kinapi_create_checkin`	escritura	Crea el check-in de una reserva y devuelve la URL para el huésped
`kinapi_list_checkins`	lectura	Lista check-ins con filtros por fecha, estado y propiedad
`kinapi_get_checkin`	lectura	Detalle de un check-in y sus huéspedes registrados
`kinapi_update_checkin`	escritura	Cambia fechas, horas o número de huéspedes
`kinapi_cancel_checkin`	escritura	Cancela el check-in de una reserva
`kinapi_get_ses_status`	lectura	Estado del parte en SES Hospedajes por huésped
`kinapi_download_contract`	lectura	Descarga el contrato firmado (PDF) a disco
`kinapi_list_properties`	lectura	Propiedades de la cuenta
`kinapi_get_property`	lectura	Detalle de una propiedad, con su propietario
`kinapi_create_property`	escritura	Da de alta una propiedad, con propietario inline opcional
`kinapi_update_property`	escritura	Actualización parcial: código SES, propietario, reactivar…
`kinapi_deactivate_property`	escritura	Baja lógica de una propiedad
`kinapi_list_contract_templates`	lectura	Plantillas de contrato de la cuenta
`kinapi_create_contract_template`	escritura	Crea una plantilla de contrato (con cláusulas estándar si se omiten)
`kinapi_update_contract_template`	escritura	Actualización parcial de una plantilla de contrato
`kinapi_delete_contract_template`	escritura	Elimina una plantilla de contrato
`kinapi_list_ses_credentials`	lectura	Conjuntos de credenciales SES de la cuenta (sin contraseñas)
`kinapi_create_ses_credential`	escritura	Crea un conjunto de credenciales SES
`kinapi_update_ses_credential`	escritura	Actualización parcial de un conjunto de credenciales SES
`kinapi_delete_ses_credential`	escritura	Elimina un conjunto de credenciales SES

Paquete

Publicado en npm como kinapi-mcp-server.