Documentação / Credenciais de ferramentas
Credenciais de ferramentas
Autentique ferramentas HTTP, servidores MCP e consultas de dados externos.
Credenciais guardam a autenticação usada pelo Tigy AI ao acessar um sistema externo.
Antes de começar
Obtenha a autenticação na documentação do serviço que será chamado. Você precisa de permissão para gerenciar a ferramenta e selecionar ou criar a credencial no workspace.
Configure a autenticação
- Abra a ferramenta HTTP ou MCP.
- Na seleção de credencial, escolha uma existente ou crie a adequada ao serviço.
- Informe o tipo de autenticação e os campos exigidos pelo formulário, como chave de API, Bearer, Basic ou cabeçalho personalizado.
- Associe a credencial à ferramenta e salve.
- Faça uma consulta de teste e confira o resultado no sistema externo.
O nome do cabeçalho precisa corresponder ao serviço. Authorization e um cabeçalho como X-API-Key não são intercambiáveis sem suporte do servidor.
Evite expor segredos
Não coloque chaves nas instruções do agente, em exemplos de prompt ou em conteúdo público. Use a credencial armazenada na configuração da requisição. Para testes, prefira uma conta com acesso somente aos dados e ações necessários.
Investigue recusas
| Resultado | Verificação |
|---|---|
| 401 | Chave ausente, expirada ou autenticação no formato errado |
| 403 | Conta reconhecida, mas sem acesso ao recurso ou à operação |
| Conexão falha | URL e rede; trocar a chave não corrige um destino inacessível |
Confirme também se a credencial pertence ao workspace da ferramenta. Ao trocar um segredo no serviço externo, atualize a credencial correspondente e repita um teste antes de publicar.