1. Centro de Ajuda
  2. Piloto/Beta
  3. Outros lançamentos

Beta: Conectando assistentes de IA compatíveis com MCP à sua conta Guesty

Este artigo explica como conectar assistentes de IA compatíveis com o Protocolo de Contexto de Modelo (MCP) à sua conta Guesty usando o Servidor MCP da Guesty. Isso permite que assistentes como Cursor, Claude Desktop e VS Code recuperem e interpretem os dados da Guesty aos quais você tem autorização de acesso.

Importante:

O Guesty MCP Server é um recurso experimental em fase inicial de desenvolvimento beta. Não o utilize em produção. Nesta fase, o servidor permite apenas acesso de leitura, o que significa que os assistentes podem consultar e resumir dados, mas não podem criar, atualizar ou excluir registros do Guesty.

Visão geral do servidor Guesty MCP

O servidor expõe os recursos compatíveis do Guesty como ferramentas MCP. Seu assistente de IA só pode usar as ferramentas que estão registradas no servidor MCP e autenticadas com suas credenciais da API Guesty.

Os casos de uso típicos incluem:

  • Consultar registros do Guesty com suporte de um assistente
  • Resumo das informações de reserva, propriedade ou hóspede
  • Investigando questões operacionais usando dados autorizados da Guesty.
  • Reduzir as pesquisas manuais e, ao mesmo tempo, manter as credenciais da API fora das solicitações de bate-papo.

Antes de começar

  • Você precisará do seu client_id e client_secret da API Guesty.
  • Para o método de conexão local recomendado, você precisa ter o Node.js versão 20 ou posterior instalado e disponível no PATH do seu sistema.

Obtenha seu token da API Guesty

Para conectar seu assistente, você primeiro precisa de um token de acesso da API Guesty. Você pode obtê-lo trocando suas credenciais de cliente OAuth por um token de acesso.

Seu client_id e client_secret estão disponíveis na sua conta Guesty. Para mais informações, consulte nosso artigo sobre como usar a API aberta da Guesty.

Observação:

Se você configurar seu cliente MCP para usar diretamente seu CLIENT_ID e CLIENT_SECRET, poderá ignorar a etapa de troca manual de tokens.

  1. Execute o seguinte comando curl no seu terminal, substituindo `your-client-id` e `your-client-secret` pelas suas credenciais reais.

  2. Bash

     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. Uma solicitação bem-sucedida retorna uma resposta como esta:

  4. JSON

     { "token_type": "Bearer", "access_token": "eyJ...", "expires_in": 86400 }
  5. Copie o valor access_token. Este é o token de portador que você usará para configurar seu cliente. Os tokens geralmente expiram após 24 horas.

Observação:

Para evitar atingir os limites de tarifa da API, reutilize seus tokens Guesty até que eles expirem.

Escolha um método de conexão

Você pode se conectar ao servidor Guesty MCP de duas maneiras: localmente via stdio ou por meio de um endpoint HTTP hospedado. Recomendamos a configuração local via stdio para a maioria dos usuários, pois ela mantém suas credenciais fora das solicitações de bate-papo.

Modo Ponto final / Comando Ideal para
Local (stdio) — recomendado npx -y @guestyorg/sdk mcp Padrão para todos os clientes suportados; credenciais no ambiente ; fixe a versão do SDK.
Hospedado (HTTP) https://mcp.guesty.com/v1 Não há Node.js instalado na máquina, nem implantação gerenciada pelo Guesty.

Conecte seu cliente MCP

Siga as instruções abaixo para o seu cliente de assistente de IA específico.

