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
- Web サイト: https://supermetrics.com
- MCP サーバーのドキュメント:https://mcp.supermetrics.com
- サポート:https://support.supermetrics.com
ライセンス
プロプライエタリ — © スーパーメトリック
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの 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 つの方法のいずれかを選択します。
重要:ユーザーが言及した相対日付については、最初にget_todayツールを呼び出して現在の年と日付を知ってください。
期間に関するあいまいさ (たとえば、"今日"、"今週"、"最後の 8 月" などの語句) があいまいな場合は、 |
|
|
開始日
|
start_date | string |
date_range_type='custom' の場合は必須です。 受け入れる:
重要:ユーザーが言及した相対日付については、最初にget_todayツールを呼び出して現在の年と日付を知ってください。
時間参照に関するあいまいさがある場合 (たとえば、"今日"、"今週"、"月末" などの相対語句)、 |
|
|
終了日
|
end_date | string |
date_range_type='custom' の場合は必須です。 受け入れる:
重要:ユーザーが言及した相対日付については、最初にget_todayツールを呼び出して現在の年と日付を知ってください。
時間参照に関するあいまいさがある場合 (たとえば、"今日"、"今週"、"月末" などの相対語句)、 |
|
|
タイムゾーン
|
timezone | string |
必要に応じて、日付計算のタイムゾーンを設定します (例: "America/New_York"、"Europe/London"、"Asia/Tokyo")。 IANA タイムゾーン名を使用します。 指定しない場合は、UTC を使用します。 |
|
|
フィルター
|
filters | string |
フィルター式の文字列。 各条件の形式は、[field_name] [演算子] [値] 条件を AND/OR と組み合わせることができます。 サポートされる演算子:
例 :
|
|
|
設定
|
settings | object |
追加のクエリ構成。 JSON オブジェクト (例: {"show_all_time_values": true} を使用します。 特定のデータ ソース設定の高度な機能。 特定の要件がない限り、スキップします。 |
|
|
比較期間の種類
|
compare_type | string |
結果を以前の期間と比較する方法を選択します。
|
|
|
比較値の型
|
compare_show | string |
比較を表示する方法:
|
|
|
比較期間の開始日
|
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')。 |
戻り値
- Body
- DataqueryResponse
スキーマ情報を含むデータ ソースの使用可能なフィールドを検出する
スキーマ情報を含むデータ ソースの使用可能なフィールドを検出します。これを呼び出して、クエリを実行する前に、データ ソースの使用可能なメトリックとディメンションを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
データ ソース ID
|
ds_id | True | string |
data_source_discovery ツールを使用して取得できるデータ ソース ID。 例: Facebook 広告の場合は "FA"、Google 広告の場合は "AW"、Google アナリティクスの場合は "GAWA" です。 |
|
Field タイプ
|
field_type | string |
フィールドの種類 (ディメンションまたはメトリック) でフィルター処理する |
|
|
応答を圧縮する
|
compress | boolean |
応答の toon 圧縮を有効にする |
戻り値
スーパーメトリックから認証されたユーザー情報を取得する
使用可能なスーパーメトリック データ ソースを検出する
使用可能なスーパーメトリック データ ソースを検出します。これは通常、最初の手順です。これを呼び出して、データのクエリを実行する前に使用可能なデータ ソースを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
応答を圧縮する
|
compress | boolean |
応答の toon 圧縮を有効にする |
戻り値
健康診断
特定のデータ ソースの使用可能なアカウントを検出する
特定のデータ ソースで使用可能なアカウントを検出する データ クエリに必要なアカウント 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 |
戻り値
- Body
- GettodayResponse
定義
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' です。