Kanbix

O jeito rápido: CLI kanbix

O CLI faz tudo por você: autentica no browser, registra o servidor MCP uma vez na máquina, cria a chave com os escopos certos e amarra um board a cada pasta de projeto — sem copiar token nenhum.

Informação

Uma vez por conta, uma por máquina, uma por pasta

npm i -g @kanbix/cli

kanbix login      # uma vez por conta — abre o browser
kanbix install    # uma vez por máquina — registra o servidor MCP

cd meu-projeto
kanbix link       # uma vez por pasta — escolhe o board dela

O kanbix install registra o servidor no escopo global do seu agente, então você não repete configuração de servidor por projeto. O kanbix link grava um .kanbix.json na pasta (sem segredo — pode versionar) dizendo qual board vale ali; o comando do servidor, kanbix mcp, descobre o board pela pasta em que roda. A chave fica guardada em ~/.config/kanbix — uma por máquina, cobrindo todos os boards que você linkou.

Informação

Manual: token na mão

Crie uma chave de API

Vá em Configurações de IA → aba MCP → Nova chave. Escolha o time e marque só os escopos que o agente realmente precisa.

Copie o token

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

Registre o servidor no seu agente

Use o comando da sua ferramenta abaixo. A própria tela já mostra o snippet pronto.

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 \
  --header "Authorization: Bearer kbx_live_SEU_TOKEN"

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 do board). Sem ele, vale o board padrão da chave.

Escolhendo o board

claude mcp add --transport http kanbix https://api.kanbix.com.br/mcp \
  --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, use a variável de 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