SuperMCP(미리 보기)
SuperMCP by Supermetrics - Google Analytics, Facebook Ads, Google Ads 등과 같은 연결된 플랫폼에서 마케팅 데이터에 액세스할 수 있는 MCP(모델 컨텍스트 프로토콜) 서버입니다.
이 API를 사용하면 LLM이 마케팅 데이터를 쿼리하고, 데이터 원본 및 계정을 검색하고, 사용 가능한 필드를 탐색하고, 성능 메트릭을 검색할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate (파워 오토메이트) | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 슈퍼 메트릭 |
| URL | https://supermetrics.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 슈퍼 메트릭 |
| 웹 사이트 | https://supermetrics.com |
| 개인 정보 보호 정책 | https://supermetrics.com/privacy |
| 카테고리 | 마케팅 |
SuperMCP(슈퍼 메트릭) 사용자 지정 커넥터
이 커넥터를 사용하면 Microsoft Power Automate, Power Apps 및 Azure Logic Apps가 SuperMCP(슈퍼 메트릭의 MCP 서버)를 통해 마케팅 데이터를 쿼리할 수 있습니다.
이를 사용하여 데이터 원본 및 계정을 검색하고, 사용 가능한 필드를 탐색하고, 마케팅 성과 쿼리를 실행합니다.
게시자
Supermetrics
커넥터 유형
사용자 지정 커넥터(Swagger/OpenAPI 2.0)
서비스/API
SuperMCP API(MCP 서버)
-
호스트:
mcp.supermetrics.com -
기본 경로:
/ -
구성표:
https
필수 조건
다음이 필요합니다.
- 사용자 지정 커넥터를 만들 수 있는 Power Automate 또는 Power Apps 환경
- 하나 이상의 연결된 데이터 원본이 있는 슈퍼 메트릭 계정(예: Google Analytics, Google Ads, Facebook 광고 등). 슈퍼 메트릭 계정이 없는 경우 첫 번째 로그인 시 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
License
독점 — © 슈퍼 메트릭
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| schedule_id 사용하여 데이터 쿼리의 결과 검색 |
schedule_id 사용하여 데이터 쿼리의 결과를 검색합니다. data_query schedule_id 사용하여 실제 쿼리 결과를 검색합니다. |
| 사용 가능한 슈퍼 메트릭 데이터 원본 검색 |
사용 가능한 슈퍼 메트릭 데이터 원본 검색 이것은 일반적으로 첫 번째 단계입니다. 데이터를 쿼리하기 전에 사용할 수 있는 데이터 원본을 확인하려면 이 단계를 호출합니다. |
| 상태 확인 |
서버 상태 및 구성 정보를 가져옵니다. |
| 슈퍼 메트릭 데이터 원본에서 마케팅 데이터 쿼리 |
슈퍼 메트릭 데이터 원본에서 마케팅 데이터 쿼리- schedule_id 반환합니다. 그러면 get_async_query_results 호출하여 실제 데이터를 가져와야 합니다. |
| 슈퍼 메트릭에서 인증된 사용자 정보 검색 |
슈퍼 메트릭에서 인증된 사용자 정보 검색 |
| 스키마 정보를 사용하여 데이터 원본에 사용 가능한 필드 검색 |
스키마 정보를 사용하여 데이터 원본에 사용 가능한 필드를 검색합니다. 쿼리하기 전에 데이터 원본에 대해 사용 가능한 메트릭 및 차원을 보려면 이 호출을 호출합니다. |
| 특정 데이터 원본에 사용 가능한 계정 검색 |
특정 데이터 원본에 사용 가능한 계정 검색 data_source_discovery 후 이를 호출하여 데이터 쿼리에 필요한 계정 ID를 가져옵니다. |
| 현재 UTC 날짜 및 시간 정보 가져오기 |
현재 UTC 날짜 및 시간 정보를 가져옵니다. 사용자가 '지난 달' 또는 '어제'와 같은 상대 날짜를 언급하여 현재 날짜를 알면 먼저 호출합니다. |
schedule_id 사용하여 데이터 쿼리의 결과 검색
schedule_id 사용하여 데이터 쿼리의 결과를 검색합니다. data_query schedule_id 사용하여 실제 쿼리 결과를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
일정 ID
|
schedule_id | True | string |
data_query 요청에서 반환된 일정 ID입니다. 일정 ID는 data_query 응답에서 반환된 것과 정확히 동일해야 합니다. ID를 불투명한 것으로 처리합니다. 축자 복사 약어, 서식 또는 구문은 사용하지 마세요. |
|
응답 압축
|
compress | boolean |
응답에 대해 툰 압축 사용 |
반환
사용 가능한 슈퍼 메트릭 데이터 원본 검색
사용 가능한 슈퍼 메트릭 데이터 원본 검색 이것은 일반적으로 첫 번째 단계입니다. 데이터를 쿼리하기 전에 사용할 수 있는 데이터 원본을 확인하려면 이 단계를 호출합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
응답 압축
|
compress | boolean |
응답에 대해 툰 압축 사용 |
반환
상태 확인
슈퍼 메트릭 데이터 원본에서 마케팅 데이터 쿼리
슈퍼 메트릭 데이터 원본에서 마케팅 데이터 쿼리- schedule_id 반환합니다. 그러면 get_async_query_results 호출하여 실제 데이터를 가져와야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
데이터 원본 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
|
fields | True | array of string | |
|
날짜 범위 유형
|
date_range_type | string |
다음 두 가지 방법 중 하나를 선택합니다.
중요: 사용자가 언급한 상대 날짜의 경우 먼저 get_today 도구를 호출하여 현재 연도와 날짜를 확인합니다.
기간에 대한 모호성이 있는 경우(예: '오늘', '이번 주', '지난 8월' 또는 이와 유사한 구의 의미) 도구를 호출 |
|
|
시작 날짜
|
start_date | string |
date_range_type='custom'인 경우 필수입니다. 받아:
중요: 사용자가 언급한 상대 날짜의 경우 먼저 get_today 도구를 호출하여 현재 연도와 날짜를 확인합니다.
시간 참조(예: 'today', 'this week', 'end of month'와 같은 상대 구)에 대한 모호성이 있는 경우 도구를 호출 |
|
|
종료 날짜
|
end_date | string |
date_range_type='custom'인 경우 필수입니다. 받아:
중요: 사용자가 언급한 상대 날짜의 경우 먼저 get_today 도구를 호출하여 현재 연도와 날짜를 확인합니다.
시간 참조(예: 'today', 'this week', 'end of month'와 같은 상대 구)에 대한 모호성이 있는 경우 도구를 호출 |
|
|
시간대
|
timezone | string |
필요에 따라 날짜 계산의 표준 시간대를 설정합니다(예: '아메리카/New_York', '유럽/런던', '아시아/도쿄'). IANA 표준 시간대 이름을 사용합니다. 지정하지 않으면 UTC를 사용합니다. |
|
|
필터
|
filters | string |
필터 식 문자열입니다. 각 조건에는 [field_name] [연산자] [value] 조건을 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')입니다. |
반환
슈퍼 메트릭에서 인증된 사용자 정보 검색
스키마 정보를 사용하여 데이터 원본에 사용 가능한 필드 검색
스키마 정보를 사용하여 데이터 원본에 사용 가능한 필드를 검색합니다. 쿼리하기 전에 데이터 원본에 대해 사용 가능한 메트릭 및 차원을 보려면 이 호출을 호출합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
데이터 원본 ID
|
ds_id | True | string |
data_source_discovery 도구를 사용하여 검색할 수 있는 데이터 원본 ID입니다. 예: Facebook 광고의 'FA', Google Ads의 경우 'AW', Google Analytics의 경우 'GAWA'. |
|
필드 유형
|
field_type | string |
필드 형식(차원 또는 메트릭)을 기준으로 필터링 |
|
|
응답 압축
|
compress | boolean |
응답에 대해 툰 압축 사용 |
반환
특정 데이터 원본에 사용 가능한 계정 검색
특정 데이터 원본에 사용 가능한 계정 검색 data_source_discovery 후 이를 호출하여 데이터 쿼리에 필요한 계정 ID를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
데이터 원본 ID
|
ds_id | True | string |
data_source_discovery 도구를 사용하여 검색할 수 있는 데이터 원본 ID입니다. 예: Facebook 광고의 'FA', Google Ads의 경우 'AW', Google Analytics의 경우 'GAWA'. |
|
응답 압축
|
compress | boolean |
응답에 대해 툰 압축 사용 |
반환
현재 UTC 날짜 및 시간 정보 가져오기
현재 UTC 날짜 및 시간 정보를 가져옵니다. 사용자가 '지난 달' 또는 '어제'와 같은 상대 날짜를 언급하여 현재 날짜를 알면 먼저 호출합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
|
object |
반환
정의
AccountsdiscoveryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
accounts
|
data.accounts | array of object | |
|
account_id
|
data.accounts.account_id | string | |
|
account_name
|
data.accounts.account_name | string |
DataqueryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
schedule_id
|
data.schedule_id | string |
DatasourcediscoveryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
data_sources
|
data.data_sources | array of object | |
|
아이디
|
data.data_sources.id | string | |
|
이름
|
data.data_sources.name | string | |
|
카테고리
|
data.data_sources.category | string |
FielddiscoveryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
데이터_소스
|
data.data_source | string | |
|
합계
|
data.total | integer | |
|
metrics
|
data.metrics | array of object | |
|
아이디
|
data.metrics.id | string | |
|
이름
|
data.metrics.name | string | |
|
description
|
data.metrics.description | string | |
|
차원
|
data.dimensions | array of object | |
|
아이디
|
data.dimensions.id | string | |
|
이름
|
data.dimensions.name | string | |
|
description
|
data.dimensions.description | string |
GetasyncqueryresultsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
데이터
|
data.data | array of object | |
|
items
|
data.data | object | |
|
status
|
data.status | string |
GettodayResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
date
|
data.date | date | |
|
iso_string
|
data.iso_string | string | |
|
시간표시
|
data.timestamp | integer |
UserinfoResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean | |
|
사용자_아이디
|
data.user_id | string | |
|
메일 주소
|
data.email | string | |
|
이름
|
data.name | string |
문자열
기본 데이터 형식 'string'입니다.