关于 Mercoa MCP by usefulapi
Mercoa MCP by usefulapi 是供 MCP 客户端查询和管理 Mercoa 账户的托管服务,涵盖实体、发票、交易和支付方式,并提供读取与写入工具。
主要功能
- 01查找和管理实体
- 02搜索和管理发票
- 03查看交易及事件
- 04查看支付方式和用户
- 05创建实体和发票
- 06查询发票指标
适用场景
- 01查看发票和交易记录
- 02创建实体或发票
- 03更新发票或添加评论
MCP 相关
它向 MCP 客户端提供 Mercoa 实体、发票、交易和支付方式相关工具。服务托管运行,并使用用户的 Mercoa API 密钥进行身份验证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mercoa.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-mercoa https://mercoa.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-mercoa":{"serverUrl":"https://mercoa.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
17| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 返回的实体数量上限(1-100,默认值为 10)。 |
| search | string | 否 | 按名称、电子邮件、emailTo、实体 ID 或 foreign ID 搜索(部分匹配)。 |
| status | any | 否 | 实体状态筛选条件(例如 verified、pending)。 |
| isPayee | boolean | 否 | 筛选标记为收款方的实体。 |
| isPayor | boolean | 否 | 筛选标记为付款方的实体。 |
| foreignId | any | 否 | 你的系统中该实体的 ID(可多个)。 |
| isCustomer | boolean | 否 | 如果为 true,则仅包含与你的组织有直接关系的实体。 |
| startingAfter | string | 否 | 用于分页的实体 ID 游标。 |
| paymentMethods | boolean | 否 | 如果为 true,则在响应中包含付款方式。 |
| returnMetadata | any | 否 | 要在响应中包含的元数据键(可多个)。 |
详细介绍
Mercoa MCP by usefulapi
通过 Claude、Cursor 或任意 MCP 客户端查询和管理 Mercoa AP/AR 账单支付,包括实体、发票、交易和支付方式。托管服务,无需本地安装——使用你的 Mercoa API 密钥连接。
在线端点: https://mercoa.usefulapi.io/mcp · 主页: https://usefulapi.io/mercoa
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://mercoa.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http mercoa https://mercoa.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"mercoa": {
"url": "https://mercoa.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Mercoa 凭据。
分步设置说明、凭据查找位置及常见问题解答:https://usefulapi.io/mercoa/
首次连接时,你需要粘贴 Mercoa API 密钥。系统会验证该密钥,并将其按用户存储且仅限你本人使用。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
mercoa_find_entities | 读取 | 查找实体 |
mercoa_get_entity | 读取 | 获取实体 |
mercoa_get_entity_events | 读取 | 获取实体事件 |
mercoa_get_entity_invoice_metrics | 读取 | 获取实体发票指标 |
mercoa_list_entity_payment_methods | 读取 | 列出实体支付方式 |
mercoa_get_payment_method | 读取 | 获取支付方式 |
mercoa_list_entity_users | 读取 | 列出实体用户 |
mercoa_find_invoices | 读取 | 查找发票 |
mercoa_get_invoice | 读取 | 获取发票 |
mercoa_get_invoice_events | 读取 | 获取发票事件 |
mercoa_find_transactions | 读取 | 查找交易 |
mercoa_get_transaction | 读取 | 获取交易 |
mercoa_get_organization | 读取 | 获取组织 |
mercoa_create_entity | 写入 | 创建实体 |
mercoa_create_invoice | 写入 | 创建发票 |
mercoa_update_invoice | 写入 | 更新发票 |
mercoa_add_invoice_comment | 写入 | 添加发票评论 |
mercoa_usage_status | 元数据 | 使用情况(免费层用量计量) |
mercoa_request_feature | 元数据 | 申请缺失的功能 |
mercoa_upgrade | 元数据 | 升级到 Pro(无限*) |
mercoa_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先征求确认);meta 工具用于报告用量、管理订阅或提交功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| Pro | $9/mo 或 $90/yr(免费 2 个月) | 无限* |
*Pro 在此服务上每月最多可调用 10,000 次工具,以遵守公平使用限制。需要更多额度,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 mercoa_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 mercoa_cancel_subscription 取消:Pro 会持续到已付费周期结束,当前周期不予退款;在此之前运行 mercoa_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。
许可证
MIT — 参见 LICENSE。仅提供文档;服务由托管方运行。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。