インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、CleverReach をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
ドイツのメールマーケティング CleverReach:属性、タグ、イベント付きのグループと受信者、一括アップサート、有効化とダブルオプトインのメール、ブラックリストとバウンス、プレビューとテンプレート付きのメーリング下書き、開封、クリック、バウンスを含む送信済みメーリングのレポート。OAuth 対応の REST API v3 で、リストへの最終送信は CleverReach で行います。
こう聞いてみよう
CleverReach のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → CleverReach をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
CleverReach + Cursor
ドイツのメールマーケティング CleverReach:属性、タグ、イベント付きのグループと受信者、一括アップサート、有効化とダブルオプトインのメール、ブラックリストとバウンス、プレビューとテンプレート付きのメーリング下書き、開封、クリック、バウンスを含む送信済みメーリングのレポート。OAuth 対応の REST API v3 で、リストへの最終送信は CleverReach で行います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
CLEVERREACH_CLIENT_ID, CLEVERREACH_CLIENT_SECRET
ステップ 1 — 認証情報を取得
設定は約 10 分です。OAuth アプリを作成するため、CleverReach アカウントの管理者権限が必要です。
- CleverReach で Account、Extras、REST API を開き、OAuth アプリを作成します。
- スコープ Recipients(
oa_receivers)、Reports(oa_reports)、Forms(oa_forms)、Emails(oa_mailings)を選びます。 - リダイレクト URL
<your AnythingMCP URL>/api/mcp-oauth/callbackを登録します。AnythingMCP Cloud ではhttps://cloud.anythingmcp.com/api/mcp-oauth/callbackです。 - アプリの Client ID を
CLEVERREACH_CLIENT_IDに、Client Secret をCLEVERREACH_CLIENT_SECRETにコピーします。CLEVERREACH_REFRESH_TOKENは空のままにして、コネクタをインストールします。 - コネクタのページで Authorize with Provider をクリックし、CleverReach にサインインします。リフレッシュトークンは自動で入力、保存され、アクセストークンも自動で更新されます。
cleverreach_whoamiを実行します。トークンが属するアカウントが表示され、接続が確認できます。
読み取れるデータ: 全体、有効、無効、バウンスの受信者数とフィルター(セグメント)を含むグループ(受信者リスト);メール、有効フラグ、タイムスタンプ、流入元、属性付きのグループの受信者;ID またはメールで指定した受信者のグローバル属性、タグ、ポイント、バウンス状態、所属グループ、ショップやアプリからのイベント;一時フィルターでグループをまたいで探した受信者(何も保存されません);タグと属性(データ項目);ブラックリストとカテゴリ別のバウンス(hardbounce、softbounce、blocked、delayed、spam);登録フォーム;ステータス別(finished、draft、waiting、running、automation)のメーリングとその内容、リンク;自分のテンプレートとメーリングのカテゴリ;送信済みメーリングのレポートとして、開封、クリック、バウンス、配信停止、モード別の詳細統計(クライアント、国、最初の数時間、リンク、コンバージョンなど)、開封、クリック、バウンス、配信停止した受信者です。
書き込める内容: グループは cleverreach_create_group と cleverreach_update_group;受信者は cleverreach_create_receiver、cleverreach_upsert_receivers(メールで照合して一括登録。数百件ずつ送ります)、cleverreach_update_receiver、cleverreach_activate_receiver、cleverreach_deactivate_receiver(グループには残りますがメーリングは届きません);タグは cleverreach_add_receiver_tags と cleverreach_remove_receiver_tags;データ項目は cleverreach_create_attribute(グローバル、または group_id でグループごと);ブラックリストは cleverreach_add_to_blacklist と cleverreach_remove_from_blacklist;メーリングの下書きは cleverreach_create_mailing と cleverreach_update_mailing、テスト送信は cleverreach_send_mailing_preview で、宛先には CleverReach アカウントのユーザーのメールアドレスしか使えません。
ダブルオプトイン: AI は registered を現在時刻、activated を「0」にして受信者を作成し、cleverreach_list_forms で得たフォーム ID と種類 activate を指定して cleverreach_send_form_mail を呼び出し、同意の証拠として doidata を渡します。リンクがクリックされると CleverReach が受信者を有効化します。registered と activated を指定しないと新しい受信者はすぐに有効になるため、証明できる同意が必要です。
同意: 受信者は GDPR 上の個人データです。AI は同意が記録されたアドレスだけを追加、有効化し、変更内容を示して、書き込みの前にあなたの了承を待ちます。
インストール時はオフ: cleverreach_delete_receiver です。データ削除の依頼などで受信者をグループから完全に削除し、そのグループでの履歴は失われます。ワークスペース管理者が意図的にオンにします。それまでは無効化すれば、その受信者にメーリングは届きません。
データ形式: ID は文字列として送られる数値です。受信者のツールは受信者 ID かメールアドレスを受け付けます。時刻(registered、activated、deactivated、stamp、レポートの日付)は秒単位の Unix タイムスタンプで、0 は未設定を意味します。activated が設定され deactivated が 0 のとき、受信者はそのグループで有効です。global_attributes は全グループ、attributes は 1 つのグループに適用されます。タグは英数字、_、- で構成し、shop.vip のようにピリオドの前に流入元のプレフィックスを付けられます。
ページング: ページは 0 から始まります。受信者は pagesize(最大 5000)と page、バウンスは 1 ページ最大 500 件、メーリングは limit と page(state が all 以外のときのみページング)です。ページサイズより短いページが最後のページです。
よくあるエラー: 応答にはエラーコードとメッセージが含まれます。401 はトークンの期限切れか取り消しを意味します。もう一度 Authorize with Provider をクリックし、Client ID とシークレットが同じアプリのものか確認してください。403 は OAuth アプリにその領域のスコープがないことを意味します。アプリに Recipients、Reports、Forms、Emails を追加して再認可してください。404 は不明な ID、またはそのグループにいない、あるいはブラックリストにないアドレスを意味します。400 は属性名やタイムスタンプの誤りなど、不正なデータを意味します。
このコネクタはメーリングをリストに送信しません。CleverReach はそのための追加スコープを申請があった場合にしか付与しないため、プレビューを確認したうえで最終送信は CleverReach で開始します。グループやメーリングの削除、フォームやテンプレートの作成も行いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Cursor にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう。エージェントが
CleverReachのツールを呼び出せるようになりました。
利用可能なツール
| Tool | What it does |
|---|---|
cleverreach_whoami | Information about the CleverReach account the token belongs to: client id, company, login and contact data |
cleverreach_list_groups | List the groups (receiver lists) of the account with id, name, description (receiver_info), locked and backup flags and last changes |
cleverreach_get_group | Get one group (receiver list) by id: name, receiver_info, locked, backup and timestamps |
cleverreach_get_group_stats | Counts of a group: total, active, inactive and bounced receivers, average points, quality and order figures |
cleverreach_create_group | Create a group (receiver list) with a name and optional description |
cleverreach_update_group | Rename a group or change its description, locked or backup flag |
cleverreach_list_group_filters | List the filters (segments) of a group with id, name, operator and rules |
cleverreach_list_group_receivers | List the receivers (subscribers) of a group with email, active flag, registered, activated and deactivated timestamps, source and attributes |
cleverreach_get_receiver | Get one receiver by id or email: global attributes, tags, points, bounce state |
cleverreach_find_receivers | Find receivers across groups with a temporary filter: rules on email, source, timestamps, points or attributes, combined with AND or OR |
cleverreach_list_receiver_groups | List the groups a receiver (id or email) is in, optionally only those where it is active or inactive |
cleverreach_list_receiver_events | List the events of a receiver (id or email): custom events added by shops or apps, with type, value and timestamp |
cleverreach_create_receiver | Add one receiver (subscriber) to a group with email, timestamps, source, attributes and tags |
cleverreach_update_receiver | Update a receiver in a group (by id or email): attributes, tags, source or timestamps |
cleverreach_upsert_receivers | Create or update many receivers of a group in one call, matched by email (send large lists in chunks of a few hundred) |
cleverreach_activate_receiver | Activate a receiver in a group (by id or email) so mailings reach it |
cleverreach_deactivate_receiver | Deactivate a receiver in a group (by id or email), e.g. after an unsubscribe request |
cleverreach_delete_receiver | Delete a receiver from a group for good, e.g. for a data erasure request; its history in that group is lost |
cleverreach_add_receiver_tags | Add tags to a receiver (id or email) |
cleverreach_remove_receiver_tags | Remove tags from a receiver (id or email): one tag, several comma-separated, or all tags of an origin with origin.* |
cleverreach_list_tags | List the tags used in the account with their origin and how many receivers carry them |
cleverreach_list_attributes | List receiver attributes (data fields): global ones, or with group_id the group-specific ones |
cleverreach_create_attribute | Create a receiver attribute (data field), global or for one group: name, type (text, number, gender, date), description, preview and… |
cleverreach_list_blacklist | List the account blacklist: addresses and patterns that never receive mailings, with comment and date |
cleverreach_get_blacklist_entry | Check whether an email address is on the blacklist and read its comment and date |
cleverreach_add_to_blacklist | Put an email address on the account blacklist so no mailing reaches it any more, with an optional comment (e.g. complaint by phone) |
cleverreach_remove_from_blacklist | Remove an email address from the blacklist so it can receive mailings again |
cleverreach_list_bounces | List bounces of the account: email, category (hardbounce, softbounce, blocked, delayed, spam), occurrences, bounce message, last update and… |
cleverreach_list_bounced_receivers | List receivers that have a bounce date, page by page, to clean up lists |
cleverreach_list_forms | List the signup forms of the account with id, name and group |
cleverreach_send_form_mail | Send the double opt-in (activate) or opt-out confirmation (deactivate) email of a form to a receiver already in the form's group |
cleverreach_list_mailings | List mailings by state (finished, draft, waiting, running, automation) with id, name, subject, sender and dates. start and end filter by… |
cleverreach_get_mailing | Get one mailing by id: name, subject, sender, HTML and text content, receivers (groups or filter), settings and state |
cleverreach_create_mailing | Create a mailing as a draft: name, subject, sender, HTML and text content, target groups or filter and tracking settings |
cleverreach_update_mailing | Update a draft mailing: name, subject, sender, content, receivers, settings or tags |
cleverreach_send_mailing_preview | Send a preview of a mailing to test addresses |
cleverreach_get_mailing_links | List the links in a mailing with their ids and URLs; link ids filter cleverreach_list_report_receivers by clicks |
cleverreach_list_templates | List the user's own mailing templates with id and name, to start a new mailing from a design |
cleverreach_list_mailing_channels | List mailing categories (channels) with id and name, used to group mailings and reports |
cleverreach_list_reports | List reports of sent mailings with sent count, opens, clicks, bounces, unsubscribes and send date |
cleverreach_get_report | Get the report of one sent mailing (same id as the mailing): recipients, opens, clicks, bounces, unsubscribes and rates |
cleverreach_get_report_stats | Detailed statistics of a report by mode: full, clients, mediaclients, countries, quality (bounces), firsthours, traffic, daily (with start… |
cleverreach_list_report_receivers | List the receivers of a report by state: sent, opened, clicked (optionally one link), notopened, notclicked, bounced or unsubscribed |
プロンプトの例
- 「グループ Newsletter JP の有効、無効、バウンスの受信者はそれぞれ何人ですか?」
- 「[email protected] を名前 Max でグループ「ウェビナーリード」に追加し、登録フォームのダブルオプトインメールを送ってください。」
- 「先週のニュースレターで料金ページのリンクをクリックした受信者は誰ですか? メールアドレスを一覧にしてください。」
- 「グループ「顧客」向けに件名「秋のお知らせ」のメーリング下書きを作成し、私のアドレスにプレビューを送ってください。」
- 「直近に送った 3 本のニュースレターの開封率とクリック率を比べてください。」
FAQ
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?