关于 Qgiv MCP by usefulapi
Qgiv MCP by usefulapi 是托管式只读服务,供 MCP 客户端访问 Qgiv 募款记录,涵盖捐款、退款、定期捐赠、报表、点对点筹款报名、活动和认捐。
主要功能
- 01列出并获取捐款与退款
- 02查看定期捐赠计划和报表
- 03浏览点对点筹款报名与活动
- 04访问认捐选项和自定义字段
- 05查看报表映射
适用场景
- 01按日期查看捐款和退款
- 02检查定期捐赠计划与报表
- 03跟踪点对点活动报名
- 04查询认捐选项和报表映射
MCP 相关
通过托管端点向 MCP 客户端提供 Qgiv 只读数据工具。使用前需连接 Qgiv 账户。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://qgiv.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-qgiv https://qgiv.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-qgiv":{"type":"http","url":"https://qgiv.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-qgiv":{"type":"http","url":"https://qgiv.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-qgiv":{"type":"http","url":"https://qgiv.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-qgiv":{"serverUrl":"https://qgiv.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
21| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 返回的记录数(1–100,默认 25)。 |
| include_contact | boolean | 否 | 包含捐赠者联系信息(电子邮件、电话、邮寄地址)。默认关闭:仅返回姓名、id 和金额。 |
详细介绍
usefulapi 提供的 Qgiv MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Qgiv——只读访问捐赠、退款、定期捐赠、对账单、点对点注册、活动和认捐。 托管服务,无需本地安装:使用你自己的 Qgiv 凭据连接。
在线端点: https://qgiv.usefulapi.io/mcp · 主页: https://usefulapi.io/qgiv
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://qgiv.usefulapi.io/mcp。 - Claude Code: 运行
claude mcp add --transport http qgiv https://qgiv.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"qgiv": {
"url": "https://qgiv.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Qgiv 凭据。
分步设置说明、凭据查找方式和常见问题解答:https://usefulapi.io/qgiv/
工具
| 工具 | 类型 | 功能 |
|---|---|---|
qgiv_list_recent_transactions | read | 列出最近的交易 |
qgiv_list_transactions_by_date | read | 按日期范围列出交易 |
qgiv_list_transactions_after_id | read | 列出指定 ID 之后的交易 |
qgiv_get_transaction | read | 获取交易 |
qgiv_list_recent_refunds | read | 列出最近的退款 |
qgiv_list_refunds_by_date | read | 按日期范围列出退款 |
qgiv_get_refund | read | 获取退款 |
qgiv_list_recurring_schedules | read | 列出定期捐赠计划 |
qgiv_get_recurring_schedule | read | 获取定期捐赠计划 |
qgiv_list_statements | read | 列出对账单 |
qgiv_get_latest_statements | read | 获取最新对账单 |
qgiv_get_statement | read | 获取对账单 |
qgiv_list_recent_registrations | read | 列出最近的 P2P 注册 |
qgiv_list_registrations_by_date | read | 按日期范围列出 P2P 注册 |
qgiv_get_registration | read | 获取 P2P 注册 |
qgiv_list_events | read | 列出活动 |
qgiv_list_pledges | read | 列出认捐选项 |
qgiv_get_pledge | read | 获取认捐选项 |
qgiv_list_custom_fields | read | 列出自定义字段 |
qgiv_list_report_mappings | read | 列出报告映射 |
qgiv_get_report_mapping | read | 获取报告映射 |
qgiv_usage_status | meta | 使用情况状态(免费套餐用量计数) |
qgiv_request_feature | meta | 申请添加缺少的功能 |
qgiv_upgrade | meta | 升级到 Pro(不限量*) |
qgiv_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应要求确认);meta 工具用于报告使用情况、管理订阅或发送功能申请。
定价
| 套餐 | 价格 | 限制 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(每位用户) | $9/月或 $90/年(免费 2 个月) | 不限量* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 qgiv_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 qgiv_cancel_subscription 取消:Pro 将持续至已付费周期结束,当前周期不予退款;在此之前运行 qgiv_upgrade 可撤销取消。也可以发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Qgiv 无关联,也未获得其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。