Sua agência como ferramenta para clientes de IA.

Como funciona

• Um endereço por agência

  Streamable HTTP com respostas JSON. Funciona com os clientes MCP que aceitam um cabeçalho de autorização.

• A mesma chave da API

  O MCP usa as chaves de API da agência, criadas no painel e mostradas uma única vez.

• Só o que a chave permite

  O cliente de IA vê só as ações que as permissões da chave liberam, e nunca mais do que quem a criou.

• Alterações com aprovação

  Leituras devolvem o resultado. Criações, edições e exclusões devolvem uma proposta pending_approval, que só uma pessoa aprova.

• Retentativa sem duplicar

  Cada chamada leva um requestId (UUID). Repetir o mesmo pedido devolve a mesma proposta; mudar os dados com o mesmo ID é recusado.

• Só ações definidas

  O cliente de IA usa apenas as ações da lista abaixo. Não há acesso livre aos dados.

Como conectar

1. 1

   Crie uma chave de API

   No painel, em Configurações › API e MCP, crie uma chave com as permissões que o cliente de IA pode usar. Copie a chave na hora: ela não aparece de novo.

2. 2

   Configure o cliente MCP

   Aponte o cliente para o endpoint da agência e envie a chave no cabeçalho Authorization. O formato exato varia de cliente para cliente; o painel mostra o endereço pronto.

   {
     "mcpServers": {
       "excursso": {
         "url": "<endereço-da-api>/api/organizations/<id-da-agência>/agents/mcp",
         "headers": { "Authorization": "Bearer exc_live_<sua-chave>" }
       }
     }
   }

3. 3

   Chame as ferramentas

   Os nomes usam sublinhado, como departures_create, e recebem { requestId, input }. Guarde o requestId para repetir uma chamada com segurança.

   {
     "requestId": "<uuid>",
     "input": { "...": "argumentos da operação" }
   }

4. 4

   Aprove e execute

   Quem criou a chave aprova a proposta no painel, em API e MCP. Depois, execute_approved_action({ callId }) executa a ação aprovada ou devolve o resultado já gravado.

Operações disponíveis

Limites de hoje

• Ainda não há descoberta OAuth: clientes que só aceitam OAuth não conseguem conectar.
• Reservas, pagamentos, publicação de ofertas, mídia e equipe ainda não são ferramentas.
• Chaves expiradas ou revogadas, IDs de outra agência e pedidos vindos de navegador são recusados.
• O limite de 300 requisições por minuto vale para a chave, somando API e MCP.
• As listagens são paginadas e permitem chegar até o último registro.