Crisphive MCP

El servidor oficial de MCP (Model Context Protocol) para la API de Crisphive — infraestructura de programación de IA agéntica para los servicios de campo.

Permite que los agentes de IA — Claude, ChatGPT, Gemini, Cursor o cualquier cliente MCP — emparejen horarios entre clientes y empresas, y asignen cuadrillas a trabajos según la ubicación, las aptitudes y la disponibilidad en tiempo real: **la reserva de trabajos y la programación de citas, el seguimiento de órdenes de trabajo, la disponibilidad de un motor de programación y despacho en vivo, la sincronización de clientes (CRM), los catálogos de servicios, los listados de técnicos y cuadrillas, los territorios de servicio geográficos y la flota — para oficios y servicios del hogar como HVAC, fontanería, electricidad, limpieza, reparación de electrodomésticos y mantenimiento de propiedades. Servidor remoto alojado; no hay nada que instalar ni ejecutar (este repositorio contiene la documentación y el manifiesto de registro).

https://api.crisphive.com/mcp

Pruébalos primero

Conecta (basta con una clave de sandbox chsk_test_), y pega cualquiera de estas opciones directamente en tu agente:

1. Creación de trabajos — “Programa un trabajo de HVAC de 2 horas en 145 Laurier Ave W mañana para Marie Tremblay, 613-555-0142.” (createCustomer → listJobRequestBookingWindows → createJobRequest → quoteJobRequest → confirmJobRequest)

2. Inserción de emergencia — “Trabajo de fontanería de emergencia ahora en 99 Bank St para David Okafor (613-555-0198): enséñame qué se reprograma.” (listEmergencyCandidates → previewEmergencyReschedule → commitEmergencyReschedule)

3. Esquema diario — “Esquema mi día de mañana y señala cualquier cosa que esté en riesgo.” (listJobRequests → getTechnicianSchedule)

4. Descubrimiento de disponibilidad — “Encuentra 3 horas esta semana para dar un paseo en bicicleta con mi esposa sin arriesgar ningún trabajo.” (getTechnicianSchedule → el agente razona sobre el margen disponible)

Las mismas indicaciones aparecen en todos los listados y páginas de documentación de Crisphive, por lo que lo que ves aquí es exactamente la experiencia de primer uso en todas partes.

Related MCP server: Servicialo

Requisitos

Cualquier cliente MCP que admita servidores remotos sobre HTTP Streamable: claude.ai, Claude Desktop, Claude Code, ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, Cline, Zed, LM Studio, …

Instalación

claude.ai / Claude Desktop (OAuth — no se necesita clave)

Configuración → Conectores → Añadir conector personalizado y pega https://api.crisphive.com/mcp. Inicia sesión como propietario de la empresa en Crisphive cuando aparezca la pantalla de consentimiento. (Los conectores personalizados requieren un plan de Claude que los admita.)

Claude Code

# OAuth (you'll be prompted to authorize in the browser)
claude mcp add --transport http crisphive https://api.crisphive.com/mcp

# or with an API key (sandbox key shown — safe to experiment)
claude mcp add --transport http crisphive https://api.crisphive.com/mcp \
  --header "Authorization: Bearer chsk_test_YOUR_KEY"

Cursor

O añádelo a .cursor/mcp.json:

{
  "mcpServers": {
    "crisphive": { "url": "https://api.crisphive.com/mcp" }
  }
}

VS Code

code --add-mcp '{"name":"crisphive","url":"https://api.crisphive.com/mcp"}'

ChatGPT

Configuración → Conectores (modo desarrollador) → añade el servidor MCP con la URL https://api.crisphive.com/mcp (OAuth).

Gemini CLI

Añádelo a ~/.gemini/settings.json (nota: Gemini CLI usa httpUrl para las conexiones de servers HTTP Streamable):

{
  "mcpServers": {
    "crisphive": {
      "httpUrl": "https://api.crisphive.com/mcp",
      "headers": { "Authorization": "Bearer chsk_test_YOUR_KEY" }
    }
  }
}

Otros clientes MCP (Windsurf, Cline, Zed, LM Studio, …)

La mayoría de los clientes aceptan la forma estándar de servidor remoto:

{
  "mcpServers": {
    "crisphive": {
      "url": "https://api.crisphive.com/mcp",
      "headers": { "Authorization": "Bearer chsk_test_YOUR_KEY" }
    }
  }
}

Solo algunos clientes varían el nombre del campo de la URL:

Los clientes que solo entienden stdio pueden conectarse con mcp-remote:

{
  "mcpServers": {
    "crisphive": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.crisphive.com/mcp"]
    }
  }
}

Servidor local (npm — @crisphive/mcp)

Este repositorio también incluye un servidor local stdio ligero: las mismas 43 herramientas (mismos nombres, mismos esquemas — generados desde la misma especificación OpenAPI /v1 que el endpoint alojado), donde cada llamada es una solicitud HTTPS a la API de Crisphive con tu clave. No se ejecuta lógica de negocio localmente.

{
  "mcpServers": {
    "crisphive": {
      "command": "npx",
      "args": ["-y", "@crisphive/mcp"],
      "env": { "CRISPHIVE_API_KEY": "chsk_test_YOUR_KEY" }
    }
  }
}