Conectar cursor

  1. Abra o arquivo de configuração do MCP, localizado em ~/.cursor/mcp.json (para configurações do usuário) ou na configuração do MCP do seu projeto.
  2. Adicione uma das seguintes configurações:
    Recomendado — Estúdio local

  3. JSON

     { "mcpServers": { "guesty": { "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternativa — Hospedado com cabeçalho de autorização

  5. JSON

     { "mcpServers": { "guesty": { "url": "https://mcp.guesty.com/v1", "headers": { "Authorization": "Bearer your-guesty-token" } } } }
  6. Reinicie o Cursor e verifique se o servidor Guesty aparece como conectado em "Configurações → MCP".

Voltar ao topo

Conexão do Claude Desktop

  1. Abra o arquivo de configuração do Claude Desktop.
    1. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    2. Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Adicione uma das seguintes configurações:
    Recomendado — Estúdio local

  3. JSON

     { "mcpServers": { "guesty": { "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternativa — Hospedada
    Como o Claude Desktop não suporta cabeçalhos personalizados em sua configuração MCP, você precisa se autenticar para cada sessão.
    1. Adicione o seguinte ao seu arquivo de configuração:

    2. JSON

       { "mcpServers": { "guesty": { "url": "https://mcp.guesty.com/v1" } } }
    3. Após se conectar, peça ao assistente para se autenticar enviando uma mensagem como: Meu token Guesty é eyJ... — por favor, autentique-se .
    4. O assistente usará a ferramenta set_token para armazenar o token da sessão atual. Você deve repetir esse processo para cada nova sessão.

Voltar ao topo

Conectar o VS Code (GitHub Copilot)

  1. Abra o arquivo de configuração do MCP.
    • Espaço de trabalho: .vscode/mcp.json
    • Usuário: Abra a "Paleta de Comandos" e selecione "MCP: Abrir Configuração do Usuário".
  2. Adicione uma das seguintes configurações dentro do objeto de servidores :
    Recomendado — Estúdio local

  3. JSON

     { "servers": { "guesty": { "type": "stdio", "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternativa — Hospedada

  5. JSON

     { "servers": { "guesty": { "type": "http", "url": "https://mcp.guesty.com/v1", "headers": { "Authorization": "Bearer your-guesty-token" } } } }
  6. Recarregue a janela ou reinicie o anfitrião MCP. Confirme se a propriedade Guesty está anunciada e conectada nas configurações do Copilot Chat MCP.

Voltar ao topo

Conecte o Google Antigravidade

  1. Abra o arquivo de configuração do MCP, localizado em ~/.gemini/config/mcp_config.json. Você também pode abri-lo no painel do agente, selecionando "Gerenciar servidores MCP → Exibir configuração bruta".
  2. Adicione uma das seguintes configurações:
    Recomendado — Estúdio local

  3. JSON

     { "mcpServers": { "guesty": { "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternativa — Hospedada

  5. JSON

     { "mcpServers": { "guesty": { "serverUrl": "https://mcp.guesty.com/v1", "headers": { "Authorization": "Bearer your-guesty-token" } } } }
  6. Reinicie o Antigravity após a edição. No macOS, se o IDE não encontrar npx, use o caminho completo para npx (por exemplo, /opt/homebrew/bin/npx) no campo comando.

Voltar ao topo

Avançado: Usando Credenciais de Cliente OAuth2

Como alternativa ao uso de um token de portador, você pode fornecer seu CLIENT_ID e CLIENT_SECRET diretamente na configuração. O servidor realizará a troca de tokens na inicialização.

JSON

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

Voltar ao topo

Avançado: Fixando uma versão de lançamento

Para garantir um comportamento reproduzível, você pode fixar uma versão específica do SDK da Guesty na matriz de argumentos.

JSON

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

Voltar ao topo

Como usar a conexão

Assim que seu cliente estiver conectado e autenticado, você poderá fazer perguntas ao seu assistente sobre seus dados do Guesty. O assistente descobre automaticamente as ferramentas disponíveis do Guesty e as utiliza quando necessário para responder às suas perguntas.

Exemplos de perguntas:

  • "Encontre a reserva com o código de confirmação ABC123."
  • "Resuma os detalhes da reserva atual deste hóspede."
  • "Consulte os detalhes da propriedade para este anúncio."

Melhores práticas de segurança

  • Mantenha seu token de portador Guesty em segurança, pois ele concede acesso à API da sua conta.
  • Prefira usar o método stdio local com BEARER_TOKEN nas variáveis de ambiente ou o método hospedado com cabeçalhos de autorização . Isso impede que os tokens fiquem visíveis no seu histórico de bate-papo.
  • Caso precise usar a ferramenta set_token , evite colar tokens em sessões compartilhadas ou gravadas.
  • Não passe tokens como parâmetros de consulta na URL.
  • Não inclua arquivos de configuração do MCP que contenham tokens ativos no controle de versão.
  • Alterne suas credenciais de acordo com a política de segurança da sua organização.

Implantações gerenciadas

Para implantações dedicadas em que o Guesty fornece credenciais no servidor, basta conectar-se usando a URL. Nenhuma configuração de token no lado do cliente é necessária.

JSON

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

Entre em contato com a Guesty para configurar uma implantação gerenciada.

Como o servidor usa seu token

O token usado para chamadas à API do Guesty é determinado pela forma como é fornecido. Todas as chamadas à API dentro de uma sessão usam o token vinculado a essa sessão, e as sessões são isoladas umas das outras.

Fonte Quando se aplica
BEARER_TOKEN ou ambiente OAuth (stdio) Aplicado quando o processo do servidor MCP é iniciado.
Cabeçalho de autorização (hospedado) Vinculado na inicialização da sessão MCP
Ferramenta set_token (hospedada, Agent Desktop) Armazenado imediatamente para o restante da sessão.

Relativo a:

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0