次の方法で共有


SuperMCP (プレビュー)

SuperMCP by Supermetrics - Google Analytics、Facebook Ads、Google Ads などの接続されたプラットフォームからマーケティング データへのアクセスを提供する MCP (モデル コンテキスト プロトコル) サーバー。

この API を使用すると、LLM はマーケティング データのクエリ、データ ソースとアカウントの検出、使用可能なフィールドの探索、パフォーマンス メトリックの取得を行えます。

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate(パワーオートメート) Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 スーパーメトリック
URL https://supermetrics.com
コネクタ メタデータ
パブリッシャー スーパーメトリック
Web サイト https://supermetrics.com
プライバシー ポリシー https://supermetrics.com/privacy
カテゴリ Marketing

SuperMCP (スーパーメトリック) カスタム コネクタ

このコネクタを使用すると、Microsoft Power Automate、Power Apps、Azure Logic Apps を使用して 、SuperMCP (Supermetrics の MCP サーバー) を介してマーケティング データにクエリを実行できます。
これを使用して、データ ソースとアカウントの検出、使用可能なフィールドの探索、マーケティング パフォーマンス クエリの実行を行います。


パブリッシャー

Supermetrics

コネクタの種類

カスタム コネクタ (Swagger/OpenAPI 2.0)

サービス/API

SuperMCP API (MCP サーバー)

  • ホスト:mcp.supermetrics.com
  • 基本パス:/
  • スキーム:https

[前提条件]

以下が必要です。

  • カスタム コネクタを作成できる Power Automate または Power Apps 環境
  • 少なくとも 1 つの接続データ ソース (Google アナリティクス、Google 広告、Facebook 広告など) を含む スーパーメトリック ス アカウント。 Supermetrics アカウントをお持ちでない場合は、最初のログイン時に 14 日間の試用版が作成されます。

Authentication

このコネクタでは OAuth 2.0 を使用します


サポートされている操作

発見

  • 使用可能なスーパーメトリック データ ソースの検出 (POST /mcp/data_source_discovery)
  • データ ソースのアカウントを検出する (POST /mcp/accounts_discovery)
  • 使用可能なフィールドの検出 (POST /mcp/field_discovery)

データ クエリ

  • 非同期データ クエリの実行 (POST /mcp/data_query)
    • を返します。 schedule_id
  • 非同期クエリの結果を取得する (POST /mcp/get_async_query_results)
    • 結果が返されるまで schedule_id を使用する

ユーティリティ/リソース (通常は高度な可視性)

  • 今日の取得 (UTC) (POST /mcp/get_today)
  • 正常性チェック (GET /mcp/resources/health)

Support


ライセンス

プロプライエタリ — © スーパーメトリック

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

schedule_idを使用してデータ クエリの結果を取得する

schedule_idを使用してデータ クエリの結果を取得します。実際のクエリ結果を取得するには、data_queryのschedule_idでこれを使用します。

Supermetrics データ ソースからマーケティング データにクエリを実行する

Supermetrics データ ソースからマーケティング データにクエリを実行すると、schedule_idが返されます。実際のデータを取得するには、get_async_query_resultsを呼び出す必要があります。

スキーマ情報を含むデータ ソースの使用可能なフィールドを検出する

スキーマ情報を含むデータ ソースの使用可能なフィールドを検出します。これを呼び出して、クエリを実行する前に、データ ソースの使用可能なメトリックとディメンションを確認します。

スーパーメトリックから認証されたユーザー情報を取得する

スーパーメトリックから認証されたユーザー情報を取得する

使用可能なスーパーメトリック データ ソースを検出する

使用可能なスーパーメトリック データ ソースを検出します。これは通常、最初の手順です。これを呼び出して、データのクエリを実行する前に使用可能なデータ ソースを確認します。

健康診断

サーバーの正常性状態と構成情報を取得します。

特定のデータ ソースの使用可能なアカウントを検出する

特定のデータ ソースで使用可能なアカウントを検出する データ クエリに必要なアカウント ID を取得するには、data_source_discovery後にこれを呼び出します。

現在の UTC 日時情報を取得する

現在の UTC の日付と時刻の情報を取得します。ユーザーが "先月" や "昨日" などの相対日付に言及して現在の日付を把握する場合は、最初にこれを呼び出します。

schedule_idを使用してデータ クエリの結果を取得する

