Integração com o Claude: configurar

Como ligar o Knewin AI ao Claude. O que o conector faz está em Integração com o Claude (MCP); como ele se comporta no dia a dia, em Integração com o Claude: no dia a dia.

Transportes

Existem dois transportes, ambos autenticados pelo mesmo token exclusivo:

• SSE (/api/mcp/sse) — usado pelo Claude Web/Desktop; o token já vem embutido na URL do conector.
• HTTP (/api/mcp, "Streamable HTTP") — idiomático no Claude Code; o token vai no header Authorization: Bearer.

Como configurar no Claude (Web/Desktop)

1. Em Configurações, copie a URL do Conector Knewin AI (SSE) (ela já contém o seu token).
2. No Claude (Web), abra Personalizar → Conectores → Add custom connector, cole essa URL no campo de endereço e confirme.

Como configurar no Claude Code (CLI)

1. Em Configurações, use o botão Copiar comando do bloco do Claude Code — ele já vem com o seu token.

2. Cole no terminal. O comando tem esta forma:

   claude mcp add --transport http knewin-ai https://app.knewin.ai/api/mcp \
     --header "Authorization: Bearer SEU_TOKEN"
   

3. Verifique com /mcp dentro do Claude Code — o servidor knewin-ai deve aparecer, com as ferramentas e as marcas da conta como recurso.

O token vai no header, nunca na URL. Colocar ?token=… no endereço do /api/mcp não funciona mais: a credencial na URL vaza pelo histórico do navegador, pelo log do proxy e por qualquer captura de tela. Se você configurou assim antes, refaça com o comando acima.

Transporte SSE legado (alternativa ao HTTP, também funciona no Claude Code):

claude mcp add --transport sse knewin-ai "https://app.knewin.ai/api/mcp/sse?token=SEU_TOKEN"

Segurança

• O token é exclusivo e pode ser revogado a qualquer momento nas Configurações; ao revogar, um novo token/URL é gerado e os clientes antigos param de funcionar (precisam ser reconfigurados com o novo token).

Veja também

Integração com o Claude (MCP), Integração com o Claude: no dia a dia e Configurações.