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:

• 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

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

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

• 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)

• 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)

• businessmap_delete_card: Remove um cartão.

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

• 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:

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

  npm install -g mcp-businessmap
  

• 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
  

• 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

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