Variables de entorno:

Prefiere el servidor remoto alojado (https://api.crisphive.com/mcp) cuando el cliente lo admita: OAuth, sin clave, siempre actualizado. El paquete local existe para clientes que solo admiten stdio y para instalaciones autohospedadas.

Para desarrollar en este repositorio: npm ci && npm test. El registro de herramientas (src/tools.generated.json) se genera una vez que npm run generate lo actualiza a partir de la especificación en vivo; CI falla si se desvía de /v1.

Autenticación

Cada solicitud se autentica con una clave de API secreta enviada como token bearer. Crea claves desde el dashboard de tu empresa Crisphive. El prefijo de la clave selecciona el entorno de datos:

• chsk_live_… → datos en vivo (producción)

• chsk_test_… → sandbox aislado (datos de prueba)

Carga las claves desde el entorno; nunca las insertes en el código.

Las claves caducan. La vida útil se decide al crear la clave: 30 días por defecto, hasta 365, y queda fijada para la vida de esa clave; no se puede ampliar después. Para renovarla, crea una segunda clave, apunta tu agente a ella y luego revoca la primera: una empresa puede tener varias claves activas a la vez, por lo que el cambio no interrumpe el servicio y no necesita un endpoint especial (el mismo procedimiento que AWS documenta para las claves de access). Lee expires_at desde el dashboard o la API de claves y programa el cambio. Una clave caducada devuelve API_KEY_EXPIRED, distinto de API_KEY_INVALID, de modo que puedes alertar sobre una renovación olvidada por separado de un proceso de revocación.

Crisphive envía un correo a los propietarios de la empresa 7 días antes de que una clave caduque (14 días para una conexión OAuth), así que un vencimiento no debería ser una sorpresa; sin embargo, el correo va a la empresa, no necesariamente a ti, por lo que debes controlar expires_at tú mismo. Una clave creada expresamente para durar menos de 7 días no tiene aviso previo; el aviso se habría enviado al crearla.

El endpoint MCP además admite OAuth 2.1 para conectores de usuario final (claude.ai, ChatGPT, …): el propietario de la empresa autoriza a tu agente en la pantalla de consentimiento y nunca se maneja una clave. Un cliente MCP compatible ejecuta todo el flujo automáticamente: descubrimiento, registro dinámico del cliente, código de autorización + PKCE. Flujo completo, permisos: docs/integration.md.

Herramientas

43 herramientas, una por operación de la API pública /v1 — los mismos nombres que los métodos del SDK (listCustomers, createJobRequest, …), derivadas de la misma especificación OpenAPI para que REST y MCP nunca se se separen. Referencia completa: docs/tools.md.

Flujo típico del agente:

listSkills / listJobTypes                → discover reference IDs
createCustomer                           → { customer_id }
listJobRequestBookingWindows             → offer only the returned windows
createJobRequest                         → booking created
quoteJobRequest → confirmJobRequest      → scheduled (auto or forced technician)
getJobRequest / listJobRequestChanges    → track status

Flujo de emergencia (P0):

createJobRequest (priority: "p0") → quoteJobRequest
listEmergencyCandidates                  → ranked techs + crew_recommendation
previewEmergencyReschedule               → what moves (or reassigns)
commitEmergencyReschedule                → inserted + auto-confirmed

Paginación

Las herramientas de lista aceptan page / limit y devuelven un objeto meta (total, count, per_page, current_page, total_pages).

Idempotencia

Las herramientas de crear / confirmar (createCustomer, createTechnician, createJobRequest, confirmJobRequest, commitJobRequestMove, commitEmergencyReschedule) aceptan un argumento idempotency_key para que los reintentos nunca creen duplicados: pasa el mismo valor el revertir.

Errores

Cada herramienta devuelve el sobre de respuesta de Crisphive (tanto como texto y como structuredContent): error_code es 0 en caso de éxito, y una cadena estable en caso de fallo (CUSTOMER_NOT_FOUND, API_KEY_INVALID, …). Compara los códigos; nunca las cadenas de mensajes.

Documentación

• Docs: https://docs.crisphive.com

• MCP: https://docs.crisphive.com/mcp

• Referencia de API: https://docs.crisphive.com/technical-reference

• Webhooks: https://docs.crisphive.com/webhook

• Para IA (especificación OpenAPI + inicio del asistente): https://docs.crisphive.com/for-ai

• Guía de integración de clientes: docs/integration.md

• Referencia de herramientas: docs/tools.md

Privacidad y soporte

• Política de privacidad: https://crisphive.com/privacy-policy — Crisphive procesa los datos del negocio accesibles a través de la API (clientes, reservas, técnicos, flota) únicamente para operar el Servicio; no vende información personal. Los datos se conservan mientras la cuenta esté activa y solo se comparten con proveedores de servicios/sub-procesadores cuando sea necesario. Un agente conectado a través de MCP actúa en nombre del negocio autorizador y está limitado a los datos, el entorno (live vs sandbox) y los permisos concedidos de ese negocio.

• Soporte: support@crisphive.com

Licencia

MIT