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.

Conectar no Claude (Web/Desktop) — recomendado

Sem copiar token nenhum. Este é o caminho preferido:

1. No aplicativo, adicione um servidor MCP com o endereço https://app.knewin.ai/api/mcp (só o endereço — sem token, sem cabeçalho).
2. Ele descobre sozinho para onde mandar você autorizar e abre a tela de consentimento do Knewin AI no navegador. Ela mostra quem está pedindo (o domínio do aplicativo) e para onde a autorização vai voltar.
3. Entre com a sua conta e confirme. Pronto — o acesso é da sua conta, e o aplicativo passa a ver as mesmas ferramentas e listas.

Confira o domínio antes de autorizar: quem você aprovar ali passa a alcançar as suas conversas e os seus entregáveis. Se desistir, clique em Cancelar — o aplicativo recebe a recusa e não fica esperando. O botão Revogar token das Configurações derruba também as autorizações concedidas por aqui.

Vale para qualquer aplicativo de IA que fale MCP, não só o Claude — os que sabem autorizar por OAuth seguem exatamente esses passos. Os que não sabem continuam pelo caminho do token, abaixo.

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.

Se o seu aplicativo não faz OAuth: o caminho do token

Alguns clientes ainda não sabem autorizar sozinhos — e os conectores que você já configurou com token continuam funcionando. Para esses:

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).
• A autorização por OAuth vale 1 hora e se renova sozinha por até 90 dias. O botão Revogar token derruba tudo isso junto.
• O Conectar (OAuth) é pelo endereço HTTP (/api/mcp): é ele que devolve a recusa com o caminho da autorização. O transporte SSE aceita os dois — o token na URL (o contrato dele, que os conectores antigos usam) e a credencial no cabeçalho.
• Existe um freio de ritmo de 60 chamadas por minuto por conta. Nenhum uso normal encosta nisso; um cliente em laço leva recusa temporária.

Veja também

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