Usar com IA (MCP)
O servidor MCP deixa um programa de IA consultar e atualizar o Kanban em linguagem natural: “liste os cartões atrasados do quadro Instalação” ou “mova o cartão da Maria para Aprovado e comente que o contrato foi assinado”.
Ele é um arquivo que roda no seu computador, iniciado pelo próprio programa de IA, e traduz cada pedido em chamadas à API de integração. Não tem poder próprio: quadros, permissões, cartões privados, limites de uso e auditoria continuam sendo decididos pela chave.
Configurar
-
Gere uma chave
Em Configurações → Integrações → Kanban, escolha os quadros e as permissões que a IA poderá usar. Para consultas, uma chave só de leitura basta.
-
Instale o Node.js e baixe o servidor
Instale o Node.js 20 ou mais novo. Depois baixe o arquivo nextchat-kanban-mcp.mjs e guarde-o numa pasta fixa do computador, por exemplo
Documentos/NextChat. Ele já vem completo, sem instalar mais nada. -
Cole a configuração e reinicie o programa de IA
Troque
CAMINHO_DO_ARQUIVOpelo caminho completo do arquivo baixado, o endereço do seu NextChat e a chave gerada. No Windows, escreva cada barra invertida duas vezes no JSON (C:\\Users\\voce\\NextChat\\nextchat-kanban-mcp.mjs).
{
"mcpServers": {
"nextchat-kanban": {
"command": "node",
"args": ["CAMINHO_DO_ARQUIVO/nextchat-kanban-mcp.mjs"],
"env": {
"NEXTCHAT_URL": "https://app.nextchat.nextsistem.dev.br",
"NEXTCHAT_API_KEY": "SUA_CHAVE_API"
}
}
}
}claude mcp add nextchat-kanban \
--env NEXTCHAT_URL=https://app.nextchat.nextsistem.dev.br \
--env NEXTCHAT_API_KEY=SUA_CHAVE_API \
-- node CAMINHO_DO_ARQUIVO/nextchat-kanban-mcp.mjsNo Cursor, use o mesmo bloco mcpServers em ~/.cursor/mcp.json.
Estamos preparando o pacote @nextchat/kanban-mcp no npm. Quando ele sair, bastará trocar o comando por npx -y @nextchat/kanban-mcp, sem baixar arquivo. Até lá, use o arquivo acima.
| Variável | Obrigatória | Descrição |
|---|---|---|
NEXTCHAT_URL | Sim | Endereço do seu NextChat. Precisa ser https (http só em localhost). |
NEXTCHAT_API_KEY | Sim | Chave gerada em Configurações → Integrações → Kanban. |
Ferramentas
A IA só consegue usar as ferramentas que a chave permite.
| Ferramenta | Permissão da chave | O que faz |
|---|---|---|
kanban_quem_sou_eu | read | Mostra nome, permissões, quadros e validade da chave. |
kanban_listar_quadros | read | Lista os quadros liberados e suas etapas. |
kanban_ver_quadro | read | Mostra um quadro com a contagem de cartões por etapa. |
kanban_buscar_cartoes | read | Busca por texto, prioridade, etiqueta, prazo ou situação, com paginação. |
kanban_ver_cartao | read | Traz o cartão completo, com checklist. |
kanban_criar_cartao | create | Cria um cartão com etapa, prioridade, prazo, etiquetas e checklist. |
kanban_editar_cartao | update | Altera título, descrição, prioridade, prazo ou etiquetas. |
kanban_mover_cartao | move | Muda o cartão de etapa ou reordena. |
kanban_comentar | comments:write | Adiciona um comentário. |
kanban_checklist_adicionar | checklist:write | Adiciona um item à checklist. |
kanban_checklist_atualizar | checklist:write | Marca, desmarca ou edita um item. |
Comportamento que vale saber
- Versão do cartão: editar e mover exigem a versão atual. Se a IA não informar, o servidor consulta antes. Se o cartão mudou no meio do caminho, a API responde conflito e a IA consulta de novo.
- Repetições: cada criação, comentário ou item de checklist usa uma chave de idempotência nova. Pedir a mesma coisa duas vezes gera dois registros.
- Erros em português: chave expirada ou revogada, falta de permissão, limite de uso e conflito voltam à IA com orientação. A chave nunca aparece nas mensagens.
- Privacidade: como na API, nada de mensagens, anexos, contatos, telefones ou valores, e cartões privados ficam de fora.
A chave fica só no seu computador, na configuração do programa de IA. Dê apenas os quadros e as permissões necessários e, para parar o acesso, revogue a chave em Configurações → Integrações → Kanban. O servidor recusa http fora de localhost e não segue redirecionamentos, então a chave não segue para outro endereço.