关于 Virtuous MCP by usefulapi
Virtuous MCP by usefulapi 是面向使用 Virtuous 管理捐赠者关系团队的托管 MCP 服务。它支持搜索和查询联系人、捐赠记录、备注、标签、项目及活动,并可记录备注、标签、联系人和礼物。
主要功能
- 01搜索联系人和捐赠者
- 02查看捐赠记录与备注
- 03搜索项目并列出活动
- 04查询 Virtuous 记录
- 05记录备注、标签、联系人和礼物
适用场景
- 01查找捐赠者及联系人记录
- 02查看联系人的礼物与备注
- 03搜索项目或查询记录
- 04记录备注、标签或提交礼物
MCP 相关
向 MCP 客户端提供 Virtuous 搜索、联系人、捐赠、项目、活动和查询功能。写入工具可添加联系人备注和标签,也可提交联系人或礼物以供导入。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://virtuous-crm.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-virtuous-crm https://virtuous-crm.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-virtuous-crm":{"type":"http","url":"https://virtuous-crm.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-virtuous-crm":{"type":"http","url":"https://virtuous-crm.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-virtuous-crm":{"type":"http","url":"https://virtuous-crm.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-virtuous-crm":{"serverUrl":"https://virtuous-crm.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
20此工具无需参数。
详细介绍
usefulapi 提供的 Virtuous MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Virtuous — 搜索捐赠者,查看联系人、捐赠记录、备注、标签、项目和活动,运行查询,以及记录备注、添加标签、联系人和捐赠。 托管服务,无需本地安装:使用你自己的 Virtuous 凭据连接。
在线端点: https://virtuous-crm.usefulapi.io/mcp · 主页: https://usefulapi.io/virtuous-crm
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://virtuous-crm.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http virtuous-crm https://virtuous-crm.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"virtuous-crm": {
"url": "https://virtuous-crm.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你输入 Virtuous 凭据。
分步设置说明、凭据查找位置和常见问题:https://usefulapi.io/virtuous-crm/
首次连接时,你需要提供 Virtuous API 密钥(Settings → API Keys)。 密钥会经过验证,按用户存储,并仅限你本人使用 — 配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
virtuous_get_current_organization | read | 获取当前组织 |
virtuous_search | read | 全局搜索 |
virtuous_search_contacts | read | 搜索联系人 |
virtuous_get_contact | read | 获取联系人 |
virtuous_find_contact | read | 通过电子邮件或引用查找联系人 |
virtuous_list_contact_individuals | read | 列出联系人的个人信息 |
virtuous_list_contact_notes | read | 列出联系人的备注 |
virtuous_list_contact_note_types | read | 列出联系人备注类型 |
virtuous_list_contact_tags | read | 列出联系人的标签 |
virtuous_list_contact_gifts | read | 列出联系人的捐赠 |
virtuous_get_gift | read | 获取一笔捐赠 |
virtuous_list_tags | read | 列出标签 |
virtuous_search_projects | read | 搜索项目 |
virtuous_get_project | read | 获取项目 |
virtuous_list_events | read | 列出活动 |
virtuous_get_query_options | read | 获取查询选项 |
virtuous_query | read | 查询记录 |
virtuous_create_contact_note | write | 为联系人记录备注 |
virtuous_add_contact_tag | write | 为联系人添加标签 |
virtuous_create_contact_transaction | write | 提交联系人以供导入 |
virtuous_create_gift_transaction | write | 提交捐赠以供导入 |
virtuous_usage_status | meta | 使用情况(免费套餐用量计数) |
virtuous_request_feature | meta | 申请添加缺失功能 |
virtuous_upgrade | meta | 升级到 Pro(无限制*) |
virtuous_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前征求确认);meta 工具用于报告使用情况、管理订阅或提交功能申请。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费 2 个月) | 无限制* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 virtuous_upgrade 订阅(它会返回 Stripe Checkout 链接)。随时可通过 virtuous_cancel_subscription 取消:Pro 会持续到付费周期结束,当前周期不予退款;在此之前运行 virtuous_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Virtuous 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。