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 | 読み取り | 最近の取引を一覧表示 |
qgiv_list_transactions_by_date | 読み取り | 日付範囲で取引を一覧表示 |
qgiv_list_transactions_after_id | 読み取り | 指定した ID 以降の取引を一覧表示 |
qgiv_get_transaction | 読み取り | 取引を取得 |
qgiv_list_recent_refunds | 読み取り | 最近の返金を一覧表示 |
qgiv_list_refunds_by_date | 読み取り | 日付範囲で返金を一覧表示 |
qgiv_get_refund | 読み取り | 返金を取得 |
qgiv_list_recurring_schedules | 読み取り | 定期寄付のスケジュールを一覧表示 |
qgiv_get_recurring_schedule | 読み取り | 定期寄付のスケジュールを取得 |
qgiv_list_statements | 読み取り | 明細書を一覧表示 |
qgiv_get_latest_statements | 読み取り | 最新の明細書を取得 |
qgiv_get_statement | 読み取り | 明細書を取得 |
qgiv_list_recent_registrations | 読み取り | 最近の P2P 登録を一覧表示 |
qgiv_list_registrations_by_date | 読み取り | 日付範囲で P2P 登録を一覧表示 |
qgiv_get_registration | 読み取り | P2P 登録を取得 |
qgiv_list_events | 読み取り | イベントを一覧表示 |
qgiv_list_pledges | 読み取り | 誓約オプションを一覧表示 |
qgiv_get_pledge | 読み取り | 誓約オプションを取得 |
qgiv_list_custom_fields | 読み取り | カスタムフィールドを一覧表示 |
qgiv_list_report_mappings | 読み取り | レポートマッピングを一覧表示 |
qgiv_get_report_mapping | 読み取り | レポートマッピングを取得 |
qgiv_usage_status | メタ | 使用状況(無料プランの利用枠) |
qgiv_request_feature | メタ | 不足している機能をリクエスト |
qgiv_upgrade | メタ | Pro にアップグレード(無制限*) |
qgiv_cancel_subscription | メタ | Pro サブスクリプションを解約 |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認を求める必要があります。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 制限 |
|---|---|---|
| Free | $0 | 月 50 回のツール呼び出し |
| Pro(ユーザーごと) | $9/mo または $90/yr(2 か月分無料) | 無制限* |
*このサーバーでの Pro の適正利用上限は、月 10,000 回のツール呼び出しです。それ以上必要な場合は、[email protected] までご連絡ください。
Pro が適用されるのはこのサーバーのみです。qgiv_upgrade を使用して登録してください(Stripe Checkout のリンクが返されます)。qgiv_cancel_subscription でいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。その前に qgiv_upgrade を実行すると、解約が取り消されます。または [email protected] までご連絡ください。
ライセンス
MIT © usefulapi。Qgiv とは提携しておらず、Qgiv の推奨も受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。