Ascora MCP by usefulapi

usefulapi 的 Ascora MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Ascora 账户。读取客户、报价、工作、预约、员工和价格清单，并执行带标签的写入操作，例如创建报价、工作和预约。托管服务，无需本地安装：使用你自己的凭据连接。

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

连接

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

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

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

分步设置说明、凭据查找方式和常见问题：https://usefulapi.io/ascora/

首次连接时，你需要提供 Ascora API key（Administration → API Settings → Generate New API Key）。服务会验证该密钥，并按用户分别存储。配置文件中无需放置任何密钥。

工具

工具	类型	功能
ascora_list_customers	读取	列出客户
ascora_get_customer	读取	获取客户
ascora_list_contacts	读取	列出联系人
ascora_list_customer_contacts	读取	列出客户的联系人
ascora_list_supplies	读取	列出用品（价格清单）
ascora_list_kits	读取	列出套件
ascora_list_categories	读取	列出库存类别
ascora_list_labour_roles	读取	列出劳务角色
ascora_list_quotes	读取	列出报价
ascora_get_quote	读取	获取报价
ascora_list_jobs	读取	列出工作
ascora_get_job	读取	获取工作
ascora_get_job_labour	读取	获取工作劳务信息
ascora_get_job_timesheets	读取	获取工作工时表
ascora_list_bookings	读取	列出预约（排期）
ascora_get_booking	读取	获取预约
ascora_list_activity_types	读取	列出活动类型
ascora_list_users	读取	列出员工用户
ascora_list_suppliers	读取	列出供应商
ascora_list_supplier_invoices	读取	列出供应商发票
ascora_create_enquiry	写入	创建咨询（潜在客户）
ascora_create_customer	写入	创建客户
ascora_add_note	写入	添加备注
ascora_create_quote	写入	创建报价
ascora_update_quote_status	写入	更新报价状态
ascora_convert_quote_to_job	写入	将报价转换为工作
ascora_create_job	写入	创建工作
ascora_create_booking	写入	创建预约
ascora_usage_status	元数据	使用状态（免费层级用量计量）
ascora_request_feature	元数据	请求添加缺失功能
ascora_upgrade	元数据	升级到 Pro 或 Pro+
ascora_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先确认）；meta 工具用于报告用量、管理订阅或发送功能请求。

定价

套餐	价格	限额
免费版	$0	每月 50 次工具调用
专业版（按用户计费）	$9/mo 或 $90/yr（免费赠送 2 个月）	不限量*

*此服务的专业版公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

专业版仅涵盖此服务。使用 ascora_upgrade 订阅（它会返回 Stripe Checkout 链接）。随时可使用 ascora_cancel_subscription 取消：专业版会持续到已付费周期结束，当前周期不予退款；在此之前运行 ascora_upgrade 即可撤销取消。也可以发送邮件至 [email protected]。

许可证

MIT — 请参阅 LICENSE。仅提供文档；服务托管于云端。