schedule_idを使用してデータ クエリの結果を取得します。実際のクエリ結果を取得するには、data_queryのschedule_idでこれを使用します。

パラメーター

名前 キー 必須 説明
スケジュール ID
schedule_id True string

data_query要求から返されるスケジュール ID。 スケジュール ID は、data_query応答で返されるのとまったく同じである必要があります。 ID を不透明として扱います。 逐語的にコピーします。 省略、書式、または言い換えはしないでください。

応答を圧縮する
compress boolean

応答の toon 圧縮を有効にする

戻り値

Supermetrics データ ソースからマーケティング データにクエリを実行する

Supermetrics データ ソースからマーケティング データにクエリを実行すると、schedule_idが返されます。実際のデータを取得するには、get_async_query_resultsを呼び出す必要があります。

パラメーター

名前 キー 必須 説明
データ ソース ID
ds_id True string

data_source_discovery ツールを使用して取得できるデータ ソース ID。 例: Facebook 広告の場合は "FA"、Google 広告の場合は "AW"、Google アナリティクスの場合は "GAWA" です。

ds_accounts
ds_accounts True array of string
fields
fields True array of string
日付範囲の種類
date_range_type string

次の 2 つの方法のいずれかを選択します。

  1. 'custom' を使用し、start_dateとend_dateを指定します。
  2. "last_X_Y" の形式で相対範囲を使用します (例: 'last_7_days'、'last_3_months')。
    • '_inc' を追加して、現在の期間を含めることができます (例: 'last_7_days_inc')。

重要:ユーザーが言及した相対日付については、最初にget_todayツールを呼び出して現在の年と日付を知ってください。 期間に関するあいまいさ (たとえば、"今日"、"今週"、"最後の 8 月" などの語句) があいまいな場合は、 get_today ツールを呼び出して現在の年と日付を確認し、その応答を使用してこのパラメーターを入力します。

開始日
start_date string

date_range_type='custom' の場合は必須です。 受け入れる:

  • YYYY-MM-DD 形式の正確な日付 (例: '2024-01-01')
  • 自然言語の日付 (例: "昨日"、"次の月曜日")

重要:ユーザーが言及した相対日付については、最初にget_todayツールを呼び出して現在の年と日付を知ってください。 時間参照に関するあいまいさがある場合 (たとえば、"今日"、"今週"、"月末" などの相対語句)、 get_today ツールを呼び出して現在の年と日付を確認し、その応答を使用してこのパラメーターを入力します。

終了日
end_date string

date_range_type='custom' の場合は必須です。 受け入れる:

  • YYYY-MM-DD 形式の正確な日付 (例: '2024-01-31')
  • 自然言語の日付 (例: "昨日"、"最後の金曜日")

重要:ユーザーが言及した相対日付については、最初にget_todayツールを呼び出して現在の年と日付を知ってください。 時間参照に関するあいまいさがある場合 (たとえば、"今日"、"今週"、"月末" などの相対語句)、 get_today ツールを呼び出して現在の年と日付を確認し、その応答を使用してこのパラメーターを入力します。

タイムゾーン
timezone string

必要に応じて、日付計算のタイムゾーンを設定します (例: "America/New_York"、"Europe/London"、"Asia/Tokyo")。 IANA タイムゾーン名を使用します。 指定しない場合は、UTC を使用します。

フィルター
filters string

フィルター式の文字列。 各条件の形式は、[field_name] [演算子] [値] 条件を AND/OR と組み合わせることができます。

サポートされる演算子:

  • '==' →等しい
  • '!=' →が等しくない
  • '>' →より大きい
  • '>=' →以上
  • '<' →より小さい
  • '<=' →次の値以下です
  • '=@' →に含まれている (大文字と小文字を区別せず、ディメンションのみ)
  • '!@' →に含まれていない (大文字と小文字を区別せず、ディメンションのみ)
  • '=~' →正規表現に一致します (次元のみ)
  • '!~' →が正規表現と一致しません (次元のみ)

例 :

  • "country == United States"
  • "country == United States OR country == Canada"
  • "sessions > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
設定
settings object

