Conectores
Conecte servidores MCP remotos para que as revisões e as tarefas possam verificar o que o código sozinho não mostra: como um recurso é usado, o que dizem os logs, os dados de uma tabela ou a documentação de uma biblioteca. Os conectores estão incluídos nos planos pagos.
Adicionar um conector
Só um proprietário da organização no GitHub, ou o proprietário de uma conta pessoal, pode gerenciar conectores. Configurações do espaço de trabalho → Membros os identifica como Proprietário da organização no GitHub ou Proprietário da conta.
No plano gratuito, inclusive depois que um plano pago termina, as revisões e as tarefas não usam os conectores salvos, e você só pode removê-los.
- Abra Configurações do espaço de trabalho → Conectores e selecione Adicionar conector.
- Informe um nome, o endpoint HTTPS do servidor e os cabeçalhos da solicitação de que ele precisa e selecione Carregar ferramentas.
- Escolha as ferramentas a permitir, os repositórios e onde usar o conector.
- Selecione Salvar conector. As revisões e as tarefas iniciadas a partir de então podem usá-lo.
| Campo | O que informar |
|---|---|
| Nome | O que o conector contém, como Análises de produção. |
| Endpoint HTTPS | O endereço Streamable HTTP do servidor, como https://mcp.your-service.com/mcp. |
| Cabeçalhos da solicitação | As credenciais que o servidor espera, como Authorization: Bearer <token>. Os valores são armazenados criptografados e nunca mais exibidos. |
| Notas para o HeyDeer | Opcional: o que o conector contém e quando ele ajuda. |
Ao editar um conector, deixe o valor de um cabeçalho em branco para manter o valor salvo. Se você alterar o endpoint, informe todos os valores novamente.
Requisitos do endpoint e dos cabeçalhos
- O endpoint não pode incluir uma query string, um fragmento
#, um nome de usuário ou senha, nem uma porta diferente de 443. - Ele precisa de um nome de domínio público, não de um endereço IP ou de um nome terminado em
.local,.internal,.test,.invalid,.exampleoulocalhost. - Um conector pode ter até 10 cabeçalhos, cada valor com até 8.192 caracteres ASCII imprimíveis.
- Um espaço de trabalho pode ter até 50 conectores.
Ferramentas
Ferramentas somente leitura lista as ferramentas que o servidor marca como somente leitura. Todas as outras ferramentas, inclusive as que o servidor não marca, ficam em Outras ferramentas. Quando você carrega as ferramentas pela primeira vez, só as ferramentas somente leitura ficam permitidas.
| Execução | Ferramentas que pode chamar |
|---|---|
| Revisões e Autopilot | Ferramentas somente leitura permitidas |
| Corrigir com HeyDeer e menções a @heydeer | Todas as ferramentas permitidas, somente leitura ou outras |
Um agente só pode chamar as ferramentas permitidas e decide quando uma delas ajuda. Se as ferramentas do servidor mudarem, selecione Recarregar ferramentas.
Onde os conectores são usados
Um conector vale para todos os repositórios ou para os que você selecionar. Uma tarefa que trabalha em vários repositórios recebe os conectores de qualquer um deles.
Por padrão, um conector só é usado em repositórios privados, em alterações de pessoas com acesso de escrita. Uma revisão ou tarefa o deixa de fora quando:
- o repositório é público, ou uma tarefa pode alterar um repositório público;
- o pull request vem de um fork;
- o autor do pull request não tem acesso de escrita ao repositório.
Escolha Também repositórios públicos e forks apenas para conectores cujos dados qualquer pessoa possa ver, como documentação pública. A página da revisão ou da tarefa mostra quais conectores ficaram de fora e por quê.
Chamadas a conectores
A página de uma revisão ou tarefa lista cada chamada a um conector: o conector, a ferramenta, quando ela foi executada, quanto tempo levou e se falhou. O HeyDeer não guarda o que foi enviado nem o que foi retornado.
As chamadas de ferramentas e o texto que elas retornam fazem parte do trabalho, então entram nos créditos que ele usa. Se uma revisão falhar depois de chamar um conector, os créditos dela não são devolvidos. Consulte Como funcionam os créditos.
Privacidade e confiança
O agente nunca vê os valores dos cabeçalhos: a sandbox do HeyDeer os adiciona às solicitações do agente na saída.
As solicitações podem incluir código e contexto da tarefa, que o operador do servidor trata de acordo com as próprias políticas. Mesmo uma ferramenta somente leitura pode retornar dados privados, então conecte apenas serviços em que você confia, use credenciais sem mais acesso do que o necessário, como uma função somente leitura no banco de dados, e permita apenas as ferramentas de que você precisa. Consulte Segurança.
Se o HeyDeer não conseguir carregar as ferramentas de um conector, consulte Solução de problemas.