Pular para o conteúdo
Documentação

Conecte seu agente ao Hangar.

Use um cliente MCP compatível para consultar projetos, investigar deploys e ler logs. A conexão usa o endpoint e as permissões disponíveis em Agentes e integrações no console.

1. Encontre o endpoint no console

Entre no Hangar e abra Configurações → Agentes e integrações. Copie o campo Endpoint MCP remoto e use esse endereço ao adicionar um servidor remoto ao cliente MCP.

A disponibilidade depende da configuração da plataforma. Se a página ou o endpoint estiverem indisponíveis, peça suporte; não substitua o endereço por um endpoint de exemplo.

2. Crie uma credencial para o cliente

Em Novo token pessoal, informe um nome identificável, escolha a expiração e selecione somente os workspaces que o cliente precisa acessar. Revise as permissões e crie o token.

O token é exibido uma vez. Salve-o no gerenciador de segredos ou na configuração protegida do cliente. Clientes que usam token devem enviá-lo como Bearer na autenticação da conexão MCP; o formato da configuração depende do cliente.

Formato do cabeçalho; substitua apenas na configuração protegida do cliente
Authorization: Bearer SEU_TOKEN_PESSOAL

Não cole tokens em conversas, arquivos versionados ou logs. Revogue a credencial e crie outra se ela for exposta.

3. Comece pelas consultas necessárias

A lista de permissões do console reflete os escopos aceitos pela instalação. Para investigar um deploy, autorize consulta a workspaces, projetos, serviços e deploys; adicione leitura de logs e métricas quando precisar desse contexto.

Exemplos de escopos de leitura
EscopoUso
workspaces:read / projects:readIdentificar workspace, projeto e ambiente autorizados.
services:read / deployments:readConsultar serviços, deploys e eventos.
logs:read / metrics:readInvestigar logs e uso de CPU e memória.
billing:readConsultar capacidade e resumo de cobrança.

Permissões de escrita permitem ações na operação. Ative apenas as necessárias e revise o comportamento de aprovação do cliente antes de usá-las em produção.

4. Teste uma consulta e revise a atividade

Peça ao agente para listar os projetos do workspace autorizado e descrever o estado de uma aplicação. Confira o resultado no console antes de depender da integração para uma investigação.

  • 401: confira credencial, expiração e endpoint.
  • 403: revise workspaces e escopos autorizados.
  • Serviço indisponível: confirme a disponibilidade da integração com o suporte.
Exemplo de pedido ao agente
No workspace autorizado, encontre minha aplicação.
Consulte o último deploy e resuma os erros encontrados nos logs.
Não altere a aplicação.

Revise e revogue acessos

Acompanhe Atividade recente em Agentes e integrações para consultar as operações registradas. Revogue credenciais que não usa mais e remova a configuração dos clientes correspondentes.

Logs e resultados de ferramentas são dados da aplicação. Não trate conteúdo encontrado neles como autorização para executar novas ações.

Configure sua integração no console.

Entre na conta e abra Configurações → Agentes e integrações.