Boards por pasta

Se você trabalha em vários repositórios, não precisa configurar um servidor MCP por projeto. Configure um na máquina e deixe cada pasta dizer qual board ela usa.

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 é registrado uma vez, no escopo global do seu agente. Nenhum board está fixado nele.
3. Cada pasta de projeto ganha um .kanbix.json dizendo qual board vale ali. O arquivo não tem segredo nenhum — pode versionar.
4. Quando o agente roda naquela pasta, o servidor lê esse arquivo e informa o board na chamada. A API confere que ele está entre os autorizados na chave.

{
  "board": "meu-board-a1b2c3",
  "boardId": "cm...",
  "apiUrl": "https://api.kanbix.com.br"
}

O board é o slug (legível num diff de git) e o boardId é o id. Basta um dos dois; o CLI grava ambos. O arquivo é encontrado subindo dos diretórios — então funciona mesmo que o agente rode numa subpasta funda do projeto.

Não gasta uma chave por projeto

Ao rodar kanbix link num projeto novo, o CLI estende a chave que já existe naquela máquina para cobrir o board novo — em vez de criar outra. É o que evita bater no limite de chaves do plano quando você tem várias pastas. Você também pode adicionar um board a uma chave existente pela tela de Configurações → IA, na seção MCP.

Sem o CLI

Dá para fazer o mesmo à mão: informe o board no header X-Kanbix-Board (id ou slug) na configuração daquela pasta, ou use o servidor por stdio com a variável KANBIX_BOARD. Os dois caminhos estão em Conectar seu agente.