关于 Elvanto MCP by usefulapi
Elvanto MCP by usefulapi 是用于访问和管理 Elvanto 数据的托管 MCP 服务,面向需要通过 MCP 客户端处理人员、群组、聚会、歌曲、跟进流程、日历和奉献记录的教会及团队。
主要功能
- 01搜索和读取人员记录
- 02浏览群组、聚会和歌曲
- 03读取日历与跟进流程
- 04查看财务类别和奉献记录
- 05创建及更新人员和活动
适用场景
- 01在 Elvanto 中查找人员或群组
- 02查看聚会详情和歌曲编排
- 03跟进人员在流程步骤中的状态
- 04添加人员或创建日历活动
MCP 相关
通过托管端点向 MCP 客户端提供 Elvanto 读取和写入工具。用户使用自己的 Elvanto API 密钥连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://elvanto.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-elvanto https://elvanto.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-elvanto":{"type":"http","url":"https://elvanto.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-elvanto":{"type":"http","url":"https://elvanto.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-elvanto":{"type":"http","url":"https://elvanto.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-elvanto":{"serverUrl":"https://elvanto.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
23| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 要检索的结果页(从 1 开始)。默认值为 1。 |
| fields | array | 否 | 可选的额外人员字段,例如 gender、birthday、anniversary、school_grade、marital_status、development_child、special_needs_child、security_code、receipt_name、giving_number、mailing_address、mailing_city、mailing_state、mailing_postcode、mailing_country、home_address、home_city、home_state、home_postcode、home_country、access_permissions、departments、service_types、demographics、locations、family,或 custom_<field id> 格式的自定义字段(参见 elvanto_list_custom_fields)。 |
| contact | enum | 否 | yes = 仅联系人,no = 排除联系人。默认值为全部。yes | no |
| archived | enum | 否 | yes = 仅已归档人员,no = 排除已归档人员。默认值为全部。yes | no |
| page_size | integer | 否 | 每页记录数,范围为 1-1000。此处默认值为 100(Elvanto 自身的默认值为 1000)。 |
| suspended | enum | 否 | yes = 仅暂停的人员,no = 排除暂停的人员。默认值为全部。yes | no |
| category_id | any | 否 | 仅包含属于此人员类别 ID(或这些 ID 中任意一个)的人员。 |
详细介绍
usefulapi 出品的 Elvanto MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Elvanto——查询人员、群组、服事排班、歌曲、跟进流程和奉献记录。 托管服务,无需本地安装:使用你自己的 Elvanto 凭据连接。
线上端点: https://elvanto.usefulapi.io/mcp · 主页: https://usefulapi.io/elvanto
连接
- Claude(claude.ai、Desktop):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://elvanto.usefulapi.io/mcp。 - Claude Code: 运行
claude mcp add --transport http elvanto https://elvanto.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"elvanto": {
"url": "https://elvanto.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Elvanto 凭据。
分步设置说明、凭据查找方式和常见问题解答:https://usefulapi.io/elvanto/
首次连接时,你需要提供 Elvanto API 密钥(设置 → 账户设置 → API,仅限管理员)。 系统会验证密钥,按用户分别存储,并将其限定为仅供你使用——配置文件中不会包含任何密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
elvanto_list_people | 读取 | 列出人员 |
elvanto_search_people | 读取 | 搜索人员 |
elvanto_get_person | 读取 | 获取一位人员的信息 |
elvanto_list_people_categories | 读取 | 列出人员类别 |
elvanto_list_custom_fields | 读取 | 列出自定义人员字段 |
elvanto_list_groups | 读取 | 列出群组 |
elvanto_get_group | 读取 | 获取一个群组的信息 |
elvanto_list_services | 读取 | 列出服事 |
elvanto_get_service | 读取 | 获取一项服事的信息 |
elvanto_list_songs | 读取 | 列出歌曲 |
elvanto_list_song_arrangements | 读取 | 列出一首歌曲的编曲 |
elvanto_list_calendars | 读取 | 列出日历 |
elvanto_list_calendar_events | 读取 | 列出日历事件 |
elvanto_list_people_flows | 读取 | 列出人员流程 |
elvanto_list_people_flow_steps | 读取 | 列出人员流程中的步骤 |
elvanto_list_people_flow_step_people | 读取 | 列出人员流程步骤中的人员 |
elvanto_list_financial_categories | 读取 | 列出财务类别 |
elvanto_list_transactions | 读取 | 列出奉献交易 |
elvanto_create_person | 写入 | 创建人员 |
elvanto_update_person | 写入 | 更新人员信息 |
elvanto_add_person_to_group | 写入 | 将人员添加到群组 |
elvanto_add_person_to_flow_step | 写入 | 将人员添加到人员流程步骤 |
elvanto_create_calendar_event | 写入 | 创建日历事件 |
elvanto_usage_status | 元数据 | 使用情况(免费套餐用量计数) |
elvanto_request_feature | 元数据 | 请求添加缺失功能 |
elvanto_upgrade | 元数据 | 升级到 Pro(无限*) |
elvanto_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具仅供读取;write 工具会修改数据(客户端应先征求确认);meta 工具用于报告使用情况、管理订阅或提交功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/月 或 $90/年(免费 2 个月) | 无限* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 elvanto_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。你可以随时使用 elvanto_cancel_subscription 取消:Pro 权限会持续到已付费周期结束,当前周期费用不予退款;在此之前运行 elvanto_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Elvanto 无关联,也未获得其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。