Conectar por chave de API

Manual de Agentes de IA · capítulo 3 de 7

Use este caminho para agentes desenvolvidos pela sua equipe, automações e ferramentas de linha de comando.

Em Sistema › Chaves API, clique em Nova chave.
Dê um nome que identifique o agente, por exemplo “Agente de plantão”.
Em Escopos, marque mcp e read. Marque também write somente se o agente for abrir chamados ou registrar acompanhamentos.
Defina o Limite/hora e, se quiser, a Validade.
Clique em Criar chave e copie a chave: ela aparece uma única vez.

A chave age como o usuário que a criou. Para um agente de consulta, o ideal é criar a chave com um usuário que tenha só os direitos de leitura necessários.

Informar a chave no agente

O agente envia a chave no cabeçalho Authorization, no formato Bearer seguido da chave. No Claude Code, por exemplo:

claude mcp add --transport http h2o https://ENDERECO-DO-SERVIDOR/api/v1/mcp --header "Authorization: Bearer SUA_CHAVE"

Em ferramentas que pedem o tipo de autenticação, escolha chave de API em cabeçalho, com o cabeçalho Authorization e o valor Bearer seguido da chave. Uma chamada direta ao servidor tem esta forma:

POST /api/v1/mcp
Authorization: Bearer SUA_CHAVE
Accept: application/json, text/event-stream
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}

Esta página ajudou?