Retainful MCP by usefulapi について
Retainful の利用者が連絡先やリストを確認し、連絡先情報を更新してイベントを記録できるホスト型 MCP サーバーです。MCP クライアントから使える読み取り・書き込みツールを備えています。
主な機能
- 01連絡先の一覧と取得
- 02リストとセグメントの一覧・取得
- 03連絡先の作成または更新
- 04連絡先のリストへの追加
- 05イベントの記録
活用シーン
- 01連絡先情報やセグメントの確認
- 02連絡先のマーケティングリストへの追加
- 03連絡先に関するイベントの記録
MCP 対応
Retainful の連絡先、リスト、イベント操作を MCP ツールとして提供します。クライアントから情報の参照、連絡先の更新、リスト追加、イベント記録を行えます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://retainful.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-retainful https://retainful.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-retainful":{"type":"http","url":"https://retainful.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-retainful":{"type":"http","url":"https://retainful.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-retainful":{"type":"http","url":"https://retainful.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-retainful":{"serverUrl":"https://retainful.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
usefulapi の Retainful MCP
Claude、Cursor、または任意の MCP クライアントから、お使いの Retainful アカウントを利用できます。連絡先やリストの読み取り、連絡先のリストへの追加、イベントの記録が可能です。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報で接続できます。
ライブエンドポイント: https://retainful.usefulapi.io/mcp · ホームページ: https://usefulapi.io
接続
- Claude(claude.ai、Desktop):Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、
https://retainful.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http retainful https://retainful.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: リモート MCP サーバーとして URL を追加します。
{
"mcpServers": {
"retainful": {
"url": "https://retainful.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーが OAuth でログインを行い、ログインページで Retainful の認証情報を求めます。
ステップごとの設定方法、認証情報の確認場所、FAQ:https://usefulapi.io/retainful/
初回接続時に、Retainful のAPI キーを入力します。キーは Retainful の「Integrations → お使いのアプリ → Create API key」で作成できます。サーバーがキーを検証し、ユーザーごとに保存します。設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
retainful_list_contacts | read | 連絡先の一覧を取得 |
retainful_get_contact | read | 連絡先を取得 |
retainful_list_lists | read | リストとセグメントの一覧を取得 |
retainful_get_list | read | リストを取得 |
retainful_upsert_contact | write | 連絡先を作成または更新 |
retainful_add_contact_to_list | write | 連絡先をリストに追加 |
retainful_track_event | write | イベントを記録 |
retainful_usage_status | meta | 使用状況(無料プランの利用状況メーター) |
retainful_request_feature | meta | 不足している機能をリクエスト |
retainful_upgrade | meta | Pro にアップグレード(無制限*) |
retainful_cancel_subscription | meta | Pro サブスクリプションをキャンセル |
readツールは読み取り専用です。writeツールはデータを変更するため、クライアント側で確認を行う必要があります。metaツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信に使用します。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月 50 回のツール呼び出し |
| Pro(ユーザー単位) | $9/mo または $90/yr(2 か月分無料) | 無制限* |
*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正使用上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro が適用されるのはこのサーバーのみです。retainful_upgradeを実行して登録してください(Stripe Checkout のリンクが返されます)。retainful_cancel_subscriptionを実行すればいつでもキャンセルできます。キャンセル後も有料期間の終了までは Pro を利用できます。現在の期間分の返金はありません。終了前にretainful_upgradeを実行すると、キャンセルが取り消されます。[email protected] へのご連絡でも承ります。
ライセンス
MIT — LICENSEを参照してください。ドキュメントのみです。サーバーはホスト型です。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。