MCP REFERENCE

Squad beyond MCP ツールリファレンス

Squad beyond の管理画面で行う操作を、Claude などの AI アシスタントから直接呼び出せる Model Context Protocol サーバーのツール定義集。記事の入稿・配信制御・レポート取得・CV速報まで、計13ツールを提供する。

01 / WORKFLOW

ユースケース別ワークフロー

よくある3つの作業フローと、AI アシスタントに対する依頼例。実際にはこれらのツールを Claude などが自動で組み合わせて実行する。

記事の入稿から配信開始まで
既存のbeyondページに新しいversionをHTMLで追加し、配信を開始する
1
searchAbTestByUrl
配信URLから対象のbeyondページを特定
2
createAbTestArticle
空のversionを新規作成
3
uploadVersionHtml
HTMLを下書きとして入稿
4
updateArticleReflection
下書きを本番に反映
5
updateArticleRate
配信割合を設定して配信開始
依頼例
「https://example.com/ab/xxx の beyondページに、添付の HTML で新しい version を入稿して、まずは 20% の配信割合で開始して」
「対象の version の HTML を更新して下書き保存。本番反映は明日まで待って」
パフォーマンス分析
beyondページの日別レポート・ヒートマップ・version別の数値を取得して分析する
1
listFolders / listAbTests
フォルダや条件で対象を絞り込む
2
getBranchOperationReports
version × 広告 × CVタグの日別レポートを一括取得
3
getArticleArrivalHeatmap
気になるversionのスクロール到達率を深掘り
依頼例
「フォルダ『春キャンペーン』配下のbeyondページ全部について、直近7日のCVRが高いversionトップ3を出して」
「version XXX の昨日のスクロール到達率を、スマホとPCで比べて見せて」
CV速報モニタリング
直近のCVを最短30分単位でリアルタイム確認する
1
listAgentsConversions
直近30分 / 1時間 / 今日 / 昨日のCVを取得。任意の期間指定も可能
依頼例
「ここ30分でCV何件入ってる？」
「昨日の19時から24時までのCVを一覧で」
02 / REFERENCE

全ツール詳細

15ツール(認証2 + 機能13)の正式な定義とパラメータ一覧。各ツールのdescriptionは MCP サーバーから取得した原文を掲載している。

検索・一覧

4 tools
listAbTests 一覧

beyondページ(ab_test)の一覧を取得します。

パラメータ型必須説明
pagenumber任意ページ番号
per_pagenumber任意1ページあたりの件数
ab_test_idsstring任意AB test ID でフィルタ(カンマ区切り)
uidsstring任意AB test UID でフィルタ(カンマ区切り)
domainstring任意ドメインでフィルタ(完全一致)
folder_idsstring任意フォルダ ID でフィルタ(カンマ区切り)
media_idsstring任意メディア ID でフィルタ(カンマ区切り)
searchAbTestByUrl 検索

beyondページ(AbTest) / 中間ページ(RedirectPage) / バージョン(Article) の配信 URL または UID から beyondページ(AbTest) を検索します。url と uid のどちらかを指定してください。

パラメータ型必須説明
urlstring任意AbTest / RedirectPage / Article いずれかの配信 URL。パス先頭から 2 番目のセグメントを UID として抽出する。
・AbTest: https://{domain}/ab/{uid}
・RedirectPage: https://{domain}/redirect_pages/{uid}
・Article: https://{domain}/articles/{uid}/...
uidstring任意AbTest / RedirectPage / Article いずれかの UID を直接指定する
listFolders 一覧

フォルダの一覧を取得します。

パラメータ型必須説明
pagenumber任意ページ番号
per_pagenumber任意1ページあたりの件数
searchFolders 検索

フォルダ名でフォルダを検索します(最大100件)。

パラメータ型必須説明
namestring必須検索するフォルダ名(Meilisearch を使用)

記事(version)管理

5 tools
listAbTestArticles 一覧

beyondページに紐づく記事(version)一覧を取得します。

パラメータ型必須説明
ab_test_uidstring必須AB test UID
sortstring任意ソートフィールド(デフォルト: created_at)。page_view_count を指定した場合は直近30日の合計PVでソートする。
・created_at
・body_updated_at
・page_view_count
orderstring任意ソート方向(デフォルト: desc)
createAbTestArticle 作成

beyondページ配下に新しい記事(version)をHTMLが空の状態で作成します。HTMLエディタ版のbeyondページのみ対応。

パラメータ型必須説明
ab_test_uidstring必須AB test UID
getArticleHtml 取得

記事のHTMLコンテンツを取得します。

パラメータ型必須説明
article_uidstring必須Article UID
uploadVersionHtml 入稿

