关于 Invoice Ninja MCP by usefulapi
为 Invoice Ninja 提供托管 MCP 服务,供 Claude、Cursor 等客户端读取和管理客户、发票、报价、费用、任务及项目。支持转换报价和发送发票,并通过 OAuth 使用用户自己的凭据,无需本地安装。
主要功能
- 01查询客户、发票、报价和付款
- 02管理产品、费用、供应商和经常性发票
- 03创建及更新客户和发票
- 04创建报价并转换为发票
- 05发送发票邮件
- 06创建费用、任务和项目
适用场景
- 01查询客户的发票及付款记录
- 02将报价转为发票并发送
- 03记录费用并创建任务或项目
MCP 相关
作为托管 MCP 服务,向 MCP 客户端开放 Invoice Ninja 的查询与写入工具,包括创建、更新和发送业务记录。客户端通过 OAuth 登录,并可提供自托管实例的 URL。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://invoice-ninja.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-invoice-ninja https://invoice-ninja.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-invoice-ninja":{"type":"http","url":"https://invoice-ninja.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-invoice-ninja":{"type":"http","url":"https://invoice-ninja.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-invoice-ninja":{"type":"http","url":"https://invoice-ninja.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-invoice-ninja":{"serverUrl":"https://invoice-ninja.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
24| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 仅显示名称匹配的客户。 |
| page | integer | 否 | 页码,从 1 开始。 |
| sort | string | 否 | 按「column|asc」或「column|desc」排序,例如「number|desc」或「balance|desc」。 |
| string | 否 | 仅显示联系邮箱为此邮箱的客户。 | |
| filter | string | 否 | 按名称、ID 编号、联系人姓名/邮箱/电话和自定义字段进行全文搜索。 |
| number | string | 否 | 仅显示客户编号为此编号的客户。 |
| status | string | 否 | 以逗号分隔的记录状态:active、archived、deleted(例如「active」)。省略则包括全部状态。 |
| balance | string | 否 | 余额比较条件,格式为「op:value」;op 可为 lt、lte、gt、gte、eq,例如「gt:0」。 |
| per_page | integer | 否 | 每页记录数,范围为 1-100(API 默认值为 20)。 |
详细介绍
usefulapi 的 Invoice Ninja MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Invoice Ninja——读取和创建客户、发票、报价单、费用、任务和项目,转换报价单,并通过电子邮件发送发票。 托管服务,无需本地安装:使用你自己的 Invoice Ninja 凭据进行连接。
在线端点: https://invoice-ninja.usefulapi.io/mcp · 主页: https://usefulapi.io/invoice-ninja
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://invoice-ninja.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http invoice-ninja https://invoice-ninja.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"invoice-ninja": {
"url": "https://invoice-ninja.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Invoice Ninja 凭据。
分步设置说明、凭据查找方式和常见问题解答:https://usefulapi.io/invoice-ninja/
首次连接时,你需要提供 Invoice Ninja API 令牌(Settings → Account Management → Integrations → API tokens),如果使用自托管实例,还需提供实例 URL。 凭据经过验证后会按用户存储,并仅限你本人使用——配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
invoiceninja_list_clients | 读取 | 列出客户 |
invoiceninja_get_client | 读取 | 获取单个客户 |
invoiceninja_list_invoices | 读取 | 列出发票 |
invoiceninja_get_invoice | 读取 | 获取单张发票 |
invoiceninja_list_quotes | 读取 | 列出报价单 |
invoiceninja_get_quote | 读取 | 获取单份报价单 |
invoiceninja_list_products | 读取 | 列出产品 |
invoiceninja_list_payments | 读取 | 列出付款 |
invoiceninja_list_expenses | 读取 | 列出费用 |
invoiceninja_list_vendors | 读取 | 列出供应商 |
invoiceninja_list_tasks | 读取 | 列出任务 |
invoiceninja_list_projects | 读取 | 列出项目 |
invoiceninja_list_recurring_invoices | 读取 | 列出定期发票 |
invoiceninja_create_client | 写入 | 创建客户 |
invoiceninja_update_client | 写入 | 更新客户 |
invoiceninja_create_invoice | 写入 | 创建发票 |
invoiceninja_update_invoice | 写入 | 更新发票 |
invoiceninja_mark_invoice_sent | 写入 | 将发票标记为已发送 |
invoiceninja_email_invoice | 写入 | 通过电子邮件向客户发送发票 |
invoiceninja_create_quote | 写入 | 创建报价单 |
invoiceninja_convert_quote_to_invoice | 写入 | 将报价单转换为发票 |
invoiceninja_create_expense | 写入 | 创建费用 |
invoiceninja_create_task | 写入 | 创建任务/记录工时 |
invoiceninja_create_project | 写入 | 创建项目 |
invoiceninja_usage_status | 元数据 | 使用情况状态(免费层级用量计量) |
invoiceninja_request_feature | 元数据 | 请求添加缺失的功能 |
invoiceninja_upgrade | 元数据 | 升级到 Pro(无限使用*) |
invoiceninja_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具用于报告用量、管理订阅或提交功能请求。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| 专业版(按用户计费) | $9/月 或 $90/年(免费 2 个月) | 不限量* |
*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请联系 [email protected]。
专业版仅适用于此服务。使用 invoiceninja_upgrade 订阅(它会返回一个 Stripe Checkout 链接)。可随时使用 invoiceninja_cancel_subscription 取消:专业版将持续到已付费周期结束,当前周期不予退款;在此之前运行 invoiceninja_upgrade 可撤销取消操作。或者联系 [email protected]。
许可证
MIT © usefulapi。与 Invoice Ninja 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。