SuperMCP （预览版）

SupermCP by Supermetrics - MCP （模型上下文协议）服务器，提供从连接的平台（如 Google Analytics、Facebook 广告、Google Ads 等）访问营销数据的访问权限。

此 API 使 LLM 能够查询营销数据、发现数据源和帐户、浏览可用字段以及检索性能指标。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	Supermetrics
URL	https://supermetrics.com

连接器元数据
发布者	Supermetrics
网站	https://supermetrics.com
隐私策略	https://supermetrics.com/privacy
类别	Marketing

SuperMCP （超对称）自定义连接器

此连接器允许Microsoft Power Automate、Power Apps 和 Azure 逻辑应用通过 SuperMCP （Supermetrics 的 MCP 服务器）查询营销数据。
使用它可发现数据源和帐户、浏览可用字段并运行市场营销性能查询。

发布者

Supermetrics

连接器类型

自定义连接器（Swagger/OpenAPI 2.0）

服务/API

SuperMCP API （MCP 服务器）

主机：mcp.supermetrics.com
基本路径：/
方案：https

先决条件

您将需要：

Power Automate 或 Power Apps 环境，可在其中创建自定义 连接器
具有至少一个连接的数据源（例如 Google Analytics、Google Ads、Facebook Ads 等）的 超级对称 帐户。如果没有 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

网站：https://supermetrics.com
MCP 服务器文档：https://mcp.supermetrics.com
支持：https://support.supermetrics.com

许可证

专有 — © 超对称

限制

名称	调用	续订期
每个连接的 API 调用	100	60 秒

操作

从 Supermetrics 检索经过身份验证的用户信息	从 Supermetrics 检索经过身份验证的用户信息
从超对称数据源查询营销数据	从 Supermetrics 数据源查询营销数据这返回schedule_id - 然后必须调用get_async_query_results来获取实际数据。
使用 schedule_id 检索数据查询的结果	使用schedule_id通过data_query中的schedule_id检索数据查询的结果，以检索实际查询结果。
使用架构信息发现数据源的可用字段	使用架构信息发现数据源的可用字段。调用此项可在查询之前查看数据源的可用指标和维度。
健康检查	获取服务器运行状况和配置信息。
发现可用的超对称数据源	发现可用的超对称数据源通常是第一步 - 调用此项以查看在查询数据之前可用的数据源。
发现特定数据源的可用帐户	发现特定数据源的可用帐户，在data_source_discovery后调用此帐户以获取数据查询所需的帐户 ID。
获取当前 UTC 日期和时间信息	获取当前 UTC 日期和时间信息，当用户提及相对日期（如“上月”或“昨天”）时，请首先调用此日期以了解当前日期。

从 Supermetrics 检索经过身份验证的用户信息

操作 ID:: userinfo

从 Supermetrics 检索经过身份验证的用户信息

参数

名称	密钥	必需	类型	说明
			object

Body: UserinfoResponse

从超对称数据源查询营销数据

操作 ID:: dataquery

从 Supermetrics 数据源查询营销数据这返回schedule_id - 然后必须调用get_async_query_results来获取实际数据。

参数

名称	密钥	必需	类型	说明
数据源 ID	ds_id	True	string	可以使用data_source_discovery工具检索的数据源 ID。示例：Facebook 广告的“FA”、Google Ads 的“AW”、Google Analytics 的“GAWA”。
ds_accounts	ds_accounts	True	array of string
字段	fields	True	array of string
日期范围类型	date_range_type		string	选择以下两种方法之一：使用“custom”并提供start_date和end_date。使用格式为“last_X_Y”（例如“last_7_days”、“last_3_months”）的相对范围。可以追加“_inc”以包括当前时间段（例如“last_7_days_inc”）。重要说明：对于用户提及的任何相对日期，FIRST 调用get_today工具了解当前年份和日期！如果时间段存在任何歧义（例如“today”、“this week”、“last August”或类似短语的含义），请调用 `get_today` 该工具以确认当前年份和日期，然后使用该响应填充此参数。
开始日期	start_date		string	如果date_range_type='custom'，则为必需。接受： YYYY-MM-DD 格式的确切日期（例如，“2024-01-01”）自然语言日期（例如“昨天”、“下周一”）重要说明：对于用户提及的任何相对日期，FIRST 调用get_today工具了解当前年份和日期！如果时间引用存在歧义（例如“today”、“this week”、“month of month”等相对短语），请调用 `get_today` 该工具以确认当前年份和日期，然后使用该响应填充此参数。
结束日期	end_date		string	如果date_range_type='custom'，则为必需。接受： YYYY-MM-DD 格式的确切日期（例如，“2024-01-31”）自然语言日期（例如“昨天”、“上周五”）重要说明：对于用户提及的任何相对日期，FIRST 调用get_today工具了解当前年份和日期！如果时间引用存在歧义（例如“today”、“this week”、“month of month”等相对短语），请调用 `get_today` 该工具以确认当前年份和日期，然后使用该响应填充此参数。
时区	timezone		string	（可选）为日期计算设置时区（例如“美国/New_York”、“欧洲/伦敦”、“亚洲/东京”。使用 IANA 时区名称。如果未指定，请使用 UTC。
过滤器	filters		string	筛选表达式字符串。每个条件都有格式：[field_name] [运算符] [值] 条件可以与 AND / OR 组合使用。支持的运算符： “==” →等于 “！=” →不等于 “”> →大于 “>=” →大于或等于 “<” →小于 “<=” →小于或等于 “=@”→包含（不区分大小写，仅维度） “！@”→不包含（不区分大小写，仅维度） “=~”→匹配正则表达式（仅维度） “！~”→与正则表达式不匹配（仅维度）示例： “country == United States” “country == 美国或国家/地区 == 加拿大” “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'，则为必需。自定义比较周期的开始日期，采用 YYY-MM-DD 格式（例如，“2024-01-01”）。
比较周期结束日期	compare_end_date		string	如果compare_type='custom'，则为必需。自定义比较周期的结束日期，采用 YYY-MM-DD 格式（例如，“2024-01-31”）。

