Elvanto MCP by usefulapi について
Elvanto MCP by usefulapi は、Elvanto のデータを扱うホスト型 MCP サーバーです。MCP クライアントから人物、グループ、礼拝、楽曲、フォローアップフロー、カレンダー、献金記録を扱う教会やチーム向けです。
主な機能
- 01人物情報の検索と取得
- 02グループ、礼拝、楽曲の閲覧
- 03カレンダーとフォローアップフローの確認
- 04財務カテゴリと献金記録の確認
- 05人物やイベントの作成と更新
活用シーン
- 01Elvanto で人物やグループを探す
- 02礼拝の詳細や楽曲アレンジを確認する
- 03フローステップごとの人物を確認する
- 04人物の追加やカレンダーイベントの作成
MCP 対応
ホスト型エンドポイントを通じて、Elvanto の読み取り・書き込みツールを MCP クライアントに提供します。ユーザーは自身の 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 ページあたりのレコード数、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、デスクトップ):カスタマイズ → コネクターを開き、+追加 → カスタムコネクターを追加をクリックして、
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 | read | 人物の一覧を取得 |
elvanto_search_people | read | 人物を検索 |
elvanto_get_person | read | 1 人の人物を取得 |
elvanto_list_people_categories | read | 人物カテゴリの一覧を取得 |
elvanto_list_custom_fields | read | カスタム人物フィールドの一覧を取得 |
elvanto_list_groups | read | グループの一覧を取得 |
elvanto_get_group | read | 1 つのグループを取得 |
elvanto_list_services | read | サービスの一覧を取得 |
elvanto_get_service | read | 1 つのサービスを取得 |
elvanto_list_songs | read | 楽曲の一覧を取得 |
elvanto_list_song_arrangements | read | 楽曲のアレンジの一覧を取得 |
elvanto_list_calendars | read | カレンダーの一覧を取得 |
elvanto_list_calendar_events | read | カレンダーイベントの一覧を取得 |
elvanto_list_people_flows | read | 人物フローの一覧を取得 |
elvanto_list_people_flow_steps | read | 人物フローのステップ一覧を取得 |
elvanto_list_people_flow_step_people | read | フローステップに含まれる人物の一覧を取得 |
elvanto_list_financial_categories | read | 財務カテゴリの一覧を取得 |
elvanto_list_transactions | read | 献金取引の一覧を取得 |
elvanto_create_person | write | 人物を作成 |
elvanto_update_person | write | 人物を更新 |
elvanto_add_person_to_group | write | 人物をグループに追加 |
elvanto_add_person_to_flow_step | write | 人物を人物フローのステップに追加 |
elvanto_create_calendar_event | write | カレンダーイベントを作成 |
elvanto_usage_status | meta | 使用状況(無料プランの利用量) |
elvanto_request_feature | meta | 不足している機能をリクエスト |
elvanto_upgrade | meta | Pro にアップグレード(無制限*) |
elvanto_cancel_subscription | meta | Pro サブスクリプションを解約 |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアントは実行前に確認してください。meta ツールは使用状況の報告、サブスクリプションの管理、または機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| 無料 | $0 | 月 50 回のツール呼び出し |
| Pro(ユーザーごと) | $9/mo または $90/yr(2 か月分無料) | 無制限* |
*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro の対象はこのサーバーのみです。elvanto_upgrade で登録してください(Stripe Checkout リンクが返されます)。elvanto_cancel_subscription でいつでも解約できます。Pro は支払い済み期間の終了まで継続し、現在の期間分の返金はありません。終了前に elvanto_upgrade を実行すると、解約は取り消されます。または、[email protected] までご連絡ください。
ライセンス
MIT © usefulapi。Elvanto とは提携しておらず、Elvanto の承認を受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。