BlueFolder MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.3.4更新于 Nov 7, 2026

Read customers, equipment and service requests; add service requests and comments in BlueFolder.

发布方自己的服务：Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

托管型 MCP 服务器，让助手读取 BlueFolder 的客户、服务请求、设备与合同，并可新建工单和添加评论。

可以做什么
  • 列出并获取客户及其联系人和地点
  • 列出并获取服务请求，含明细、人工、材料、派工与计费合计，以及历史与评论
  • 列出并获取设备、服务合同、目录项目、用户和税码
  • 新建服务请求，并为服务请求或客户添加评论
  • 查看当月用量、提交功能请求、升级或取消订阅
适用场景
适合已在使用 BlueFolder 的现场服务团队：用自然语言查询未结工单、客户设备及保养到期时间，或让助手在不打开 BlueFolder 界面的情况下登记新服务请求和评论。
运行要求
通过 streamable HTTP 连接的远程端点，无需本地安装。登录使用 OAuth，登录页要求填写 BlueFolder API 令牌（BlueFolder 设置中的 API；API 访问需 BlueFolder Premium 套餐）。令牌由服务按用户保存，客户端配置中不填密钥。需要网络访问。
安装前请注意
BlueFolder API 令牌需在托管登录页输入并由第三方保存，服务方因此可操作你的 BlueFolder 账户。有三个写入工具：新建服务请求和添加评论；公开评论且 notifyCustomer 为 true 时会向客户发送邮件，新建请求在 notifyCustomer 为 true 时也可能通知客户。用量按次计费：免费版每月 50 次调用，付费版需通过 Stripe 结账链接付费，取消后当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BlueFolder MCP by usefulapi，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fbluefolder/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "bluefolder-by-usefulapi": {
      "type": "http",
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}

README

BlueFolder MCP by usefulapi

Use your BlueFolder account from Claude, Cursor, or any MCP client. Read customers, equipment, service requests and contracts, and add service requests and comments. Hosted, no local install: connect with your own credentials.

Live endpoint: https://bluefolder.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://bluefolder.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http bluefolder https://bluefolder.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "bluefolder": {      "url": "https://bluefolder.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your BlueFolder credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bluefolder/

On first connect you provide your BlueFolder API token (BlueFolder → Settings → API, in the Authorized API Users table; API access needs a Premium plan). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
bluefolder_list_customersreadList customers
bluefolder_get_customerreadGet a customer
bluefolder_list_service_requestsreadList service requests
bluefolder_get_service_requestreadGet a service request
bluefolder_get_service_request_historyreadGet service request history
bluefolder_list_equipmentreadList equipment
bluefolder_get_equipmentreadGet equipment
bluefolder_list_contractsreadList contracts
bluefolder_get_contractreadGet a contract
bluefolder_list_itemsreadList items
bluefolder_get_itemreadGet an item
bluefolder_list_usersreadList users
bluefolder_get_userreadGet a user
bluefolder_list_tax_codesreadList tax codes
bluefolder_add_service_requestwriteCreate a service request
bluefolder_add_service_request_commentwriteAdd a service request comment
bluefolder_add_customer_commentwriteAdd a customer comment
bluefolder_usage_statusmetaUsage status (free-tier meter)
bluefolder_request_featuremetaRequest a missing feature
bluefolder_upgrademetaUpgrade to Pro or Pro+
bluefolder_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with bluefolder_upgrade (it returns a Stripe Checkout link). Cancel any time with bluefolder_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running bluefolder_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源：servers/bluefolder/README.md，提交 4046075

工具

17

bluefolder_list_customers

List customers

List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.

输入参数listType

bluefolder_get_customer

Get a customer

Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.

输入参数customerIdexternalId

bluefolder_list_service_requests

List service requests

List service requests (jobs), optionally filtered by customer, status, billing status, invoice or reference number, or a created/closed date range. Use status 'open' for all non-closed requests. BlueFolder API: POST /serviceRequests/list.aspx.

输入参数statusendDatelistTypedateFieldinvoiceNostartDatecustomerIdreferenceNocustomerNamebillingStatuscustomerNameExactMatch

bluefolder_get_service_request

Get a service request

Get one service request with its items, labor, materials, expenses, assignments and billing totals. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/get.aspx.

输入参数externalIdgroupItemsByTypeserviceRequestId

bluefolder_get_service_request_history

Get service request history

Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.

输入参数externalIdserviceRequestId

bluefolder_list_equipment

List equipment

List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.

输入参数listTypecustomerIdcustomerExternalId

bluefolder_get_equipment

Get equipment

Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.

输入参数equipmentId必填

bluefolder_list_contracts

List contracts

List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.

输入参数statuslistTypecustomerIdcustomerName

bluefolder_get_contract

Get a contract

Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.

输入参数contractId必填

bluefolder_list_items

List items

List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.

输入参数listType

bluefolder_get_item

Get an item

Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.

输入参数itemId必填

bluefolder_list_users

List users

List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.

输入参数listType

bluefolder_get_user

Get a user

Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.

输入参数userId必填

bluefolder_list_tax_codes

List tax codes

List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.

无需输入参数。

bluefolder_add_service_request

Create a service request

Create a new service request (job) for a customer. It sends no customer email unless notifyCustomer is true. BlueFolder API: POST /serviceRequests/add.aspx.

输入参数dueDatebillableprioritycustomerId必填externalIddescription必填referenceNonotifyCustomerpurchaseOrderNocustomerContactIdcustomerLocationIddetailedDescription

bluefolder_add_service_request_comment

Add a service request comment

Add a comment to a service request. A public comment with notifyCustomer true emails the customer. BlueFolder API: POST /serviceRequests/addComment.aspx.

输入参数userIdcomment必填notifyCustomercommentIsPublicserviceRequestId必填

bluefolder_add_customer_comment

Add a customer comment

Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.

输入参数userIdcomment必填customerId必填

版本历史

7
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成

Ably MCP by usefulapi

io.usefulapi官方发布者

面向 Ably 实时消息的托管 MCP 服务器：查看频道历史、在线状态与占用情况，发布消息，并查看应用用量与配置。

Streamable HTTP可网页运行
云端与基础设施15 个工具Nov 7, 2026

Woffu MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手查询 Woffu 公司的用户、劳动合同、部门和办公地点。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapi官方发布者

面向 White Label Loyalty 的托管 MCP 服务器：浏览奖励、查看客户积分钱包与等级进度，并用积分购买奖励。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

Weekdone MCP by usefulapi

io.usefulapi官方发布者

托管的 Weekdone 连接器，让助手读取周报、团队、目标与 KPI，并新增报告条目、评论和 KPI 数值。

Streamable HTTP可网页运行
数据与分析15 个工具Nov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手列出 WebinarKit 的网络研讨会、场次时间、系列、会议以及白标子账户。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026