Simplicate MCP

简化版MCP服务器（xmcp HTTP）

快速入门

1. 安装依赖项

npm install

1. 设置环境变量（本地）

• 创建一个 .env.local 与以下文件一起：

- SIMPLICATE_API_BASE_URL=https://act.simplicate.com/api/v2

• SIMPLICATE_API_SECRET=...

1. 在本地运行

npm run dev

部署到Vercel（完全远程）

1. 安装 Vercel CLI

npm i -g vercel

1. 部署

vercel

1. 在 Vercel 项目 → 设置 → 环境变量 中，添加：

• SIMPLICATE_API_BASE_URL=https://act.simplicate.com/api/v2
• SIMPLICATE_API_SECRET=...

1. 重新部署并使用生产环境URL `https://

.vercel.app` 在全球范围内。

工具

• 时间： list-hours， get-hour-by-id， create-hour-entry
• CRM：客户关系管理 list-organizations， list-contacts
• 项目： list-projects， list-activities， get-project， get-activity， list-project-phases， list-project-tasks， list-project-budgets
• 人力资源管理（HRM）: list-employees
• 信息： calendar-status
• 分析： estimate-builder， historic-estimation-helper， skill-demand-forecast， total-project-hours， total-employee-hours， pending-approval-hours， project-hours-vs-budget， project-overview， project-risk-summary， organization-summary， employee-profile， hours-by-month， resource-capacity-check

在运行时传递API凭据

• 客户端可以通过以下方式包含其Simplicate API密钥： Authentication-Key 在头部中指定以覆盖默认密钥；否则服务器将使用 SIMPLICATE_API_KEY。

参考文献

• XMCP文档： xmcp.dev（该域名本身无直接中文翻译，但可表述为“xmcp的开发或实验性域名”）
• Vercel Node 运行时： 文档

简化版_mcp

服务器令牌认证（推荐）

• 通过环境变量设置服务器范围的令牌：

- MCP_SERVER_TOKEN=...

• 对于HTTP请求，服务器要求 MCP_SERVER_TOKEN 以及一个相匹配的 x-mcp-token 头球 缺少配置会导致500错误；缺少/不匹配的头部信息会导致401错误。
• 对于本地stdio传输，不需要令牌。

示例HTTP请求头：

GET /tools/hours/list-hours HTTP/1.1
Host: 
Authorization: Bearer 
x-mcp-token: 

简化API密钥处理

• 默认键：配置 SIMPLICATE_API_KEY （建议用于服务器端）。
• 按请求覆盖的头部 Authentication-Key 默认情况下已禁用。要启用，请设置：

- ALLOW_KEY_OVERRIDE=true

• 当禁用覆盖且没有 SIMPLICATE_API_KEY 如果配置不当，请求将会失败。

错误编辑（或错误修正）

• 错误体对常见的PII/秘密字段进行遮蔽（例如。， email， phone， iban， token， secret， authentication-key）。