
Model Context Protocol server for BusinessMap (Kanbanize) integration
概览
Model Context Protocol (MCP) server for BusinessMap/Kanbanize. It gives AI clients access to BusinessMap workspaces, boards, cards, users, custom fields, workflow cycle-time data, resources, and guided prompts. - 27 agent-oriented MCP tools by default, with a 93-tool full profile for advanced operations - 6 MCP resources for direct workspace, board, and paginated card reads - 4 guided prompts for board analysis, reporting, card creation, and workspace summaries - Optional read-only mode for safer exploration - stdio transport for local MCP clients and HTTP transport for remote usage - Docker, structured logging, and programmatic middleware support The server requires Node.js 22 or newer. Set these environment variables in your MCP client, shell, deployment platform, or local .
README
以下为原文 README 节选,完整内容请查看原文。
BusinessMap MCP Server
Model Context Protocol (MCP) server for BusinessMap/Kanbanize. It gives AI clients access to BusinessMap workspaces, boards, cards, users, custom fields, workflow cycle-time data, resources, and guided prompts.
What You Get
- 27 agent-oriented MCP tools by default, with a 93-tool full profile for advanced operations
- 6 MCP resources for direct workspace, board, and paginated card reads
- 4 guided prompts for board analysis, reporting, card creation, and workspace summaries
- Optional read-only mode for safer exploration
stdiotransport for local MCP clients and HTTP transport for remote usage- Docker, structured logging, and programmatic middleware support
See the full catalog in docs/TOOLS.md.
Quick Start
Run directly with npx:
npx -y @edicarlos.lds/businessmap-mcp
Or install globally:
npm install -g @edicarlos.lds/businessmap-mcp
businessmap-mcp
The server requires Node.js 22 or newer.
Required Configuration
Set these environment variables in your MCP client, shell, deployment platform, or local .env file:
BUSINESSMAP_API_TOKEN=your_token_here
BUSINESSMAP_API_URL=https://your-account.kanbanize.com/api/v2
Optional settings:
| Variable | Default | Description |
|---|---|---|
BUSINESSMAP_READ_ONLY_MODE |
false |
Use true to register only read-only tools. |
BUSINESSMAP_DEFAULT_WORKSPACE_ID |
unset | Default workspace ID for tools that can use one. |
安装
npx -y @edicarlos.lds/businessmap-mcp配置
{
"mcpServers": {
"businessmap": {
"command": "npx",
"args": ["-y", "@edicarlos.lds/businessmap-mcp"],
"env": {
"BUSINESSMAP_API_TOKEN": "your_token_here",
"BUSINESSMAP_API_URL": "https://your-account.kanbanize.com/api/v2"
}
}
}
}