CiviCRM MCP by usefulapi

usefulapi 的 CiviCRM MCP

使用你自己的 CiviCRM：联系人、捐款、会员资格、活动；记录活动日志。

在线端点： https://civicrm.usefulapi.io/mcp · 主页： https://usefulapi.io/civicrm

连接

• Claude（claude.ai、桌面版）：打开 自定义 → 连接器，点击 + 添加 → 添加自定义连接器，然后粘贴 https://civicrm.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http civicrm https://civicrm.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "civicrm": {
      "url": "https://civicrm.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：该服务会通过 OAuth 为你登录，登录页面会要求你提供 CiviCRM 凭据。

分步设置说明、凭据位置及常见问题解答：https://usefulapi.io/civicrm/

首次连接时，你需要输入 CiviCRM 站点地址（例如 https://crm.example.org）以及某个联系人的 API 密钥，该联系人须具有“使用 API 密钥进行身份验证”权限。

工具

工具	类型	功能
civicrm_whoami	读取	获取当前联系人
civicrm_search_contacts	读取	搜索联系人
civicrm_get_contact	读取	获取联系人
civicrm_list_contact_notes	读取	列出联系人备注
civicrm_list_relationships	读取	列出联系人关系
civicrm_list_contributions	读取	列出捐款
civicrm_list_memberships	读取	列出会员资格
civicrm_list_events	读取	列出活动
civicrm_list_participants	读取	列出活动参与者
civicrm_list_activities	读取	列出活动记录
civicrm_list_cases	读取	列出个案
civicrm_list_groups	读取	列出群组
civicrm_list_group_contacts	读取	列出群组成员
civicrm_get_fields	读取	描述实体的字段
civicrm_list_entities	读取	列出 API 实体
civicrm_query	读取	查询任意实体
civicrm_create_contact	写入	创建联系人
civicrm_update_contact	写入	更新联系人
civicrm_add_contact_note	写入	添加联系人备注
civicrm_log_activity	写入	记录活动
civicrm_record_contribution	写入	记录捐款
civicrm_create_membership	写入	创建会员资格
civicrm_add_contact_to_group	写入	将联系人添加到群组
civicrm_register_participant	写入	注册参与者
civicrm_usage_status	元数据	使用情况状态（免费套餐用量计数）
civicrm_request_feature	元数据	请求添加缺失功能
civicrm_upgrade	元数据	升级到 Pro（无限量*）
civicrm_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告用量、管理订阅或发送功能请求。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限量*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 civicrm_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 civicrm_cancel_subscription 取消：Pro 将持续到付费周期结束，当前周期不予退款；在此之前运行 civicrm_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT © usefulapi。与 CiviCRM 无关联，也未获得其认可。