-MCP-Businessmap

# 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 ```bash npm install -g mcp-businessmap ``` ## Uso ### Como executável ```bash mcp-businessmap --transport=stdio --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY ``` ### Como servidor HTTP/SSE ```bash 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: ```bash npm install -g mcp-businessmap ``` 2. Inicie o MCP como um servidor HTTP/SSE: ```bash 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 ```bash git clone https://github.com/rlopes2-ops/-MCP-Businessmap.git cd -MCP-Businessmap ``` ### Instalar dependências ```bash npm install ``` ### Executar em modo de desenvolvimento ```bash npm run dev -- --transport=sse --port=8000 --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY ``` ### Compilar ```bash 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.