Body: DataqueryResponse

使用 schedule_id 检索数据查询的结果

操作 ID:: getasyncqueryresults

使用schedule_id通过data_query中的schedule_id检索数据查询的结果，以检索实际查询结果。

参数

名称	密钥	必需	类型	说明
计划 ID	schedule_id	True	string	从data_query请求返回的计划 ID。计划 ID 必须与data_query响应中返回的 ID 完全相同。将 ID 视为不透明。复制逐字。请勿缩写、格式或参数。
压缩响应	compress		boolean	为响应启用 toon 压缩

Body: GetasyncqueryresultsResponse

使用架构信息发现数据源的可用字段

操作 ID:: fielddiscovery

使用架构信息发现数据源的可用字段。调用此项可在查询之前查看数据源的可用指标和维度。

参数

名称	密钥	必需	类型	说明
数据源 ID	ds_id	True	string	可以使用data_source_discovery工具检索的数据源 ID。示例：Facebook 广告的“FA”、Google Ads 的“AW”、Google Analytics 的“GAWA”。
字段类型	field_type		string	按字段类型（维度或指标）进行筛选
压缩响应	compress		boolean	为响应启用 toon 压缩

Body: FielddiscoveryResponse

健康检查

操作 ID:: healthCheck

获取服务器运行状况和配置信息。

response: string

发现可用的超对称数据源

操作 ID:: datasourcediscovery

发现可用的超对称数据源通常是第一步 - 调用此项以查看在查询数据之前可用的数据源。

参数

名称	密钥	必需	类型	说明
压缩响应	compress		boolean	为响应启用 toon 压缩

Body: DatasourcediscoveryResponse

发现特定数据源的可用帐户

操作 ID:: accountsdiscovery

发现特定数据源的可用帐户，在data_source_discovery后调用此帐户以获取数据查询所需的帐户 ID。

参数

名称	密钥	必需	类型	说明
数据源 ID	ds_id	True	string	可以使用data_source_discovery工具检索的数据源 ID。示例：Facebook 广告的“FA”、Google Ads 的“AW”、Google Analytics 的“GAWA”。
压缩响应	compress		boolean	为响应启用 toon 压缩

Body: AccountsdiscoveryResponse

获取当前 UTC 日期和时间信息

操作 ID:: gettoday

获取当前 UTC 日期和时间信息，当用户提及相对日期（如“上月”或“昨天”）时，请首先调用此日期以了解当前日期。

参数

名称	密钥	必需	类型	说明
			object

Body: GettodayResponse

定义

AccountsdiscoveryResponse

名称	路径	类型
success	success	boolean
accounts	data.accounts	array of object
account_id	data.accounts.account_id	string
account_name	data.accounts.account_name	string

DataqueryResponse

名称	路径	类型	说明
success	success	boolean
schedule_id	data.schedule_id	string

DatasourcediscoveryResponse

名称	路径	类型
success	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	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	success	boolean
数据	data.data	array of object
items	data.data	object
状态	data.status	string

GettodayResponse

名称	路径	类型
success	success	boolean
date	data.date	date
iso_string	data.iso_string	string
时间戳	data.timestamp	integer

UserinfoResponse

名称	路径	类型
success	success	boolean
用户ID	data.user_id	string
电子邮件	data.email	string
姓名	data.name	string

字符串

这是基本数据类型“string”。

通过

SuperMCP （预览版）

SuperMCP （超对称） 自定义连接器

发布者

连接器类型

服务/API

先决条件

Authentication

支持的操作

发现

数据查询

实用工具/资源（通常是高级可见性）

Support

许可证

限制

操作

从 Supermetrics 检索经过身份验证的用户信息

参数

返回

从超对称数据源查询营销数据

参数

返回

使用 schedule_id 检索数据查询的结果

参数

返回

使用架构信息发现数据源的可用字段

参数

返回

健康检查

返回

发现可用的超对称数据源

参数

返回

发现特定数据源的可用帐户

参数

返回

获取当前 UTC 日期和时间信息

参数

返回

定义

AccountsdiscoveryResponse

DataqueryResponse

DatasourcediscoveryResponse

FielddiscoveryResponse

GetasyncqueryresultsResponse

GettodayResponse

UserinfoResponse

字符串

SuperMCP （超对称）自定义连接器