BlueFolder MCP by usefulapi

usefulapi 提供的 BlueFolder MCP

在 Claude、Cursor 或任何 MCP 客户端中使用你的 BlueFolder 账户。读取客户、设备、服务请求和合同，并添加服务请求和评论。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://bluefolder.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://bluefolder.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http bluefolder https://bluefolder.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "bluefolder": {
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 BlueFolder 凭据。

分步设置指南、凭据查找位置和常见问题解答：https://usefulapi.io/bluefolder/

首次连接时，你需要提供 BlueFolder API token（BlueFolder → Settings → API，在 Authorized API Users 表格中；API 访问需要 Premium 方案）。服务会验证该令牌，并按用户存储。配置文件中无需填写密钥。

工具

工具	类型	功能
bluefolder_list_customers	读取	列出客户
bluefolder_get_customer	读取	获取客户信息
bluefolder_list_service_requests	读取	列出服务请求
bluefolder_get_service_request	读取	获取服务请求
bluefolder_get_service_request_history	读取	获取服务请求历史记录
bluefolder_list_equipment	读取	列出设备
bluefolder_get_equipment	读取	获取设备信息
bluefolder_list_contracts	读取	列出合同
bluefolder_get_contract	读取	获取合同
bluefolder_list_items	读取	列出项目
bluefolder_get_item	读取	获取项目
bluefolder_list_users	读取	列出用户
bluefolder_get_user	读取	获取用户信息
bluefolder_list_tax_codes	读取	列出税码
bluefolder_add_service_request	写入	创建服务请求
bluefolder_add_service_request_comment	写入	添加服务请求评论
bluefolder_add_customer_comment	写入	添加客户评论
bluefolder_usage_status	元数据	使用情况（免费额度计量）
bluefolder_request_feature	元数据	申请添加缺失的功能
bluefolder_upgrade	元数据	升级到 Pro（不限量*）
bluefolder_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读工具；write 工具会修改数据（客户端应在执行前征求确认）；meta 工具用于报告使用情况、管理订阅或提交功能申请。

定价

方案	价格	限额
Free	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费使用 2 个月）	不限量*

*此服务上的 Pro 方案设有每月 10,000 次工具调用的合理使用限额。如需更多额度，请发送邮件至 [email protected]。

Pro 方案仅适用于此服务。使用 bluefolder_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 bluefolder_cancel_subscription 取消：Pro 会持续到已付费周期结束，当前周期不予退款；在此之前运行 bluefolder_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT——参见 LICENSE。仅提供文档；服务由托管方提供。