Usar com IA (MCP)

O servidor MCP deixa um programa de IA usar o NextChat em linguagem natural: “quais conversas estão sem responsável?”, “mande para a Maria que a guia dela está pronta”, “quantos atendimentos o setor Fiscal finalizou esta semana?” 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. Não tem poder próprio: permissões, quadros, cartões privados, limites de uso e auditoria continuam sendo decididos pela chave.

Configurar

1. Gere uma chave

   Em Configurações → Integrações → Gerenciar API, escolha as permissões (e, para o Kanban, os quadros) que a IA poderá usar. Para consultas, uma chave só de leitura basta.

2. 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.

3. Cole a configuração e reinicie o programa de IA

   Troque CAMINHO_DO_ARQUIVO pelo 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": {
      "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 \
  --env NEXTCHAT_URL=https://app.nextchat.nextsistem.dev.br \
  --env NEXTCHAT_API_KEY=SUA_CHAVE_API \
  -- node CAMINHO_DO_ARQUIVO/nextchat-kanban-mcp.mjs

No Cursor, use o mesmo bloco mcpServers em ~/.cursor/mcp.json.

Ferramentas

A IA só consegue usar as ferramentas que a chave permite. Sem a permissão, o servidor responde e a IA explica o que falta.

Atendimento

Kanban

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.
• Nomes no lugar de ids: onde a ferramenta pede quadro ou etapa, vale o nome exato (ex.: “Desenvolvimento”, “Em desenvolvimento”); o servidor resolve e avisa se houver mais de um.
• Chave em arquivo: em vez de NEXTCHAT_API_KEY, use NEXTCHAT_API_KEY_FILE com o caminho de um arquivo que contenha a chave, para não deixá-la em texto puro na configuração.
• Privacidade: a IA vê só o que a chave permite. Nas ferramentas do Kanban não aparecem mensagens, contatos, telefones nem valores, e cartões privados ficam de fora. Anexos aparecem com link temporário.