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/mcpCrie 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.
Copie o token
O token (kbx_live_…) aparece uma única vez. Guarde-o com segurança: ele não é recuperável depois.
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.
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"
}
}
}
}