Conectar seu agente

Uma URL e uma chave: Claude Code, Codex CLI e OpenCode

Atualizado em 2026-09-17

O MCP do Kanbix é um servidor remoto (Streamable HTTP): não há nada para instalar na sua máquina, nenhum pacote para baixar. Você registra uma URL no seu agente e autentica com uma chave de API — o mesmo endereço vale para o Claude Code, o Codex CLI, o OpenCode e para os conectores do ChatGPT e do Claude.

URL do servidor

https://api.kanbix.com.br/mcp
1

Crie uma chave de API

Vá em Configurações de IA → aba MCP → Nova chave. Marque os boards que ela cobre e só os escopos que o agente realmente precisa.

2

Copie o token

O token (kbx_live_…) aparece uma única vez. Guarde-o com segurança: ele não é recuperável depois.

3

Registre a URL no seu agente

Use o comando da sua ferramenta abaixo — a própria tela de criação da chave já mostra o snippet pronto, com o token preenchido.

4

Confirme a conexão

Peça algo simples ao agente, como "quais cards estão em andamento?". Ele deve responder com dados reais do seu board.

Comandos por ferramenta

Adicionar o servidor

claude mcp add --transport http kanbix https://api.kanbix.com.br/mcp \
  --scope user \
  --header "Authorization: Bearer kbx_live_SEU_TOKEN"

O escopo user registra o servidor para todos os seus projetos. Se a sua chave cobre mais de um board, informe qual vale nesta configuração com o header X-Kanbix-Board (aceita o id ou o slug). Sem ele, vale o board padrão da chave.

Escolhendo o board

claude mcp add --transport http kanbix https://api.kanbix.com.br/mcp \
  --scope local \
  --header "Authorization: Bearer kbx_live_SEU_TOKEN" \
  --header "X-Kanbix-Board: meu-board-a1b2c3"

Para versionar a configuração no projeto sem expor o token, crie um .mcp.json na raiz e deixe o token vir do ambiente:

.mcp.json

{
  "mcpServers": {
    "kanbix": {
      "type": "http",
      "url": "https://api.kanbix.com.br/mcp",
      "headers": {
        "Authorization": "Bearer ${KANBIX_TOKEN}",
        "X-Kanbix-Board": "meu-board-a1b2c3"
      }
    }
  }
}
Informação
Informação
Informação