mcpField
I
Invoice Ninja MCP by usefulapi

Invoice Ninja MCP by usefulapi

远程服务
usefulapi.io金融数据0今天更新

关于 Invoice Ninja MCP by usefulapi

为 Invoice Ninja 提供托管 MCP 服务,供 Claude、Cursor 等客户端读取和管理客户、发票、报价、费用、任务及项目。支持转换报价和发送发票,并通过 OAuth 使用用户自己的凭据,无需本地安装。

主要功能

  1. 01查询客户、发票、报价和付款
  2. 02管理产品、费用、供应商和经常性发票
  3. 03创建及更新客户和发票
  4. 04创建报价并转换为发票
  5. 05发送发票邮件
  6. 06创建费用、任务和项目

适用场景

  1. 01查询客户的发票及付款记录
  2. 02将报价转为发票并发送
  3. 03记录费用并创建任务或项目

MCP 相关

作为托管 MCP 服务,向 MCP 客户端开放 Invoice Ninja 的查询与写入工具,包括创建、更新和发送业务记录。客户端通过 OAuth 登录,并可提供自托管实例的 URL。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://invoice-ninja.usefulapi.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

24
参数类型必填说明
namestring否仅显示名称匹配的客户。
pageinteger否页码,从 1 开始。
sortstring否按「column|asc」或「column|desc」排序,例如「number|desc」或「balance|desc」。
emailstring否仅显示联系邮箱为此邮箱的客户。
filterstring否按名称、ID 编号、联系人姓名/邮箱/电话和自定义字段进行全文搜索。
numberstring否仅显示客户编号为此编号的客户。
statusstring否以逗号分隔的记录状态:active、archived、deleted(例如「active」)。省略则包括全部状态。
balancestring否余额比较条件,格式为「op:value」;op 可为 lt、lte、gt、gte、eq,例如「gt:0」。
per_pageinteger否每页记录数,范围为 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 无关联,也未获其认可。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。