Boards por pasta

Uma chave e uma URL para todos os seus projetos

Atualizado em 2026-09-17

Se você trabalha em vários repositórios, não precisa de uma chave por projeto nem de um servidor diferente por board. A URL é sempre a mesma; o que muda é qual board aquela configuração informa.

Como funciona

  1. A sua chave de API cobre um conjunto de boards — você marca quais ao criá-la (ou adiciona depois, sem reemitir a chave).
  2. O servidor MCP é o mesmo endereço para todos: https://api.kanbix.com.br/mcp.
  3. A configuração daquele projeto manda o header X-Kanbix-Board com o id ou o slug do board.
  4. A API confere que o board pedido está entre os autorizados na chave. Fora do conjunto, 403 — e nunca outro tenant.
Informação

Onde mora a configuração de cada pasta

  • Claude Code: um .mcp.json na raiz do projeto (ou claude mcp add --scope local). O arquivo pode ser versionado se o token vier de ${KANBIX_TOKEN}.
  • OpenCode: um opencode.json na raiz do projeto — o global fica em ~/.config/opencode/opencode.json.
  • Codex CLI: o config é único e global, então crie uma entrada por board em ~/.codex/config.toml ([mcp_servers.kanbix-meu-board]) com o header em http_headers.

Os snippets prontos de cada ferramenta estão em Conectar seu agente — e também na tela do board (Configurações do time → MCP), já com o identificador dele preenchido.

Não gasta uma chave por projeto

Para cobrir um board novo, adicione-o a uma chave que já existe em Configurações → IA → MCP (o botão + board ao lado da chave). Ela passa a valer nos dois — e você não bate no limite de chaves do plano por ter muitas pastas.

Informação
Informação