指定したversionにHTMLコンテンツをアップロードします。下書き状態で保存され、公開はされません。upload_external_photos=true の場合、HTML内の外部画像URLを取得してチームのストレージにアップロードし、画像URLを置換します(失敗した画像はレスポンスの error_photo_data に含まれます)。

パラメータ型必須説明
article_uidstring必須Article UID
htmlstring必須記事に取り込むHTMLコンテンツ
upload_external_photosboolean任意true の場合、HTML内の外部画像URLを取得してチームのストレージにアップロードし、画像URLを置換した上で保存する。false または未指定の場合は外部画像のアップロードは行わない。
updateArticleReflection 本番反映

記事(version)の下書き本文を本番に反映し、配信コンテンツを更新します。HTMLエディタ版のbeyondページでのみ使用可能です。フォルダに対するbeyondページの編集権限が必要です。

パラメータ型必須説明
article_uidstring必須Article UID

配信制御

1 tool
updateArticleRate 配信割合

記事(version)の配信割合(rate)を更新します。rateは他versionとの比率で設定するのが一般的です(例: 2つのversionに 1:2 を設定すると配信比率は 1/3 : 2/3)。値は 0-100 の範囲を取り、beyondページ内の他version合計が 100 を超える / 0 未満になる場合はエラー。rate が 0 から 1 以上に変わる(配信停止 → 配信開始)タイミングで、配信用HTMLが未デプロイであれば自動でデプロイされます。配信割合変更後は、listAbTestArticles を呼び出して更新後の配信割合を必ず確認してください。

パラメータ型必須説明
article_uidstring必須Article UID
ratenumber必須配信割合(0-100)

レポート・分析

4 tools
listAbTestDailyReports 日別レポート

beyondページの日別レポートを取得します。

パラメータ型必須説明
ab_test_uidstring必須AB test UID
start_datestring必須開始日(YYYY-MM-DD)
end_datestring必須終了日(YYYY-MM-DD)
sort_directionstring任意日付のソート方向(asc / desc、デフォルト: desc)
pagenumber任意ページ番号
per_pagenumber任意1ページあたりの件数
getBranchOperationContext コンテキスト

Branch Operationのコンテキスト(articles, ads, conversion_event_tags, parameters)を一括取得します。

パラメータ型必須説明
ab_test_uidstring必須AB test UID
getBranchOperationReports レポート一括

Branch Operationのレポートデータ(article_reports, article_parameter_daily_reports, ad_daily_reports, parameter_daily_reports, conversion_event_tag_article_daily_reports, conversion_event_tag_article_parameter_daily_reports)を一括取得します。

パラメータ型必須説明
ab_test_uidstring必須AB test UID
start_datestring必須開始日(YYYY-MM-DD)
end_datestring必須終了日(YYYY-MM-DD)
getArticleArrivalHeatmap ヒートマップ

指定したarticleのヒートマップ到達データを取得します。

パラメータ型必須説明
article_uidstring必須Article UID
start_datestring必須開始日(YYYY-MM-DD)
end_datestring必須終了日(YYYY-MM-DD)
device_idnumber任意デバイスIDフィルタ(1: スマートフォン / 2: PC / 3: タブレット)
pagenumber任意ページ番号
per_pagenumber任意1ページあたりの件数

CV速報

1 tool
listAgentsConversions 速報

CV速報: 直近のCV(コンバージョン)を取得します。period で last_30_minutes(default) / last_1_hour / today / yesterday を指定するか、start_time / end_time で ISO 8601 形式の期間を指定できます。

パラメータ型必須説明
periodstring任意プリセット期間。デフォルト: last_30_minutes。start_time と end_time が両方指定されている場合は無視される。
・last_30_minutes
・last_1_hour
・today
・yesterday
start_timestring任意ISO 8601 形式の日時(例: 2026-05-07T00:00:00+09:00)。end_time と併用された場合、period より優先される。
end_timestring任意ISO 8601 形式の日時(例: 2026-05-07T23:59:59+09:00)。start_time 指定時は必須。
pagenumber任意ページ番号
per_pagenumber任意1ページあたりの件数

認証

2 tools
authenticate OAuth

Squad beyond MCP サーバーへの OAuth フローを開始する。呼び出すと認可URLが返るので、ブラウザで開いて Squad beyond の認可を行う。認可完了後、上記の機能ツールが自動的に利用可能になる。

complete_authentication OAuth

ブラウザでの認可後にリダイレクトされた http://localhost:<port>/callback?code=...&state=... 形式のコールバックURLを送信して OAuth フローを完了する。リモートセッション等で自動完了できない場合のみ手動で呼び出す。

パラメータ型必須説明
callback_urlstring必須ブラウザのアドレスバーに表示された完全なコールバックURL