MCP 도구
단계별 안내형 보고서 템플릿 버전 저장
sosoapi_save_report_template단계별 안내형 보고서 템플릿 버전 저장. 명시적으로 지정된 검토 완료 데이터셋과 버전을 사용하며, 데이터 소스를 자동으로 새로 고치지 않습니다. 렌더링 입력은 파이프를 통해 sosoapi report render --output FILE 명령으로 전달할 수 있습니다.
Markdown으로 읽기프로필 및 전송 방식
프로필: full · 전송 방식: stdio, http
클라이언트에 표시할 도구는 core 또는 full로 선택하세요. 권한은 변경되지 않습니다. 로컬 파일 업로드에는 stdio가 필요하며 HTTP에서는 사용할 수 없습니다. 검색에 출력 스키마를 포함하려면 SOSOAPI_OUTPUT_SCHEMAS=1을 설정하세요. 이 설정과 관계없이 도구는 구조화된 결과를 반환합니다.
권한 및 부수 효과
주석은 클라이언트의 도구 설명을 돕습니다. 각 호출은 계속 사용자 인증, 역할, 리소스 접근, 기능 권한을 확인합니다.
{
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}- /analytics-api/reporting/templates/save: agent:operate · synchronous_http_response
입력 필드
필수는 상위 객체와 선택 분기 안에서 필수라는 뜻입니다. 필수 자식이 선택적 상위 객체를 필수로 만들지는 않습니다. 아래 규칙과 필드명은 계약에서 복사했습니다.
| 필드 / 분기 | 유형 / 필수 여부 | 제약 조건 |
|---|---|---|
$ | object상위 객체에서 필수 |
|
workspace_id | string상위 객체에서 필수 |
|
template | object상위 객체에서 필수 |
|
template.id | string상위 객체에서 필수 |
|
template.version | integer상위 객체에서 필수 |
|
template.name | string상위 객체에서 필수 |
|
template.format | string상위 객체에서 필수 |
|
template.sourceBase64 | string상위 객체에서 필수 |
|
template.sourceSha256 | string상위 객체에서 필수 |
|
template.mappings | object상위 객체에서 필수 |
|
template.mappings.* | object선택 / 항목 | — |
template.mappings.*anyOf 1 | object선택 / 항목 |
|
template.mappings.*.kindanyOf 1 | string상위 객체에서 필수 |
|
template.mappings.*.valueanyOf 1 | string상위 객체에서 필수 |
|
template.mappings.*anyOf 2 | object선택 / 항목 |
|
template.mappings.*.kindanyOf 2 | string상위 객체에서 필수 |
|
template.mappings.*.fieldanyOf 2 | string상위 객체에서 필수 |
|
template.mappings.*anyOf 3 | object선택 / 항목 |
|
template.mappings.*.kindanyOf 3 | string상위 객체에서 필수 |
|
template.mappings.*.platformanyOf 3 | string상위 객체에서 필수 |
|
template.mappings.*.keyanyOf 3 | string상위 객체에서 필수 |
|
template.mappings.*.unitanyOf 3 | string상위 객체에서 필수 |
|
template.mappings.*.grainanyOf 3 | string상위 객체에서 필수 |
|
template.mappings.*.measurementKindanyOf 3 | string상위 객체에서 필수 |
|
template.mappings.*.accountIdanyOf 3 | string선택 / 항목 |
|
template.mappings.*.providerResourceIdanyOf 3 | string | null선택 / 항목 | — |
template.mappings.*.providerResourceIdanyOf 3 / anyOf 1 | string선택 / 항목 |
|
template.mappings.*.providerResourceIdanyOf 3 / anyOf 2 | null선택 / 항목 | — |
template.mappings.*.sourcePathanyOf 3 | string선택 / 항목 |
|
template.mappings.*.requestIdanyOf 3 | string | null선택 / 항목 | — |
template.mappings.*.requestIdanyOf 3 / anyOf 1 | string선택 / 항목 |
|
template.mappings.*.requestIdanyOf 3 / anyOf 2 | null선택 / 항목 | — |
template.mappings.*anyOf 4 | object선택 / 항목 |
|
template.mappings.*.kindanyOf 4 | string상위 객체에서 필수 |
|
template.mappings.*.idanyOf 4 | string상위 객체에서 필수 |
|
template.mappings.*.versionanyOf 4 | integer상위 객체에서 필수 |
|
template.mappings.*anyOf 5 | object선택 / 항목 |
|
template.mappings.*.kindanyOf 5 | string상위 객체에서 필수 |
|
template.mappings.*.sourceanyOf 5 | string상위 객체에서 필수 |
|
template.mappings.*.limitanyOf 5 | integer상위 객체에서 필수 |
|
template.mappings.*anyOf 6 | object선택 / 항목 |
|
template.mappings.*.kindanyOf 6 | string상위 객체에서 필수 |
|
template.mappings.*.sourceanyOf 6 | string상위 객체에서 필수 |
|
expected_version | integer | null상위 객체에서 필수 | — |
expected_versionanyOf 1 | integer상위 객체에서 필수 |
|
expected_versionanyOf 2 | null상위 객체에서 필수 | — |
mutation_id | string상위 객체에서 필수 |
|
전체 JSON Schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"template": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"version": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"format": {
"type": "string",
"enum": [
"pptx",
"docx",
"xlsx"
]
},
"sourceBase64": {
"type": "string",
"maxLength": 12582912,
"pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
},
"sourceSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"mappings": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"text"
]
},
"value": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"kind",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"selection"
]
},
"field": {
"type": "string",
"enum": [
"accounts",
"period",
"timezone",
"platforms",
"dataset",
"reviewed",
"coverage"
]
}
},
"required": [
"kind",
"field"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"metric"
]
},
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 150
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"grain": {
"type": "string",
"enum": [
"post",
"account"
]
},
"measurementKind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"accountId": {
"type": "string",
"format": "uuid"
},
"providerResourceId": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 512
},
{
"type": "null"
}
]
},
"sourcePath": {
"type": "string",
"maxLength": 2000
},
"requestId": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"platform",
"key",
"unit",
"grain",
"measurementKind"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"formula"
]
},
"id": {
"type": "string",
"format": "uuid"
},
"version": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
}
},
"required": [
"kind",
"id",
"version"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"table"
]
},
"source": {
"type": "string",
"enum": [
"measurements",
"formulas"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"kind",
"source",
"limit"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"chart"
]
},
"source": {
"type": "string",
"enum": [
"publication_by_platform"
]
}
},
"required": [
"kind",
"source"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"id",
"version",
"name",
"format",
"sourceBase64",
"sourceSha256",
"mappings"
],
"additionalProperties": false
},
"expected_version": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
{
"type": "null"
}
]
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"template",
"expected_version",
"mutation_id"
],
"additionalProperties": false
}구조화된 출력
이 스키마는 성공한 도구 결과의 structuredContent를 설명합니다. MCP 응답에는 content도 포함되며 호출 실패 시 isError가 설정될 수 있습니다. 게시 시 접수된 요청이나 텍스트 응답을 확인으로 간주하지 말고 게시물의 최종 결과를 읽으세요. 연결된 API 작업에 권한과 재시도 규칙이 설명되어 있습니다.
필수는 상위 객체와 선택 분기 안에서 필수라는 뜻입니다. 필수 자식이 선택적 상위 객체를 필수로 만들지는 않습니다. 아래 규칙과 필드명은 계약에서 복사했습니다.
| 필드 / 분기 | 유형 / 필수 여부 | 제약 조건 |
|---|---|---|
$ | object상위 객체에서 필수 |
|
contractVersion | string상위 객체에서 필수 |
|
workspaceId | string상위 객체에서 필수 |
|
id | string상위 객체에서 필수 |
|
version | integer상위 객체에서 필수 |
|
name | string상위 객체에서 필수 |
|
format | string상위 객체에서 필수 |
|
sourceBase64 | string상위 객체에서 필수 |
|
sourceSha256 | string상위 객체에서 필수 |
|
mappings | object상위 객체에서 필수 |
|
mappings.* | object선택 / 항목 | — |
mappings.*oneOf 1 | object선택 / 항목 |
|
mappings.*.kindoneOf 1 | string상위 객체에서 필수 |
|
mappings.*.valueoneOf 1 | string상위 객체에서 필수 |
|
mappings.*oneOf 2 | object선택 / 항목 |
|
mappings.*.kindoneOf 2 | string상위 객체에서 필수 |
|
mappings.*.fieldoneOf 2 | string상위 객체에서 필수 |
|
mappings.*oneOf 3 | object선택 / 항목 |
|
mappings.*.kindoneOf 3 | string상위 객체에서 필수 |
|
mappings.*.platformoneOf 3 | string상위 객체에서 필수 |
|
mappings.*.keyoneOf 3 | string상위 객체에서 필수 |
|
mappings.*.unitoneOf 3 | string상위 객체에서 필수 |
|
mappings.*.grainoneOf 3 | string상위 객체에서 필수 |
|
mappings.*.measurementKindoneOf 3 | string상위 객체에서 필수 |
|
mappings.*.accountIdoneOf 3 | string선택 / 항목 |
|
mappings.*.providerResourceIdoneOf 3 | string | null선택 / 항목 | — |
mappings.*.providerResourceIdoneOf 3 / anyOf 1 | string선택 / 항목 |
|
mappings.*.providerResourceIdoneOf 3 / anyOf 2 | null선택 / 항목 | — |
mappings.*.sourcePathoneOf 3 | string선택 / 항목 |
|
mappings.*.requestIdoneOf 3 | string | null선택 / 항목 | — |
mappings.*.requestIdoneOf 3 / anyOf 1 | string선택 / 항목 |
|
mappings.*.requestIdoneOf 3 / anyOf 2 | null선택 / 항목 | — |
mappings.*oneOf 4 | object선택 / 항목 |
|
mappings.*.kindoneOf 4 | string상위 객체에서 필수 |
|
mappings.*.idoneOf 4 | string상위 객체에서 필수 |
|
mappings.*.versiononeOf 4 | integer상위 객체에서 필수 |
|
mappings.*oneOf 5 | object선택 / 항목 |
|
mappings.*.kindoneOf 5 | string상위 객체에서 필수 |
|
mappings.*.sourceoneOf 5 | string상위 객체에서 필수 |
|
mappings.*.limitoneOf 5 | integer상위 객체에서 필수 |
|
mappings.*oneOf 6 | object선택 / 항목 |
|
mappings.*.kindoneOf 6 | string상위 객체에서 필수 |
|
mappings.*.sourceoneOf 6 | string상위 객체에서 필수 |
|
createdAt | string상위 객체에서 필수 |
|
전체 JSON Schema
{
"type": "object",
"properties": {
"contractVersion": {
"type": "string",
"const": "analytics-template/v1"
},
"workspaceId": {
"type": "string",
"format": "uuid"
},
"id": {
"type": "string",
"format": "uuid"
},
"version": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"format": {
"type": "string",
"enum": [
"pptx",
"docx",
"xlsx"
]
},
"sourceBase64": {
"type": "string",
"maxLength": 12582912,
"pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
},
"sourceSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"mappings": {
"type": "object",
"propertyNames": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,63}$"
},
"additionalProperties": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "text"
},
"value": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"kind",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "selection"
},
"field": {
"type": "string",
"enum": [
"accounts",
"period",
"timezone",
"platforms",
"dataset",
"reviewed",
"coverage"
]
}
},
"required": [
"kind",
"field"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "metric"
},
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 150
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"grain": {
"type": "string",
"enum": [
"post",
"account"
]
},
"measurementKind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"accountId": {
"type": "string",
"format": "uuid"
},
"providerResourceId": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 512
},
{
"type": "null"
}
]
},
"sourcePath": {
"type": "string",
"maxLength": 2000
},
"requestId": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"platform",
"key",
"unit",
"grain",
"measurementKind"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "formula"
},
"id": {
"type": "string",
"format": "uuid"
},
"version": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
}
},
"required": [
"kind",
"id",
"version"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "table"
},
"source": {
"type": "string",
"enum": [
"measurements",
"formulas"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"kind",
"source",
"limit"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "chart"
},
"source": {
"type": "string",
"const": "publication_by_platform"
}
},
"required": [
"kind",
"source"
],
"additionalProperties": false
}
]
}
},
"createdAt": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
}
},
"required": [
"contractVersion",
"workspaceId",
"id",
"version",
"name",
"format",
"sourceBase64",
"sourceSha256",
"mappings",
"createdAt"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}도구 호출 예제
예제는 스키마로 확인한 가상 값을 사용합니다. ID를 사용 권한이 있는 값으로, 미디어를 준비된 에셋으로, 날짜를 확인된 게시 시각으로 바꾸세요. 쓰기 제출 전에 계정 적격성을 확인하세요. 이 페이지는 API 요청을 보내지 않습니다.
{
"name": "sosoapi_save_report_template",
"arguments": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"template": {
"id": "11111111-1111-4111-8111-111111111111",
"version": 1,
"name": "example",
"format": "pptx",
"sourceBase64": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sourceSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"mappings": {}
},
"expected_version": null,
"mutation_id": "11111111-1111-4111-8111-111111111111"
}
}structuredContent
{
"contractVersion": "analytics-template/v1",
"workspaceId": "11111111-1111-4111-8111-111111111111",
"id": "11111111-1111-4111-8111-111111111111",
"version": 1,
"name": "example",
"format": "pptx",
"sourceBase64": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sourceSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"mappings": {},
"createdAt": "2099-01-15T09:00:00Z"
}