MCP-Businessmap

MCP Server para o Businessmap (Kanbanize), permitindo buscar, visualizar e gerenciar quadros e cartões.

Ferramentas

O MCP-Businessmap fornece as seguintes ferramentas para interação com o Businessmap:

1. businessmap_search: Busca por cartões no Businessmap.

   • Parâmetros obrigatórios:
     • query: Texto para buscar
   • Parâmetros opcionais:
     • board_ids: Lista de IDs de quadros (separados por vírgula)
     • max_results: Número máximo de resultados

2. businessmap_get_card: Obtém detalhes de um cartão específico.

   • Parâmetros obrigatórios:
     • card_id: ID do cartão

3. businessmap_create_card: Cria um novo cartão.

   • Parâmetros obrigatórios:
     • board_id: ID do quadro
     • workflow_id: ID do workflow
     • lane_id: ID da lane
     • column_id: ID da coluna
     • title: Título do cartão
   • Parâmetros opcionais:
     • description: Descrição do cartão
     • priority: Prioridade do cartão
     • assignee_ids: IDs dos responsáveis (separados por vírgula)

4. businessmap_update_card: Atualiza um cartão existente.

   • Parâmetros obrigatórios:
     • card_id: ID do cartão
   • Parâmetros opcionais:
     • title: Novo título
     • description: Nova descrição
     • column_id: Nova coluna
     • lane_id: Nova lane
     • priority: Nova prioridade
     • assignee_ids: Novos responsáveis (separados por vírgula)

5. businessmap_delete_card: Remove um cartão.

   • Parâmetros obrigatórios:
     • card_id: ID do cartão

6. businessmap_add_comment: Adiciona um comentário a um cartão.

   • Parâmetros obrigatórios:
     • card_id: ID do cartão
     • text: Texto do comentário

Requisitos

• Node.js 14+
• Acesso a uma instância do Businessmap/Kanbanize
• API key do Businessmap

Instalação

npm install -g mcp-businessmap

Uso

Como executável

mcp-businessmap --transport=stdio --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY

Como servidor HTTP/SSE

mcp-businessmap --transport=sse --port=8000 --host=0.0.0.0 --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY

Opções

• --transport: Protocolo de transporte (stdio ou sse). Padrão: stdio
• --port: Porta para o servidor HTTP (apenas para o transporte sse). Padrão: 8000
• --host: Host para o servidor HTTP (apenas para o transporte sse). Padrão: 0.0.0.0
• --businessmap-url: URL da sua instância do Businessmap.
• --businessmap-apikey: Chave de API do Businessmap.
• --businessmap-boards-filter: Lista de IDs de quadros para filtrar (separados por vírgula).
• --read-only: Modo somente leitura (desativa operações de escrita). Padrão: false
• --businessmap-ssl-verify: Verificar certificados SSL. Padrão: true
• --verbose: Logs detalhados. Padrão: false

Variáveis de ambiente

Em vez de passar argumentos na linha de comando, você pode usar variáveis de ambiente:

• BUSINESSMAP_URL: URL da sua instância do Businessmap.
• BUSINESSMAP_APIKEY: Chave de API do Businessmap.
• BUSINESSMAP_BOARDS_FILTER: Lista de IDs de quadros para filtrar (separados por vírgula).
• READ_ONLY_MODE: Modo somente leitura (true ou false).

Uso com n8n

Para usar o MCP-Businessmap com o n8n:

1. Instale o pacote mcp-businessmap globalmente no servidor onde o n8n está rodando:

   npm install -g mcp-businessmap

2. Inicie o MCP como um servidor HTTP/SSE:

   mcp-businessmap --transport=sse --port=8001 --host=0.0.0.0 --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY --verbose

3. No n8n, adicione uma nova credencial:

   • Tipo: MCP Client (MCP Server)
   • SSE URL: http://your-server-ip:8001/sse
   • Messages Post Endpoint: http://your-server-ip:8001/json-rpc

4. Agora você pode usar o nó MCP nos seus workflows para interagir com o Businessmap.

Melhorias para compatibilidade com n8n

Versão 1.1.5 traz as seguintes melhorias para compatibilidade com n8n:

• Suporte completo a CORS para evitar problemas de conexão
• Escuta em todas as interfaces de rede por padrão
• Implementação SSE mais robusta com heartbeat a cada 30 segundos
• Logs detalhados para ajudar no diagnóstico de problemas
• Endpoint de verificação de saúde para monitoramento
• Tratamento de erros aprimorado
• Correção de problemas de compatibilidade com Docker e ambientes isolados

Desenvolvimento

Clonar o repositório

git clone https://github.com/rlopes2-ops/-MCP-Businessmap.git
cd -MCP-Businessmap

Instalar dependências

npm install

Executar em modo de desenvolvimento

npm run dev -- --transport=sse --port=8000 --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY

Compilar

npm run build

Licença

MIT

Disclaimer

Businessmap e Kanbanize são marcas registradas de seus respectivos proprietários. Este projeto não está relacionado oficialmente à Kanbanize ou suas subsidiárias.