What is Mcp Businessmap

MCP-Businessmap is a server designed for Businessmap (Kanbanize) that allows users to search, view, and manage boards and cards effectively.

Use cases

Use cases include managing project tasks, tracking progress in agile teams, collaborating on workflows, and organizing tasks visually on Kanban boards.

How to use

To use MCP-Businessmap, install it via npm with ‘npm install -g mcp-businessmap’, then execute it with the command line, providing the necessary parameters for interaction with your Businessmap instance.

Key features

Key features include searching for cards, retrieving card details, creating new cards, updating existing cards, deleting cards, and adding comments to cards.

Where to use

MCP-Businessmap can be used in project management, task tracking, and workflow optimization across various industries that utilize Kanban methodologies.

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.