# MCP 도구 참조

- [MCP 도구 참조](https://sosoapi.ai/ko/docs/mcp): 도구 입력, 출력, 프로필, 로컬 또는 호스팅 지원 여부를 확인하세요.
- [사용자 프로필 조회](https://sosoapi.ai/ko/docs/mcp/get-user-profile): MCP: 사용자 프로필 조회. 로그인된 사용자의 프로필(표시 이름, 시간대, 아바타, 테마)을 읽으며 생성되기 전까지 profile은 null입니다.
- [사용자 프로필 수정](https://sosoapi.ai/ko/docs/mcp/update-user-profile): MCP: 사용자 프로필 수정. 로그인된 사용자의 프로필(display_name, timezone, avatar_url, theme)을 변경합니다. 변경할 필드만 보내세요.
- [아바타 업로드 서명](https://sosoapi.ai/ko/docs/mcp/sign-avatar-upload): MCP: 아바타 업로드 서명. 로그인된 사용자의 새 아바타 이미지 업로드용 서명 URL을 받습니다(filename 및 content_type 필수). 자체적으로 프로필을 변경하지 않습니다.
- [API 키 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-api-keys): MCP: API 키 목록 조회. 사용자의 API 키(이름, 마지막 4자, 상태, 만료, 계보)를 조회합니다. 각 키의 기능과 Workspace 제한도 받으려면 include_authority를 설정하세요. 비밀 값은 반환하지 않습니다. API 키 관리 권한이 필요하며 PAT로는 사용할 수 없습니다.
- [API 키 생성](https://sosoapi.ai/ko/docs/mcp/create-api-key): MCP: API 키 생성. 선택한 기능(agent:operate, agent:publish, agent:engage), 선택적 workspace_ids 제한, 최대 365일 수명으로 개인 액세스 키를 생성합니다. 비밀 값은 한 번만 반환되며 다시 읽을 수 없습니다. 에이전트는 자신의 권한 안에서 최대 30일까지만 부여하며 해당 권한이 종료되면 키도 작동을 멈춥니다. API 키 관리 권한이 필요하며 PAT로는 사용할 수 없습니다.
- [API 키 만료 연장](https://sosoapi.ai/ko/docs/mcp/extend-api-key): MCP: API 키 만료 연장. id로 식별한 API 키의 만료(expires_at)를 현재부터 최대 365일, 에이전트 생성 키는 30일까지 연장합니다. 에이전트는 자신의 승인으로 생성한 키만 연장할 수 있습니다. API 키 관리 권한이 필요합니다.
- [API 키 교체 갱신](https://sosoapi.ai/ko/docs/mcp/renew-api-key): MCP: API 키 교체 갱신. 새 비밀 값이 한 번 반환되는 API 키(id)의 후속 키를 같은 기능 및 Workspace 제한으로 생성합니다. 새 이름 또는 수명은 선택 사항입니다(최대 365일, 에이전트 생성 키는 30일). 원래 키는 취소되지 않습니다. API 키 관리 권한이 필요합니다.
- [API 키 취소](https://sosoapi.ai/ko/docs/mcp/revoke-api-key): MCP: API 키 취소. id로 API 키를 즉시 취소합니다. 이미 취소된 키는 already_revoked를 보고합니다. 에이전트는 자신의 승인으로 생성한 키만 취소할 수 있습니다. API 키 관리 권한이 필요합니다.
- [청구 상태 조회](https://sosoapi.ai/ko/docs/mcp/get-billing-status): MCP: 청구 상태 조회. 사용자의 청구 요금제, 결제 상태, 현재 주기 날짜 및 할당량 사용량(게시 성공, 대기 중인 예약 게시물, 연결 계정)을 읽습니다. 대규모 예약 실행 전에 확인하세요.
- [상용 이용 권한 조회](https://sosoapi.ai/ko/docs/mcp/get-commercial-access): MCP: 상용 이용 권한 조회. Workspace 하나의 청구 계정 요금제 및 할당량 정보와 commercial_access_mode(off, shadow, enforce)를 읽습니다.
- [Organization 컨텍스트 조회](https://sosoapi.ai/ko/docs/mcp/get-organization-context): MCP: Organization 컨텍스트 조회. Organization, 해당 Workspace와 Channel의 실시간 구조를 ID 및 역할과 함께 읽습니다. Organization 또는 Channel ID가 필요할 때 사용하세요. Workspace 게시에는 반환된 Workspace ID를 재사용하고 Workspace 컨텍스트를 추가로 읽지 마세요.
- [Workspace 생성](https://sosoapi.ai/ko/docs/mcp/create-workspace): MCP: Workspace 생성. 소유하거나 관리하는 Organization에 Workspace를 생성합니다. 여러 Organization에 속하면 organization_id를 전달하세요. 다음 호출에는 반환된 id를 사용하고 새 Workspace가 활성화된다고 가정하지 마세요.
- [Workspace 컨텍스트 조회](https://sosoapi.ai/ko/docs/mcp/get-workspace-context): MCP: Workspace 컨텍스트 조회. 로그인한 사용자가 속한 Workspace 목록과 활성 Workspace를 조회합니다. workspace_id를 모를 때 사용하며 두 컨텍스트 조회를 반복하지 말고 실시간 컨텍스트를 재사용하세요. 반환되는 활성 Workspace는 웹 앱에서 사용자가 선택한 항목이며 호출의 기본값이 아닙니다. workspace_id를 명시적으로 전달하세요. 단순 읽기 작업은 아닙니다. Workspace가 없는 계정에는 첫 Workspace를 생성합니다.
- [Workspace 수정](https://sosoapi.ai/ko/docs/mcp/update-workspace): MCP: Workspace 수정. Workspace 이름 또는 slug를 변경합니다. Workspace 소유자만 가능합니다.
- [Organization 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-organizations): MCP: Organization 목록 조회. 로그인한 사용자가 속한 Organization과 Organization 범위 도구의 organization_id로 사용할 id를 조회합니다.
- [Organization 연결 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-organization-connections): MCP: Organization 연결 목록 조회. Organization의 제공업체 연결(Meta, Instagram, Threads, YouTube)과 상태를 조회합니다. organization_id가 필요합니다.
- [Organization 연결 검토](https://sosoapi.ai/ko/docs/mcp/review-organization-connection): MCP: Organization 연결 검토. 대기 중인 연결 작업(operation_id)에서 발견한 제공업체 계정과 페이지를 검토용으로 읽습니다. 읽기 전용입니다. 연결 확인은 사람이 웹 앱에서 합니다.
- [Organization 채널 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-organization-channels): MCP: Organization 채널 목록 조회. Organization의 채널(연결된 제공업체 계정)과 각 채널이 연결된 Workspace를 조회합니다.
- [채널 이동 미리 확인](https://sosoapi.ai/ko/docs/mcp/preview-organization-channel-move): MCP: 채널 이동 미리 확인. 시험 실행으로 채널이 다른 Workspace로 이동 가능한지 확인하고 차단 요인을 조회합니다. 아무것도 변경하지 않습니다.
- [Workspace 구성원 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-workspace-members): MCP: Workspace 구성원 목록 조회. Workspace 구성원과 대기 중인 초대 목록을 조회합니다.
- [의견 제출](https://sosoapi.ai/ko/docs/mcp/submit-feedback): MCP: 의견 제출. 사용자 대신 제품 의견(type은 bug, feature 또는 general; 최대 4,000자)을 SosoAPI 팀에 전송합니다. 사용자가 요청한 경우에만 사용하세요.
- [알림 설정 조회](https://sosoapi.ai/ko/docs/mcp/get-notification-preferences): MCP: 알림 설정 조회. 사용자의 알림 설정을 읽습니다(현재는 게시물 실패 시 이메일 발송 여부).
- [알림 설정 수정](https://sosoapi.ai/ko/docs/mcp/update-notification-preferences): MCP: 알림 설정 수정. 사용자의 알림 설정(email_post_failed 켜기 또는 끄기)을 변경합니다.
- [받은 알림 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-inbox-notifications): MCP: 받은 알림 목록 조회. 사용자의 앱 내 받은 알림을 최신순으로 읽습니다(최대 50개). 읽지 않은 항목 또는 한 종류만 선택할 수 있습니다.
- [연결된 계정 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-connected-accounts): MCP: 연결된 계정 목록 조회. Workspace에 연결된 소셜 계정(Instagram, Threads, Facebook, YouTube)을 연결 상태 및 기능 정보와 함께 조회합니다. 예약 또는 댓글 작성 시 해당 id를 social_account_id로 사용하세요. workspace_id를 전달하세요. 명시적 대상 지정이 적용되면 이 값이 없는 요청은 거부됩니다.
- [소셜 계정 연결 해제](https://sosoapi.ai/ko/docs/mcp/disconnect-social-account): MCP: 소셜 계정 연결 해제. 소셜 계정을 Workspace에서 연결 해제합니다(Workspace 소유자만 가능). 사람이 다음으로 다시 연결할 때까지 게시가 중단됩니다: `sosoapi connect`.
- [소셜 계정 자동 동기화 설정](https://sosoapi.ai/ko/docs/mcp/set-social-account-auto-sync): MCP: 소셜 계정 자동 동기화 설정. 연결 계정 하나의 자동 동기화를 켜거나 끕니다(editor 역할). 아무것도 게시하지 않습니다.
- [소셜 계정 차단 해제](https://sosoapi.ai/ko/docs/mcp/clear-social-account-block): MCP: 소셜 계정 차단 해제. 게시를 재개할 수 있도록 계정의 제공업체 대기 시간을 해제합니다. 실패한 게시물은 재시도하지 않습니다. 해당 작업에는 sosoapi_retry_scheduled_post를 사용하세요.
- [에셋 검색](https://sosoapi.ai/ko/docs/mcp/query-assets): MCP: 에셋 검색. asset_type, source 또는 tag로 Workspace 에셋을 검색하며 한 페이지(limit 최대 100 및 offset)와 전체 수를 반환합니다. workspace_id를 명시적으로 전달하세요.
- [에셋 조회](https://sosoapi.ai/ko/docs/mcp/get-asset): MCP: 에셋 조회. id로 에셋 하나의 메타데이터와 수명이 짧은 미리보기 URL을 읽습니다.
- [에셋 생성](https://sosoapi.ai/ko/docs/mcp/create-asset): MCP: 에셋 생성. 이미 호스팅한 미디어 또는 텍스트의 에셋 기록(asset_url, asset_type)을 등록합니다. 아무것도 업로드하지 않습니다. 로컬 파일은 sosoapi_upload_asset, SosoAPI의 공개 URL 다운로드는 sosoapi_import_asset_url을 사용하세요. workspace_id를 전달하세요(명시적 대상 지정 적용 후 없으면 거부). idempotency_key는 선택 사항입니다.
- [에셋 수정](https://sosoapi.ai/ko/docs/mcp/update-asset): MCP: 에셋 수정. 에셋의 제목, 설명 또는 태그를 변경합니다(editor 역할).
- [에셋 삭제](https://sosoapi.ai/ko/docs/mcp/delete-asset): MCP: 에셋 삭제. id로 Workspace 라이브러리의 에셋 하나를 삭제합니다. Workspace 소유자만 가능합니다.
- [에셋 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-assets): MCP: 에셋 목록 조회. Workspace 에셋을 kind(video, image, audio, cover, thumbnail, frame, video-source, branding) 또는 customer_ready_only로 필터링하고 next_offset으로 페이지를 나누어 조회합니다. workspace_id는 필수입니다.
- [에셋 URL 가져오기](https://sosoapi.ai/ko/docs/mcp/import-asset-url): MCP: 에셋 URL 가져오기. 공개 http(s) 이미지 또는 동영상 URL을 비공개 Workspace 스토리지에 새 에셋으로 다운로드하도록 SosoAPI에 요청합니다. import_id를 반환하며 sosoapi_get_asset_import_status로 상태를 조회합니다. idempotency_key와 editor 역할이 필요합니다.
- [에셋 가져오기 상태 조회](https://sosoapi.ai/ko/docs/mcp/get-asset-import-status): MCP: 에셋 가져오기 상태 조회. import_id로 가져오기를 읽습니다. 게시에는 include_asset=true를 전달하세요. ready 결과에 등록된 에셋 id, kind, 안정적인 asset_url이 포함되어 별도 get_asset이 필요 없습니다. 대기 중이거나 없는 에셋은 예약할 수 없습니다. source 또는 미리보기 URL을 미디어 ID로 사용하지 마세요. 멈추면 job_id로 sosoapi_job_status를 읽고 중복 가져오기를 시작하지 마세요.
- [고아 에셋 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-orphan-assets): MCP: 고아 에셋 목록 조회. 어떤 에셋 기록도 가리키지 않는 Workspace의 저장 객체(스토리지 정리)를 연속 토큰으로 페이지를 나누어 조회합니다. Workspace 소유자만 가능합니다.
- [고아 에셋 삭제](https://sosoapi.ai/ko/docs/mcp/delete-orphan-assets): MCP: 고아 에셋 삭제. key로 선택한 미등록 저장 객체를 삭제합니다. Workspace 소유자만 가능하며 먼저 sosoapi_list_orphan_assets로 목록을 확인하세요.
- [에셋 스토리지 목록 조회](https://sosoapi.ai/ko/docs/mcp/get-asset-storage-inventory): MCP: 에셋 스토리지 목록 조회. 스토리지 감사를 위해 Workspace의 등록된 에셋과 저장된 객체 목록을 페이지별로 확인합니다.
- [에셋 내보내기 생성](https://sosoapi.ai/ko/docs/mcp/create-asset-export): MCP: 에셋 내보내기 생성. 선택한 에셋(asset_ids)을 매니페스트로 내보냅니다. export_verify_then_purge 모드는 이후 영구 삭제를 준비합니다. idempotency_key는 선택 사항입니다.
- [에셋 내보내기 검증](https://sosoapi.ai/ko/docs/mcp/verify-asset-export): MCP: 에셋 내보내기 검증. 에셋 내보내기(export_id) 검증을 시작합니다. 영구 삭제 요청 전에 내보내기가 검증되어야 합니다.
- [에셋 내보내기 상태 조회](https://sosoapi.ai/ko/docs/mcp/get-asset-export-status): MCP: 에셋 내보내기 상태 조회. 에셋 내보내기 상태 exported, verification_required, verifying, verified 또는 failed를 확인합니다.
- [에셋 영구 삭제 요청](https://sosoapi.ai/ko/docs/mcp/request-asset-purge): MCP: 에셋 영구 삭제 요청. 검증된 내보내기에 포함된 에셋의 저장 바이트를 영구 삭제하도록 요청합니다(export_id, asset_ids; confirm_history_loss가 필요할 수 있음). Workspace 소유자만 가능하며 삭제 후 되돌릴 수 없습니다.
- [에셋 영구 삭제 재시도](https://sosoapi.ai/ko/docs/mcp/retry-asset-purge): MCP: 에셋 영구 삭제 재시도. 중단된 영구 삭제 요청(purge_request_id)을 재시도합니다. Workspace 소유자만 가능합니다.
- [프로젝트 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-projects): MCP: 프로젝트 목록 조회. Workspace 프로젝트(출처 및 기본 계정을 위한 선택 계층)와 활성 프로젝트를 조회합니다.
- [프로젝트 조회](https://sosoapi.ai/ko/docs/mcp/get-project): MCP: 프로젝트 조회. id로 프로젝트 하나의 이름, 수명 주기 상태, 이후 쓰기에 필요한 수명 주기 및 기본값 버전을 읽습니다.
- [프로젝트 생성](https://sosoapi.ai/ko/docs/mcp/create-project): MCP: 프로젝트 생성. Workspace에 프로젝트를 생성합니다. Workspace 소유자만 가능하며 idempotency_key는 선택 사항입니다.
- [프로젝트 수정](https://sosoapi.ai/ko/docs/mcp/update-project): MCP: 프로젝트 수정. 프로젝트 이름을 변경합니다(수정 가능한 필드는 이름뿐입니다). Workspace 소유자만 가능합니다.
- [활성 프로젝트 설정](https://sosoapi.ai/ko/docs/mcp/set-active-project): MCP: 활성 프로젝트 설정. 사용자의 활성 프로젝트(서버 측 기본값)를 설정합니다.
- [프로젝트 기본 계정 조회](https://sosoapi.ai/ko/docs/mcp/get-project-account-defaults): MCP: 프로젝트 기본 계정 조회. 프로젝트의 기본 소셜 계정 및 계정별 재정의와 함께, 다음 교체 시 필요한 defaults_version을 읽습니다.
- [프로젝트 기본 계정 교체](https://sosoapi.ai/ko/docs/mcp/replace-project-account-defaults): MCP: 프로젝트 기본 계정 교체. 프로젝트의 기본 계정과 재정의를 한 번에 교체합니다. 최신 조회의 expected_defaults_version과 idempotency_key가 필요합니다(editor 역할).
- [프로젝트 보관](https://sosoapi.ai/ko/docs/mcp/archive-project): MCP: 프로젝트 보관. Scheduled Posts를 변경하지 않고 프로젝트를 보관합니다. 게시물을 중지하려면 해당 Scheduled Post를 별도로 취소하세요. Workspace 소유자만 가능하며 expected_lifecycle_version과 idempotency_key를 전달하세요.
- [프로젝트 보관 해제](https://sosoapi.ai/ko/docs/mcp/unarchive-project): MCP: 프로젝트 보관 해제. 보관된 프로젝트를 다시 활성화합니다. 게시물을 재개하거나 다시 예약하지 않으며 Scheduled Posts에서 관리해야 합니다. Workspace 소유자만 가능하며 expected_lifecycle_version과 idempotency_key를 전달하세요.
- [프로젝트 수명 주기 이력 조회](https://sosoapi.ai/ko/docs/mcp/get-project-lifecycle-history): MCP: 프로젝트 수명 주기 이력 조회. 프로젝트의 보관 및 보관 해제 같은 수명 주기 이벤트를 최대 200개 읽습니다.
- [프로젝트 프로필 조회](https://sosoapi.ai/ko/docs/mcp/get-project-profile): MCP: 프로젝트 프로필 조회. 프로젝트의 브랜드 프로필(tagline, voice, target audience, goals, palette 등)을 읽습니다. 없으면 profile은 null입니다.
- [프로젝트 프로필 수정](https://sosoapi.ai/ko/docs/mcp/update-project-profile): MCP: 프로젝트 프로필 수정. 프로젝트 브랜드 프로필 필드를 부분 수정합니다. 생략한 필드는 유지됩니다. 최신 조회의 expected_profile_version과 idempotency_key가 필요합니다(editor 역할).
- [프로젝트 에셋 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-project-assets): MCP: 프로젝트 에셋 목록 조회. 프로젝트에 연결된 에셋을 각 연결의 관계(identity, source 또는 reference)와 함께 커서 페이지 단위로 조회합니다.
- [프로젝트 에셋 연결](https://sosoapi.ai/ko/docs/mcp/link-project-asset): MCP: 프로젝트 에셋 연결. 기존 에셋을 identity, source 또는 reference로 프로젝트에 연결합니다. editor 역할과 idempotency_key가 필요합니다.
- [프로젝트 에셋 연결 해제](https://sosoapi.ai/ko/docs/mcp/unlink-project-asset): MCP: 프로젝트 에셋 연결 해제. 에셋과 프로젝트의 연결을 제거하고 에셋 자체는 유지합니다. idempotency_key가 필요합니다.
- [프로젝트 계정 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-project-accounts): MCP: 프로젝트 계정 목록 조회. 프로젝트에 연결된 소셜 계정을 커서 페이지 단위로 조회합니다.
- [프로젝트 계정 연결](https://sosoapi.ai/ko/docs/mcp/link-project-account): MCP: 프로젝트 계정 연결. 연결된 소셜 계정을 프로젝트에 연결합니다. editor 역할과 idempotency_key가 필요합니다.
- [프로젝트 계정 연결 해제](https://sosoapi.ai/ko/docs/mcp/unlink-project-account): MCP: 프로젝트 계정 연결 해제. 소셜 계정과 프로젝트의 연결을 제거하며 계정 자체는 연결된 상태로 유지됩니다. idempotency_key가 필요합니다.
- [프로젝트 내보내기 생성](https://sosoapi.ai/ko/docs/mcp/create-project-export): MCP: 프로젝트 내보내기 생성. 프로젝트 내보내기를 시작합니다(Workspace 소유자만 가능). 다운로드 URL은 sosoapi_get_project_export_status로 조회하세요. idempotency_key가 필요합니다.
- [프로젝트 내보내기 상태 조회](https://sosoapi.ai/ko/docs/mcp/get-project-export-status): MCP: 프로젝트 내보내기 상태 조회. 프로젝트 내보내기(export_id) 상태 queued, processing, completed(수명이 짧은 다운로드 URL 포함) 또는 failed를 확인합니다. Workspace 소유자만 사용할 수 있습니다.
- [게시 주의 사항 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-publication-attentions): MCP: 게시 주의 사항 목록 조회. 주의가 필요한 Workspace의 게시를 상태(open 또는 resolved) 또는 scheduled_post_id로 필터링하고 오프셋으로 페이지를 나누어 조회합니다.
- [X 게시 크레딧 조회](https://sosoapi.ai/ko/docs/mcp/get-x-usage): MCP: X 게시 크레딧 조회. 이 Workspace가 공유하는 Organization X 게시 크레딧을 읽습니다. workspace_id가 필요합니다. Free는 한 번 10, Pro는 청구 기간마다 100을 받습니다. 텍스트는 1, URL 포함 텍스트는 10입니다. 선택적 text로 비용을 견적합니다. 저장된 허용량만 읽으며 X API를 호출하지 않습니다.
- [예약 게시물 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-scheduled-posts): MCP: 예약 게시물 목록 조회. Workspace의 예약 게시물을 프로젝트, 상태(scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted), 기간으로 필터링하여 커서 페이지 단위로 조회합니다.
- [예약 게시물 조회](https://sosoapi.ai/ko/docs/mcp/get-scheduled-post): MCP: 예약 게시물 조회. id로 예약 게시물 하나의 콘텐츠, 상태, 전송 상태, 결과를 읽습니다. version은 수정, 게시, 재시도, 취소 시 expected_version으로 사용합니다.
- [예약 게시물 적격성 조회](https://sosoapi.ai/ko/docs/mcp/get-scheduled-post-eligibility): MCP: 예약 게시물 적격성 조회. 대상별 읽기 전용 사전 검사입니다. 콘텐츠/시간 검사를 위해 draft(caption, hashtags, scheduled_at, display_timezone, 선택적 현지 시간/DST)를 포함하세요. include_quota=true는 참고용 기간 스냅샷을 추가합니다. 먼저 미디어를 업로드/가져오기하고 준비를 기다리세요. draft가 없으면 계정/미디어만 검사합니다. 아무것도 예약하지 않으며 생성/디스패치 시 제한과 권한을 다시 확인합니다.
- [예약 게시물 생성](https://sosoapi.ai/ko/docs/mcp/create-scheduled-post): MCP: 예약 게시물 생성. provider_payload로 계정 하나를 scheduled_at에 예약합니다. 미디어에는 준비된 asset_id와 정식 URL이 필요하며 소스 이미지 하나에는 sosoapi_post_image_url을 사용합니다. local_scheduled_at과 schedule_dst_disambiguation은 함께 제공하거나 모두 생략하세요. publish, editor 역할, idempotency_key가 필요합니다. 예약은 게시 완료가 아니므로 결과를 읽으세요.
- [예약 게시물 일괄 생성](https://sosoapi.ai/ko/docs/mcp/bulk-create-scheduled-posts): MCP: 예약 게시물 일괄 생성. 한 번의 호출(targets)로 여러 계정의 게시물을 예약합니다. 미디어에는 업로드/가져오기가 완료된 asset_ids와 정식 URL이 필요합니다. 대상별로 독립적으로 성공 또는 실패하며 successes 또는 failures에 보고됩니다. publish 기능이 필요합니다.
- [예약 게시물 수정](https://sosoapi.ai/ko/docs/mcp/update-scheduled-post): MCP: 예약 게시물 수정. 아직 디스패치되지 않은 예약 게시물(caption, hashtags, media, link, time)을 수정합니다. 최신 조회의 expected_version이 필요하며 오래된 버전은 거부됩니다.
- [예약 게시물 즉시 게시](https://sosoapi.ai/ko/docs/mcp/publish-scheduled-post-now): MCP: 예약 게시물 즉시 게시. scheduled_at 대신 즉시 게시합니다. 공개되며 되돌릴 수 없고 expected_version이 필요합니다. queued는 게시 완료가 아니므로 결과를 읽으세요.
- [예약 게시물 재시도](https://sosoapi.ai/ko/docs/mcp/retry-scheduled-post): MCP: 예약 게시물 재시도. 실패한 예약 게시물을 재시도하며 선택적으로 새 scheduled_at을 지정합니다. expected_version이 필요합니다.
- [예약 게시물 삭제](https://sosoapi.ai/ko/docs/mcp/delete-scheduled-post): MCP: 예약 게시물 삭제. 게시되지 않은 예약 게시물(scheduled, needs_reschedule, failed 또는 cancelled)을 삭제합니다. 에이전트는 게시된 제공업체 콘텐츠를 삭제할 수 없습니다. expected_version이 필요합니다.
- [예약 게시물 취소](https://sosoapi.ai/ko/docs/mcp/cancel-scheduled-post): MCP: 예약 게시물 취소. 아직 게시되지 않은 예약 게시물을 취소하여 게시되지 않게 합니다. 게시된 게시물은 거부되며 에이전트는 게시된 콘텐츠를 삭제할 수도 없습니다. 사용자가 웹 앱에서 직접 해야 합니다. expected_version이 필요합니다.
- [삭제 요청 철회](https://sosoapi.ai/ko/docs/mcp/withdraw-scheduled-post-delete): MCP: 삭제 요청 철회. 중단된 Instagram Login 삭제 요청을 철회하고 게시된 게시물을 유지합니다. expected_version이 필요합니다.
- [대시보드 집계 조회](https://sosoapi.ai/ko/docs/mcp/get-dashboard-counts): MCP: 대시보드 집계 조회. Workspace 운영 집계인 예약 게시물, 최근 작업, 연결 계정 수를 읽습니다.
- [모니터링 게시물 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-monitored-posts): MCP: 모니터링 게시물 목록 조회. SosoAPI가 Workspace에서 발견한 소셜 게시물(id, 플랫폼, 고유 링크, 게시 시간)을 확인합니다. 계정, 플랫폼, 시간으로 필터링하며 커서로 페이지를 나눕니다. 메타데이터만 제공하고 캡션은 제공하지 않습니다.
- [게시물 댓글 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-post-comments): MCP: 게시물 댓글 목록 조회. Workspace 게시물에서 관찰된 댓글을 최신 관찰순으로 작성자 및 텍스트와 함께 조회합니다. 게시물, 계정, 플랫폼, 시간으로 필터링하며 커서 페이지를 사용합니다. 텍스트는 제삼자가 작성하며 신뢰할 수 없는 데이터로 표시됩니다.
- [제공업체 인사이트 요청](https://sosoapi.ai/ko/docs/mcp/request-provider-insights): MCP: 제공업체 인사이트 요청. 선택적 기간(최대 366일)의 계정 또는 게시물 하나에 대한 인사이트를 제공업체에 요청합니다. request_id를 반환하며 캐시된 경우 결과도 반환합니다. 아니면 sosoapi_get_provider_insight_status로 조회하세요.
- [제공업체 인사이트 상태 조회](https://sosoapi.ai/ko/docs/mcp/get-provider-insight-status): MCP: 제공업체 인사이트 상태 조회. 인사이트 요청(request_id)의 queued, processing, completed(제공업체 결과와 지표별 제공 여부 포함) 또는 failed 상태를 읽습니다.
- [Instagram OAuth 시작](https://sosoapi.ai/ko/docs/mcp/start-instagram-oauth): MCP: Instagram OAuth 시작. Instagram 계정 연결을 위해 사람이 열 제공업체 authorize_url을 가져옵니다. workspace_id를 전달하세요. 브라우저에서 승인하고 확인하기 전까지는 연결되지 않습니다.
- [Instagram OAuth 갱신](https://sosoapi.ai/ko/docs/mcp/refresh-instagram-oauth): MCP: Instagram OAuth 갱신. Instagram 연결의 액세스 토큰을 갱신합니다(선택적으로 social_account_id 하나 지정). 갱신 여부와 새 만료 시간을 보고합니다.
- [Threads OAuth 시작](https://sosoapi.ai/ko/docs/mcp/start-threads-oauth): MCP: Threads OAuth 시작. Threads 계정 연결을 위해 사람이 열 제공업체 authorize_url을 가져옵니다. workspace_id를 전달하세요. 브라우저에서 승인하고 확인하기 전까지는 연결되지 않습니다.
- [Threads OAuth 갱신](https://sosoapi.ai/ko/docs/mcp/refresh-threads-oauth): MCP: Threads OAuth 갱신. Threads 연결의 액세스 토큰을 갱신합니다(선택적으로 social_account_id 하나 지정). 갱신 여부와 새 만료 시간을 보고합니다.
- [Threads OAuth 확인](https://sosoapi.ai/ko/docs/mcp/check-threads-oauth): MCP: Threads OAuth 확인. Threads 연결 상태인 연결 여부, 만료, 권한 범위, 갱신 가능 여부를 확인합니다. workspace_id를 전달하세요.
- [Meta OAuth 시작](https://sosoapi.ai/ko/docs/mcp/start-meta-oauth): MCP: Meta OAuth 시작. Facebook Page 또는 Facebook을 통한 Instagram(connection_intent) 연결을 위해 사람이 열 제공업체 authorize_url을 가져옵니다. workspace_id를 전달하세요. 브라우저에서 승인하고 확인하기 전까지는 연결되지 않습니다.
- [Meta OAuth 갱신](https://sosoapi.ai/ko/docs/mcp/refresh-meta-oauth): MCP: Meta OAuth 갱신. Facebook/Meta 연결(social_account_id)을 다시 검증하고 capability_verified를 보고합니다.
- [YouTube OAuth 시작](https://sosoapi.ai/ko/docs/mcp/start-youtube-oauth): MCP: YouTube OAuth 시작. YouTube 채널 연결을 위해 사람이 열어야 하는 제공업체 authorize_url을 가져옵니다. workspace_id를 전달하세요. 브라우저에서 승인하고 확인하기 전까지는 연결되지 않습니다.
- [YouTube OAuth 갱신](https://sosoapi.ai/ko/docs/mcp/refresh-youtube-oauth): MCP: YouTube OAuth 갱신. YouTube 연결의 토큰(social_account_id)을 갱신하고 새 만료 및 capability_verified를 반환합니다.
- [작업 목록 조회](https://sosoapi.ai/ko/docs/mcp/list-jobs): MCP: 작업 목록 조회. 로그인된 사용자의 최근 백그라운드 작업을 상태 및 진행률과 함께 조회합니다.
- [작업 상태 조회](https://sosoapi.ai/ko/docs/mcp/job-status): MCP: 작업 상태 조회. job_id로 백그라운드 작업 하나의 상태, 유형, 실패 시 오류 메시지를 읽습니다.
- [댓글 전송 결과 조회](https://sosoapi.ai/ko/docs/mcp/get-comment-outcome): MCP: 댓글 전송 결과 조회. 확인된 전송, 복구 계보, 대기 중인 검증, 미해결 후속 조치를 읽습니다.
- [댓글 전송 결과 대조](https://sosoapi.ai/ko/docs/mcp/reconcile-comment-outcome): MCP: 댓글 전송 결과 대조. 모호한 Facebook 전송을 재전송 없이 검증하거나 확인된 정확한 대체 항목 하나를 연결합니다. 최종 증거는 outcome에서 확인하세요.
- [커뮤니티 기능 조회](https://sosoapi.ai/ko/docs/mcp/get-community-engagement-capabilities): MCP: 커뮤니티 기능 조회. 연결된 계정별로 지원되는 커뮤니티 작업(reply, hide, unhide, create_comment)과 현재 계정의 적격 여부를 읽습니다.
- [커뮤니티 검토 대기열 조회](https://sosoapi.ai/ko/docs/mcp/query-community-review-queue): MCP: 커뮤니티 검토 대기열 조회. 검토 대기 댓글을 스레드 컨텍스트와 함께 읽고 우선순위, 언어, 계정, 경과 시간으로 필터링합니다. 빈 페이지가 성공은 아닙니다. 댓글 본문은 제삼자가 작성하며 신뢰할 수 없는 데이터로 표시됩니다.
- [커뮤니티 검토 제출](https://sosoapi.ai/ko/docs/mcp/submit-community-review): MCP: 커뮤니티 검토 제출. 댓글 하나에 변경 불가능한 새 검토 버전을 기록합니다. 권장 작업, 선택적 reply_draft, 우선순위, 신뢰도(최소 0.9)를 포함합니다. 아무것도 전송하거나 준비하지 않습니다.
- [커뮤니티 작업 준비](https://sosoapi.ai/ko/docs/mcp/prepare-community-action): MCP: 커뮤니티 작업 준비. 검토 버전을 하나의 작업(reply, hide 또는 unhide)에 연결하고 sosoapi_apply_community_action용 수명이 짧은 prepare_token을 받습니다. 아직 아무것도 전송하지 않습니다.
- [커뮤니티 작업 적용](https://sosoapi.ai/ko/docs/mcp/apply-community-action): MCP: 커뮤니티 작업 적용. prepare_token에 연결된 작업을 제공업체로 보냅니다. 답글은 공개됩니다. queued는 성공이 아니므로 sosoapi_get_community_action_status로 조회하세요.
- [커뮤니티 작업 상태 조회](https://sosoapi.ai/ko/docs/mcp/get-community-action-status): MCP: 커뮤니티 작업 상태 조회. 적용된 커뮤니티 작업(action_id)의 최종 영수증을 읽습니다. 대기열 등록은 성공이 아닙니다.
- [커뮤니티 댓글 생성](https://sosoapi.ai/ko/docs/mcp/create-comment): MCP: 커뮤니티 댓글 생성. 정식 게시물 또는 댓글 대상에 정확한 댓글 하나를 대기열에 넣습니다. 상태는 제공업체 성공을 뜻하지 않습니다.
- [커뮤니티 댓글 상태 조회](https://sosoapi.ai/ko/docs/mcp/get-comment-action-status): MCP: 커뮤니티 댓글 상태 조회. 직접 댓글 작업에 대한 민감 정보를 제거한 최종 영수증을 읽습니다.
- [커뮤니티 요약 조회](https://sosoapi.ai/ko/docs/mcp/get-community-engagement-summary): MCP: 커뮤니티 요약 조회. Workspace의 커뮤니티 운영 요약인 레인 모드, 대기 작업, 응답 시간, 작업 상태, 제공업체 비율을 읽습니다.
- [URL로 이미지 한 장 게시](https://sosoapi.ai/ko/docs/mcp/post-image-url): MCP: URL로 이미지 한 장 게시. media를 비워 완성된 이미지 URL 게시물을 한 번 제출합니다. 연결 해제 후에도 백엔드가 준비하고 게시합니다. 35초 안에 가능하면 최종 게시 결과를, 아니면 영속적인 게시물 ID를 반환합니다. 새 키로 재제출하지 마세요. operate 및 publish 권한이 필요합니다. 현지 시간/DST 필드는 함께 사용합니다. import_id는 이전 클라이언트 재개용입니다.
- [로컬 이미지 또는 동영상 업로드](https://sosoapi.ai/ko/docs/mcp/upload-asset): MCP: 로컬 이미지 또는 동영상 업로드. 로컬 이미지 또는 동영상 파일을 Workspace 에셋 라이브러리에 업로드하고 에셋으로 등록합니다. 작업 디렉터리, 임시 폴더, Pictures/Movies/Videos 또는 SOSOAPI_UPLOAD_ROOTS의 실제 PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG 파일만 최대 500 MiB까지 허용합니다. 점으로 시작하는 파일과 폴더는 거부합니다. Scheduled Post 미디어용 에셋 id와 URL을 반환합니다.