Oblio MCP by usefulapi

usefulapi 的 Oblio MCP

通过 Claude、Cursor 或任何 MCP 客户端使用 Oblio：公司、增值税税率、系列、客户、产品、库存、带 e-Factura（SPV）状态和 Webhook 的发票，以及创建形式发票、开具、收款、取消和恢复发票，并将其发送至 SPV（每项财务写入操作都需要明确确认）。 托管服务，无需本地安装：使用你自己的 Oblio 凭据连接。

实时端点： https://oblio.usefulapi.io/mcp · 主页： https://usefulapi.io/oblio

连接

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

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

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

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

工具

工具	类型	功能
oblio_list_companies	读取	列出公司
oblio_list_vat_rates	读取	列出增值税税率
oblio_list_series	读取	列出单据系列
oblio_list_languages	读取	列出单据语言
oblio_list_management	读取	列出库存管理项
oblio_list_clients	读取	列出或搜索客户
oblio_list_products	读取	列出或搜索产品
oblio_get_document	读取	获取单据
oblio_list_invoices	读取	列出发票
oblio_list_webhooks	读取	列出 Webhook
oblio_create_proforma	写入	创建形式发票
oblio_issue_invoice	写入	开具发票（财务操作，不可撤销）
oblio_collect_invoice	写入	记录发票收款
oblio_cancel_document	写入	取消单据（财务操作）
oblio_restore_document	写入	恢复已取消的单据（财务操作）
oblio_send_einvoice_to_spv	写入	将发票发送至 e-Factura（SPV）
oblio_create_webhook	写入	创建 Webhook
oblio_delete_webhook	写入	删除 Webhook
oblio_usage_status	元数据	使用情况状态（免费套餐用量计数）
oblio_request_feature	元数据	申请添加缺失功能
oblio_upgrade	元数据	升级到 Pro（无限使用）
oblio_cancel_subscription	元数据	取消 Pro 订阅

read 工具仅供读取；write 工具会修改数据（客户端应要求确认）；meta 工具用于报告使用情况、管理订阅或发送功能申请。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（每位用户）	$9/月 或 $90/年（免费 2 个月）	无限使用

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

许可证

MIT © usefulapi。与 Oblio 无关联，也未获其认可。