追加のクエリ構成。 JSON オブジェクト (例: {"show_all_time_values": true} を使用します。 特定のデータ ソース設定の高度な機能。 特定の要件がない限り、スキップします。

比較期間の種類
compare_type string

結果を以前の期間と比較する方法を選択します。

  • 'prev_range': 同じ長さの前の期間
  • 'prev_year': 前年の同じ期間
  • 'prev_year_weekday': 前年の同じ平日
  • 'custom': ユーザー定義の期間 (compare_start_dateとcompare_end_dateが必要)
比較値の型
compare_show string

比較を表示する方法:

  • 'perc_change': 変化率 (既定値)
  • 'abs_change': 絶対変更
  • 'value': 比較期間の生の値
比較期間の開始日
compare_start_date string

compare_type='custom' の場合は必須です。 カスタム比較期間の開始日 (YYYY-MM-DD 形式 (例: '2024-01-01')。

比較期間の終了日
compare_end_date string

compare_type='custom' の場合は必須です。 カスタム比較期間の終了日 (YYYY-MM-DD 形式 (例: '2024-01-31')。

戻り値

スキーマ情報を含むデータ ソースの使用可能なフィールドを検出する

スキーマ情報を含むデータ ソースの使用可能なフィールドを検出します。これを呼び出して、クエリを実行する前に、データ ソースの使用可能なメトリックとディメンションを確認します。

パラメーター

名前 キー 必須 説明
データ ソース ID
ds_id True string

data_source_discovery ツールを使用して取得できるデータ ソース ID。 例: Facebook 広告の場合は "FA"、Google 広告の場合は "AW"、Google アナリティクスの場合は "GAWA" です。

Field タイプ
field_type string

フィールドの種類 (ディメンションまたはメトリック) でフィルター処理する

応答を圧縮する
compress boolean

応答の toon 圧縮を有効にする

戻り値

スーパーメトリックから認証されたユーザー情報を取得する

スーパーメトリックから認証されたユーザー情報を取得する

パラメーター

名前 キー 必須 説明
object

戻り値

使用可能なスーパーメトリック データ ソースを検出する

使用可能なスーパーメトリック データ ソースを検出します。これは通常、最初の手順です。これを呼び出して、データのクエリを実行する前に使用可能なデータ ソースを確認します。

パラメーター

名前 キー 必須 説明
応答を圧縮する
compress boolean

応答の toon 圧縮を有効にする

戻り値

健康診断

サーバーの正常性状態と構成情報を取得します。

戻り値

response
string

特定のデータ ソースの使用可能なアカウントを検出する

特定のデータ ソースで使用可能なアカウントを検出する データ クエリに必要なアカウント ID を取得するには、data_source_discovery後にこれを呼び出します。

パラメーター

名前 キー 必須 説明
データ ソース ID
ds_id True string

data_source_discovery ツールを使用して取得できるデータ ソース ID。 例: Facebook 広告の場合は "FA"、Google 広告の場合は "AW"、Google アナリティクスの場合は "GAWA" です。

応答を圧縮する
compress boolean

応答の toon 圧縮を有効にする

戻り値

現在の UTC 日時情報を取得する

現在の UTC の日付と時刻の情報を取得します。ユーザーが "先月" や "昨日" などの相対日付に言及して現在の日付を把握する場合は、最初にこれを呼び出します。

パラメーター

名前 キー 必須 説明
object

戻り値

定義

AccountsdiscoveryResponse

名前 パス 説明
成功
success boolean
アカウント
data.accounts array of object
account_id
data.accounts.account_id string
account_name
data.accounts.account_name string

DataqueryResponse

名前 パス 説明
成功
success boolean
schedule_id
data.schedule_id string

DatasourcediscoveryResponse

名前 パス 説明
成功
success boolean
data_sources
data.data_sources array of object
id
data.data_sources.id string
名前
data.data_sources.name string
カテゴリ
data.data_sources.category string

FielddiscoveryResponse

名前 パス 説明
成功
success boolean
データソース
data.data_source string
トータル
data.total integer
メトリクス
data.metrics array of object
id
data.metrics.id string
名前
data.metrics.name string
説明
data.metrics.description string
dimensions
data.dimensions array of object
id
data.dimensions.id string
名前
data.dimensions.name string
説明
data.dimensions.description string

GetasyncqueryresultsResponse

名前 パス 説明
成功
success boolean
データ
data.data array of object
items
data.data object
状態
data.status string

GettodayResponse

名前 パス 説明
成功
success boolean
date
data.date date
iso_string
data.iso_string string
timestamp
data.timestamp integer

UserinfoResponse

名前 パス 説明
成功
success boolean
ユーザーID
data.user_id string
メール
data.email string
名前
data.name string

文字列

これは基本的なデータ型 'string' です。