关于 billey MCP by usefulapi
billey MCP by usefulapi 将 billey 记账账户接入 MCP 客户端,提供客户、发票、支出、银行交易和工时记录等数据。该托管服务通过 OAuth 登录,并使用 billey 个人访问令牌。
主要功能
- 01读取客户、发票和报价
- 02读取支出和银行交易
- 03读取供应商、产品和项目
- 04查询工时记录
- 05托管访问并按用户保存凭据
适用场景
- 01查看客户和发票记录
- 02检查支出与银行交易
- 03通过 MCP 客户端核对项目工时
MCP 相关
通过托管端点向 MCP 客户端提供 billey 数据读取工具。用户首次连接时通过 OAuth 登录并提供 billey 个人访问令牌。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://billey.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-billey https://billey.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-billey":{"type":"http","url":"https://billey.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-billey":{"type":"http","url":"https://billey.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-billey":{"type":"http","url":"https://billey.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-billey":{"serverUrl":"https://billey.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 推出的 billey MCP
通过 Claude、Cursor 或任意 MCP 客户端使用你的 billey 账户。读取账簿中的客户、发票、报价、支出、银行交易和工时记录。托管服务,无需本地安装:使用你自己的凭据连接。
在线端点: https://billey.usefulapi.io/mcp · 主页: https://usefulapi.io
连接
- Claude(claude.ai、Desktop):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://billey.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http billey https://billey.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"billey": {
"url": "https://billey.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 billey 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/billey/
首次连接时,你需要提供 billey 个人访问令牌(在账簿的“设置 → API 令牌”中获取;必须启用双重身份验证)。服务会验证令牌并按用户存储。无需将密钥写入配置文件。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
billey_list_clients | 读取 | 列出客户 |
billey_get_client | 读取 | 获取客户信息 |
billey_list_invoices | 读取 | 列出发票 |
billey_get_invoice | 读取 | 获取发票 |
billey_list_quotes | 读取 | 列出报价 |
billey_list_expenses | 读取 | 列出支出 |
billey_list_vendors | 读取 | 列出供应商 |
billey_list_bank_transactions | 读取 | 列出银行交易 |
billey_list_products | 读取 | 列出产品 |
billey_list_projects | 读取 | 列出项目 |
billey_list_time_entries | 读取 | 列出工时记录 |
billey_usage_status | 元数据 | 使用情况(免费套餐用量) |
billey_request_feature | 元数据 | 申请添加缺失功能 |
billey_upgrade | 元数据 | 升级到 Pro(不限量*) |
billey_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具用于报告使用情况、管理订阅或提交功能申请。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费 2 个月) | 不限量* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。需要更多调用次数,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 billey_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 billey_cancel_subscription 取消:Pro 将持续至已付费周期结束,当前周期不予退款;在此之前运行 billey_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。
许可证
MIT — 参见 LICENSE。仅提供文档;服务由托管方托管。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。