Beta: Conexión de asistentes de IA compatibles con MCP a su cuenta de Guesty

Este artículo explica cómo conectar asistentes de IA compatibles con el Protocolo de Contexto de Modelo (MCP) a su cuenta de Guesty mediante el servidor MCP de Guesty. Esto permite que asistentes como Cursor, Claude Desktop y VS Code recuperen y analicen los datos de Guesty a los que tienes acceso autorizado.

Resumen del servidor Guesty MCP

El servidor expone las funciones compatibles de Guesty como herramientas MCP. Tu asistente de IA solo puede usar las herramientas registradas en el servidor MCP y autenticadas con tus credenciales de la API de Guesty.

Entre los casos de uso típicos se incluyen:

• Consultar los registros de Guesty compatibles de un asistente
• Resumen de la información de la reserva, la propiedad o el huésped.
• Investigación de cuestiones operativas utilizando datos autorizados de Guesty
• Reducir las búsquedas manuales y mantener las credenciales de la API fuera de las indicaciones del chat.

Antes de comenzar

• Necesitarás tu client_id y client_secret de la API de Guesty.
• Para el método de conexión local recomendado, debe tener Node.js 20 o posterior instalado y disponible en la variable PATH de su sistema.

Obtén tu token de API de Guesty

Para conectar tu asistente, primero necesitas un token de portador de la API de Guesty. Puedes obtenerlo intercambiando tus credenciales de cliente OAuth por un token de acceso.

Tu client_id y client_secret están disponibles en su cuenta de Guesty. Para obtener más información, consulta nuestro artículo sobre cómo usar la API abierta de Guesty.

1. Ejecuta el siguiente comando curl en tu terminal, reemplazando your-client-id y your-client-secret con tus credenciales reales.

2. Intento

   curl -s -X POST https://open-api.guesty.com/oauth2/token \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials" \
     -d "client_id=your-client-id" \
     -d "client_secret=your-client-secret" \
     -d "scope=open-api"

3. Una solicitud exitosa devuelve una respuesta como esta:

4. JSON

   {
     "token_type": "Bearer",
     "access_token": "eyJ...",
     "expires_in": 86400
   }

5. Copia el valor de access_token. Este es el token de portador que usarás para configurar tu cliente. Los tokens suelen caducar a las 24 horas.

Elija un método de conexión

Puedes conectarte al servidor Guesty MCP de dos maneras: localmente mediante stdio o a través de un punto final HTTP alojado. Recomendamos la configuración local mediante stdio para la mayoría de los usuarios, ya que así tus credenciales no aparecerán en las solicitudes de chat.

Conecte su cliente MCP

Siga las instrucciones a continuación para su cliente de asistente de IA específico.

{
  "mcpServers": {
    "guesty": {
      "command": "npx",
      "args": ["-y", "@guestyorg/sdk", "mcp"],
      "env": {
        "CLIENT_ID": "your-client-id",
        "CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

"args": ["-y", "@guestyorg/sdk@0.2.0", "mcp"]

Cómo usar la conexión

Una vez que tu cliente esté conectado y autenticado, podrás hacerle preguntas a tu asistente sobre tus datos de Guesty. El asistente detectará automáticamente las herramientas de Guesty disponibles y las utilizará cuando sea necesario para responder a tus preguntas.

Ejemplos de indicaciones:

• "Busque la reserva con el código de confirmación ABC123."
• "Resuma los detalles de la reserva actual de este huésped."
• "Consulte los anuncios de esta propiedad."

Mejores prácticas de seguridad

• Mantén seguro tu token de portador de Guesty, ya que te otorga acceso a la API de tu cuenta.
• Se recomienda usar el método stdio local con BEARER_TOKEN en env o el método alojado con encabezados de autorización. Esto evita que los tokens sean visibles en el historial de chat.
• Si necesita utilizar la herramienta set_token, evite pegar tokens en sesiones compartidas o grabadas.
• No pases tokens como parámetros de consulta de URL.
• No incluyas en el control de versiones los archivos de configuración de MCP que contengan tokens activos.
• Adapte sus credenciales según la política de seguridad de su organización.

Implementaciones gestionadas

Para implementaciones dedicadas donde Guesty proporciona las credenciales en el servidor, solo necesita conectarse mediante la URL. No se requiere ninguna configuración de token del lado del cliente.

JSON

{
  "mcpServers": {
    "guesty": {
      "url": "https://mcp.guesty.com/v1"
    }
  }
}

Contacte con Guesty para configurar una implementación gestionada.

Cómo el servidor utiliza tu token

El token utilizado para las llamadas a la API de Guesty se determina según cómo se proporcione. Todas las llamadas a la API dentro de una sesión utilizan el token vinculado a esa sesión, y las sesiones están aisladas entre sí.