BoondManager MCP服务器
  ](https://www.npmjs.com/package/boondmanager-mcp-server) ](https://www.npmjs.com/package/boondmanager-mcp-server) ](https://nodejs.org/)   
BoondManager API的模型上下文协议(MCP)服务器,允许Claude(桌面、协同工作、代码)搜索、查看、创建和编辑BoondManager实例中的记录。
158工具 覆盖 36个领域 BoondManager API。看见 TOOLS.md 对于自动生成的目录(工具+提示+资源)。
所涵盖的领域
CRM与商业
| 域 | 工具 | 操作 |
|---|---|---|
| 候选人 | 10 | CRUD+信息、技术数据、管理、操作、定位 |
| 资源 | 15 | CRUD+信息、技术数据、管理、优势、行动、职位、项目、时间报告、费用报告、缺勤报告 |
| 联系人 | 11 | CRUD+信息、行动、机会、项目、订单、发票 |
| 社会 | 14 | CRUD+信息、联系人、行动、机会、项目、订单、发票、采购、供应商发票 |
| 机遇 | 10 | CRUD+信息、操作、定位、项目、模拟 |
项目规划
| 域 | 工具 | 操作 |
|---|---|---|
| 项目 | 12 | CRUD+信息、操作、模拟、交付分组、订单、采购、生产率 |
| 位置 | 4 | 搜索、获取、创建、删除 |
| 交付/CRA | 2 | 搜索,获取 |
| 采购/分包 | 4 | 搜索、获取、创建、删除 |
事实与金融
| 域 | 工具 | 操作 |
|---|---|---|
| Factures客户 | 5 | CRUD完成 |
| 供应商发票 | 2 | 搜索,获取 |
| 订单 | 5 | CRUD完成 |
| 付款 | 2 | 搜索,获取 |
| 注意事项 | 5 | CRUD完成 |
| 产品 | 5 | CRUD完成 |
人力资源与时间
| 域 | 工具 | 操作 |
|---|---|---|
| 缺席 | 5 | CRUD完成 |
| 计划缺席 | 1 | 搜索(vue globale) |
| 临时租约 | 3 | 搜索、获取、资源时间表 |
| 合同 | 2 | 获取,创建 |
| 优势 | 2 | 搜索,获取 |
活动监测
| 域 | 工具 | 操作 |
|---|---|---|
| 行动 | 4 | 搜索、获取、创建、删除 |
| 验证 | 2 | 搜索,获取 |
| 待办事项列表 | 2 | 搜索,获取 |
报告
| 域 | 工具 | 操作 |
|---|---|---|
| 报告协会 | 1 | 搜索 |
| 报告项目 | 1 | 搜索 |
| 报告资源 | 1 | 搜索 |
| 报告综合 | 1 | 搜索 |
| 报告停产计划 | 1 | 搜索 |
管理和配置
| 域 | 工具 | 操作 |
|---|---|---|
| 用户帐户 | 2 | 搜索,获取 |
| 机构 | 2 | 搜索,获取 |
| 业务部门 | 2 | 搜索,获取 |
| 波兰人 | 2 | 搜索,获取 |
| 角色 | 2 | 搜索,获取 |
| 日历 | 2 | 搜索,获取 |
| 旗帜/标签 | 2 | 搜索,获取 |
| 网络钩子 | 2 | 搜索,获取 |
| 审计日志 | 2 | 搜索,获取 |
| 通知 | 2 | 搜索,获取 |
| 讨论线程 | 2 | 搜索,获取 |
| 应用 | 2 | 字典,当前用户 |
按实体划分的选项卡详细信息
主要实体具有用于目标访问的选项卡专用工具:
| 实体 | 可用选项卡 |
|---|---|
| 候选人 | 信息、技术数据、行政、行动、职位 |
| 资源 | 信息、技术数据、管理、优势、行动、职位、项目、时间报告、费用报告、缺勤报告 |
| 联系人 | 信息、行动、机会、项目、订单、发票 |
| 社会 | 信息、联系人、行动、机会、项目、订单、发票、采购、供应商发票 |
| 机会 | 信息、行动、定位、项目、模拟 |
| 项目 | 信息、行动、模拟、交付分组、订单、采购、生产率 |
MCP资源(字典)
服务器将Reference Boond字典公开为 MCP资源 (支持显示的客户:Claude Desktop、MCP Inspector等)。允许模型翻译 state 哦 typeOf 整个诽谤,无需额外工具调用。
| URI | 目录 |
|---|---|
boond://application/current-user | 当前用户配置文件(ID、代理、权限) |
boond://dictionary/states/{entity} | 按实体分列的国家: resources, candidates, contacts, companies, opportunities, projects, invoices, orders, positionings, absences |
boond://dictionary/typeOf/{entity} | 实体类型: resources, candidates, contacts, projects, actions, absences |
boond://dictionary/countries 国家名单 | |
boond://dictionary/currencies | 货币列表 |
boond://dictionary/languages | 语言列表 |
对于此Curee列表之外的字典,该工具 boond_application_dictionary 仍然可用。
提示预先关闭
除了工具之外,服务器还公开 提示MCP (电缆前模板),用于以正确的顺序为递归工作流协调正确的工具调用。在支持提词的客户端中可见(Claude Desktop, 同事克劳德·科德,MCP检查员。…以斜杠命令或菜单的形式。
工作流程横向
| 提示 | 用法 |
|---|---|
synthese_equipe | 团队状态:谁做什么,谁不在,谁可用(默认情况下:我的团队)。 |
pipeline_commercial | 一段时间内关闭的机会:按州划分,CA Pondere,前10名。 |
factures_a_relancer | 逾期未付发票,按公司分组。 |
candidats_pour_opportunite | 从机会开始,提出合适的积极候选人(工具、专业知识、流动性、可用性)。 |
fiche_consultant | 资源的360视图:信息+技术+位置+缺勤+最近的CRA。 |
recap_hebdo | 每周回顾:移动的管道、缺席的团队、活跃的项目、要采取的行动。 |
资源、能力和简历
| 提示 | 用法 |
|---|---|
staffing_disponible | 在给定窗口中提供的内部顾问(按自由能力和周界可选筛选),按可用性排序,优先级为前3名。 |
fin_de_mission | 预计N天内任务结束(默认值60)。品牌EN 紧急 终端\ mon equipe) |
/fin_de_mission horizon_jours = 30
/cartographie_competences agency_id = 7 top_n = 15
/cvs_a_mettre_a_jour seuil_mois = 6
/recherche_profil_competences competences = .NET Azure DevOps experience_min = 5 ans dispo_avant = 2026-07-15 inclure_candidats = oui
> 修改配置后,Claude(`claude_desktop_config.json` 等等), **重新启动客户** :MCP提示列表未热重新加载。
## 先决条件
- Node.js>=20
- 具有活动访问API的BoondManager帐户
- L’option“Allow API Rest call using BasicAuth authentication”active dans la configuration BoondManager
## 安装
### 克劳德桌面(一键)
下载文件 `.mcpb` 自 然后在Claude桌面中: **文件>安装扩展名。。。** 并选择文件。标识符在安装时请求并以加密方式存储(macOS密钥链/Windows凭据管理器)。
### 克劳德代码
Avec un token API (recommande)
claude mcp add --transport stdio --env BOOND_API_TOKEN=votre_token_jwt \ boondmanager -- npx -y boondmanager-mcp-server
Avec BasicAuth
claude mcp add --transport stdio \ --env BOOND_USER=votre_login \ --env BOOND_PASSWORD=votre_mot_de_passe \ boondmanager -- npx -y boondmanager-mcp-server
> **视窗** :添加 `cmd /c` 前 `npx` :
>
> ```bash
> claude mcp add --transport stdio --env BOOND_API_TOKEN=votre_token \
> boondmanager -- cmd /c npx -y boondmanager-mcp-server
> ```
要使服务器在所有项目中可用,请添加 `--scope user` :
claude mcp add --transport stdio --scope user \ --env BOOND_API_TOKEN=votre_token_jwt \ boondmanager -- npx -y boondmanager-mcp-server
### Claude代码-团队共享配置
添加文件 `.mcp.json` 在项目的根目录中(在Git中提交):
{ "mcpServers": { "boondmanager": { "type": "stdio", "command": "npx", "args": ["-y", "boondmanager-mcp-server"], "env": { "BOOND_API_TOKEN": "${BOOND_API_TOKEN}" } } } }
每个团队成员只需定义环境变量 `BOOND_API_TOKEN` 在他的机器上。文件 `.mcp.json` 语法支持 `${VAR}` 和 `${VAR:-default}` 把环境变量倒出来。
### Claude Code企业(部署管理)
管理员可以通过文件为所有用户部署MCP服务器 `managed-mcp.json` :
|OS | Chemin|
|----|--------|
|macOS| `/Library/Application Support/ClaudeCode/managed-mcp.json` |
|Linux/WSL| `/etc/claude-code/managed-mcp.json` |
|窗户| `C:\Program Files\ClaudeCode\managed-mcp.json` |
{ "mcpServers": { "boondmanager": { "type": "stdio", "command": "npx", "args": ["-y", "boondmanager-mcp-server"], "env": { "BOOND_API_TOKEN": "${BOOND_API_TOKEN}", "BOOND_BASE_URL": "https://votre-instance.boondmanager.com/api" } } } }
此文件独占MCP服务器:用户不能添加或编辑此配置之外的服务器。
要限制允许的服务器,同时允许用户添加,请使用 `managed-settings.json` :
{ "allowedMcpServers": [ { "serverName": "boondmanager" } ] }
### 克劳德桌面/协作(配置手册)
在Claude配置文件中添加:
**macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
**视窗** : `%APPDATA%\Claude\claude_desktop_config.json`
{ "mcpServers": { "boondmanager": { "command": "npx", "args": ["-y", "boondmanager-mcp-server"], "env": { "BOOND_API_TOKEN": "votre_token_jwt" } } } }
### 通过npm
npx boondmanager-mcp-server
全球Ou安装:
npm install -g boondmanager-mcp-server boondmanager-mcp-server
### 来自来源
git clone https://github.com/fauguste/boondmanager-mcp-server.git cd boondmanager-mcp-server npm install npm run build
### 铁匠铺
服务器也可在 [铁匠铺](https://smithery.ai/server/@fauguste/boondmanager-mcp-server)La的结构如下 `smithery.yaml` 在repo的根目录中:Smithery提供了一个带有身份验证字段(JWT auto/JWT prebuild/basicauth)的UI,并通过以下方式安装服务器: `npx`.
### LobeChat/LobeHub
服务器列在 [MCP de LobeHub市场](https://lobehub.com/mcp/fauguste-boondmanager-mcp-server).在LobeChat(自托管或云)中,通过添加MCP **设置>插件>MCP>添加** 具有:
{ "name": "boondmanager", "command": "npx", "args": ["-y", "boondmanager-mcp-server"], "env": { "BOOND_USER_TOKEN": "", "BOOND_CLIENT_TOKEN": "", "BOOND_CLIENT_KEY": "" } }
或者使用HTTP传输(参见第节) [运输](#transports))用于网关模式下的共享部署。
## 配置
### 日志
服务器使用 [皮诺](https://getpino.io/) 对于JSON结构日志(聚合器、可观察性)。
变量|缺陷|描述|
|----------|--------|-------------|
| `LOG_LEVEL` | `info` |日志级别: `trace`, `debug`, `info`, `warn`, `error`, `fatal` |
| `LOG_FORMAT` |(自动)| `json` 对于纯JSON,否则在开发中使用pino pretty|
En生产(`NODE_ENV=production`),默认情况下,日志是JSON。在dev中,漂亮(彩色)格式处于活动状态,除非 `LOG_FORMAT=json`每个HTTP请求接收一个 `corrId` (8十六进制)在日志中跟踪请求。
### 认证
**选项1:代币API JWT(推荐)**
export BOOND_API_TOKEN="votre_token_jwt"
**选项2:BasicAuth**
export BOOND_USER="votre_login" export BOOND_PASSWORD="votre_mot_de_passe"
### URL个人信息(即实例数据)
export BOOND_BASE_URL="https://votre-instance.boondmanager.com/api"
默认情况下,URL为 `https://ui.boondmanager.com/api`.
### 延迟过期HTTP
对BoondManager API的每个请求在 **30秒** 默认情况下。对于慢速租户或大型报告,通过以下方式增加:
export BOOND_HTTP_TIMEOUT_MS=60000 # 60 s
如果请求超过延迟,服务器将返回一个显式错误 `BOOND_HTTP_TIMEOUT_MS` 而不是无限期地停留。
### 瞬态失败时的尝试
HTTP客户端自动保留错误 **瞬态** 具有指数回溯+抖动:
- **获取** :重试 `5xx`, `429`,网络错误(`ECONNRESET`等等)et超时(GET etant幂等)。
- **发布/放置/修补/删除** :重试 **只有在 `429`** 以避免复制服务器级写入。莱斯 `5xx` 网络错误会立即恢复。
- L'en-te `Retry-After` (以秒或HTTP日期为单位)是荣誉和上限 `BOOND_HTTP_RETRY_MAX_MS`.
|变量|定义|描述|
|----------|--------|-------------|
| `BOOND_HTTP_MAX_RETRIES` | `2` |额外尝试的最大次数(共3次尝试)。 `0` 完全禁用重试。|
| `BOOND_HTTP_RETRY_BASE_MS` | `200` |用于指数回溯的基本延迟(`base * 2^attempt`具有抖动)。|
| `BOOND_HTTP_RETRY_MAX_MS` | `5000` |两次尝试之间的延迟上限。|
### 借记限额(利率限制)
以防止打包的工具循环淹没API(并链接 `429`),客户贴花 **令牌桶** 当地。定义: **10个要求/秒** 支持, **拉法莱20** -在正常交互使用中不可见。Retentatives还消耗令牌。
|变量|定义|描述|
|----------|--------|-------------|
| `BOOND_HTTP_RATE_LIMIT_RPS` | `10` |支持借记(请求/秒)。 `0` 完全关闭。 |
| `BOOND_HTTP_RATE_LIMIT_BURST` | `20` |桶容量=最大即时突发大小。|
## 运输
服务器支持两种MCP传输,可通过环境变量选择 `MCP_TRANSPORT`.
|运输|价值|用例|
|-----------|--------|-------------|
| **标准** (default) `stdio` 或未定义|Claude桌面、Claude代码、本地集成|
| **可流式传输的HTTP** | `http` (别名: `streamable-http`)|网关MCP、远程部署、容器|
### 可流式HTTP(用于MCP网关)
从v1.4.0开始,服务器可以在HTTP(规范MCP可流HTTP 2025-03-26)中公开,以便分支到MCP网关或部署为服务。
export MCP_TRANSPORT=http export MCP_HTTP_HOST=0.0.0.0 # defaut: 127.0.0.1 export MCP_HTTP_PORT=3000 # defaut: 3000 export MCP_HTTP_PATH=/mcp # defaut: /mcp export MCP_HTTP_BEARER_TOKEN=xxx # optionnel: protege l'endpoint export BOOND_API_TOKEN=... # (credentials BoondManager, comme en stdio)
npx boondmanager-mcp-server
🚀 BoondManager MCP Server running (streamable HTTP transport)
📡 Endpoint: http://0.0.0.0:3000/mcp
🔑 Mode: stateless
**HTTP环境变量**
|变量|定义|描述|
|----------|--------|-------------|
| `MCP_TRANSPORT` | `stdio` | `http` 要启用HTTP传输|
| `MCP_HTTP_HOST` | `127.0.0.1` |接口d’ecoute(`0.0.0.0` 倾泄器)|
| `MCP_HTTP_PORT` | `3000` |端口TCP|
| `MCP_HTTP_PATH` | `/mcp` MCP端点的HTTP路径|
| `MCP_HTTP_STATEFUL` | `false` | `true` 要启用有状态模式(会话) `Mcp-Session-Id`) |
| `MCP_HTTP_BEARER_TOKEN` | _(参见)_ |如果定义,服务器需要 `Authorization: Bearer ` |
| `MCP_HTTP_JSON_RESPONSE` | `false` | `true` 强制JSON响应(无SSE)|
| `MCP_HTTP_SESSION_TTL_MS` | `1800000` (30分钟)|在有状态模式下,会话关闭的空闲时间。|
| `MCP_HTTP_SESSION_SWEEP_INTERVAL_MS` | `300000` (5分钟)|非活动会话的扫描频率。|
**无国籍(defaut)** :每个HTTP POST请求都是独立的,理想情况下适用于多路复用多个MCP服务器的网关。服务器端不保留任何会话。
**有状态的** :服务器生成一个 `Mcp-Session-Id` 在初始化时,客户端必须在每个后续请求中返回。适用于受益于SSE流和服务器通知的本地MCP客户端。
#### 示例:检查端点
curl -s -X POST http://localhost:3000/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": { "name": "curl", "version": "1.0" } } }'
#### 示例:通过HTTP的Claude代码
claude mcp add --transport http \ --header "Authorization: Bearer votre_token_local" \ boondmanager https://mcp.votre-domaine.com/mcp
#### 示例:配置 `.mcp.json` 超文本传输协议
{ "mcpServers": { "boondmanager": { "type": "http", "url": "https://mcp.votre-domaine.com/mcp", "headers": { "Authorization": "Bearer ${MCP_HTTP_BEARER_TOKEN}" } } } }
#### 示例:Docker(官方GHCR图像)
每个版本都会在GitHub容器注册表Multi-Arch上发布一个现成的Docker映像(`linux/amd64` + `linux/arm64`)的。默认情况下,它在接口上的端口3000上的HTTP传输中启动 `0.0.0.0`.
docker run --rm -p 3000:3000 \ -e MCP_HTTP_BEARER_TOKEN=$(openssl rand -hex 32) \ -e BOOND_API_TOKEN=$BOOND_API_TOKEN \ ghcr.io/fauguste/boondmanager-mcp-server:latest
标签disponibles: `:latest`, `:1`, `:1.5`, `:1.5.1` (建议Prod使用确切版本)。支持的环境变量:参见 [配置](#configuration) 和 [运输](#transports).
#### 示例:Docker(通过npx临时镜像)
如果您不喜欢使用ghcr映像,服务器可以在通用节点映像中运行:
docker run --rm -p 3000:3000 \ -e MCP_TRANSPORT=http \ -e MCP_HTTP_HOST=0.0.0.0 \ -e MCP_HTTP_BEARER_TOKEN=$(openssl rand -hex 32) \ -e BOOND_API_TOKEN=$BOOND_API_TOKEN \ node:22-alpine \ npx -y boondmanager-mcp-server
> **证券** :在HTTP中,BoondManager凭据保持在服务器端(容器环境变量)。只有MCP令牌(`MCP_HTTP_BEARER_TOKEN`)在客户端和服务器之间循环。在反向代理后面,添加TLS(https)并限制对网关的网络访问。
## 使用示例
配置后,您可以询问Claude:
**CRM与商业**
- *“在巴黎寻找具有React技能的候选人”*
- *“向我展示资源12345的技术细节”*
- *“在Acme公司创建新的Jean Dupont联系人”*
- *“列出所有当前机会”*
- *“机会20的定位是什么?”*
**项目规划**
- *“为42号公司创建阿尔法使命项目”*
- *“附33号项目规划”*
- *“55号项目的采购订单是什么?”*
- *“显示项目12的生产力”*
**事实与金融**
- *“搜索等待付款的发票”*
- *“列出100号公司的供应商发票”*
- *“显示项目55的购买情况”*
**人力资源与时间**
- *“显示2025年3月资源100的时间表”*
- *“列出本月计划的缺勤情况”*
- *“显示资源200的费用报表”*
- *“50号资源的好处是什么?”*
**活动监测**
- *“最近对789号候选人采取了哪些行动?”*
- *“注意验证”*
- *“列出我的Todolist任务”*
**报告**
- *“显示全局摘要报告”*
- *“什么是资源生产率报告?”*
**行政**
- *“恢复操作类型字典”*
- *“列出机构和业务单位”*
- *“显示已配置的webhook”*
## 建筑
boondmanager-mcp-server/ ├── src/ │ ├── index.ts # Point d'entree MCP (selection du transport) │ ├── server.ts # Factory createMcpServer() + liste des domaines │ ├── constants.ts # Configuration, API paths, onglets │ ├── types.ts # Types TypeScript (JSON:API) │ ├── transports/ │ │ └── http.ts # Transport Streamable HTTP (gateway/remote) │ ├── services/ │ │ └── boond-client.ts # Client HTTP API BoondManager │ ├── schemas/ │ │ └── index.ts # Schemas Zod (validation des entrees) │ └── tools/ │ ├── index.ts # Barrel export de tous les domaines │ ├── crud-factory.ts # Factory generique CRUD (DRY) │ ├── candidates.ts # 10 outils (CRUD + 5 onglets) │ ├── resources.ts # 15 outils (CRUD + 10 onglets) │ ├── contacts.ts # 11 outils (CRUD + 6 onglets) │ ├── companies.ts # 14 outils (CRUD + 9 onglets) │ ├── opportunities.ts # 10 outils (CRUD + 5 onglets) │ ├── projects.ts # 12 outils (CRUD + 7 onglets) │ ├── actions.ts # 4 outils │ ├── timesheets.ts # 3 outils │ ├── invoices.ts # 5 outils │ ├── orders.ts # 5 outils │ ├── deliveries.ts # 2 outils │ ├── absences.ts # 5 outils │ ├── expenses.ts # 5 outils │ ├── products.ts # 5 outils │ ├── positionings.ts # 4 outils │ ├── payments.ts # 2 outils │ ├── advantages.ts # 2 outils │ ├── contracts.ts # 2 outils │ ├── purchases.ts # 4 outils │ ├── provider-invoices.ts # 2 outils │ ├── accounts.ts # 2 outils │ ├── agencies.ts # 2 outils │ ├── business-units.ts # 2 outils │ ├── poles.ts # 2 outils │ ├── roles.ts # 2 outils │ ├── calendars.ts # 2 outils │ ├── flags.ts # 2 outils │ ├── webhooks.ts # 2 outils │ ├── logs.ts # 2 outils │ ├── notifications.ts # 2 outils │ ├── threads.ts # 2 outils │ ├── todolists.ts # 2 outils │ ├── validations.ts # 2 outils │ ├── reporting.ts # 5 outils │ ├── planning-absences.ts # 1 outil │ └── application.ts # 2 outils ├── dist/ # Build JavaScript ├── .github/ # CI/CD, templates, Dependabot ├── package.json ├── tsconfig.json ├── vitest.config.ts ├── eslint.config.js └── README.md
## 证券
- BoondManager凭证(JWT或Basicauth)从不通过MCP协议传输——它们仅配置为服务器端环境变量
- En模式 **标准**,服务器在本地运行,没有暴露的网络端口
- En模式 **可流式传输HTTP**,用保护端点 `MCP_HTTP_BEARER_TOKEN` +TLS(通过反向代理的HTTPS)并限制对网关的网络访问
- 符合ISO 27001要求
- BoondManager API托管在法国,符合GDPR
- BoondManager身份验证:JWT(推荐)、Basicauth或从组件自动构建的JWT
## 开发
Mode watch pour le developpement
npm run dev
Build
npm run build
Lancer le serveur
npm start
Tests
npm test # 255 tests npm run test:coverage # Avec couverture
Qualite
npm run lint npm run typecheck
### 堆叠技术
- **运行时** :Node.js>=20(ES2022)
- **语言** :TypeScript 5.8+(模式严格)
- **MCP-SDK** :@modelcontextprotocol/sdk 1.12+
- **验证** :Zod 4
- **测试** :速度4+V8盖
- **棉绒** :ESLint 10+打字ESLint
- **运输** :stdio(defaut)+流式HTTP(MCP 2025-03-26)
## 资源
- [API BoondManager文档](https://doc.boondmanager.com/api-externe/)
- [收藏邮差BoondManager](https://www.postman.com/boondmanager)
- [MCP规范](https://modelcontextprotocol.io/)
- [pyboondmanager(参考Python)](https://github.com/tominardi/pyboondmanager)
- [汽车发电机目录(TOOLS.md)](./TOOLS.md)
- [分销和市场(docs/Distribution.md)](./docs/distribution.md)
## 许可证
Apache许可证2.0-版权所有(c)2025弗雷德里克·奥古斯特
看见 [许可证](./LICENSE) 和 [通知](./NOTICE) 有关详细信息。