# 이 어시스턴트를 사용하는 사람을 위한 SosoAPI 설정

기존 어시스턴트를 사용하고 원래 작업, 콘텐츠 및
이 대화의 미디어 참조. 연결된 계정에는 하나의 SosoAPI MCP를 사용하세요.
소셜 계정. 기존 연결을 재사용하거나 로컬 또는 호스팅 접근을 선택하세요.
아래를 참고하세요. 설정은 게시물을 게시하지 않습니다. 당사자가 로그인하고 허용할 범위를 선택합니다.
자신의 브라우저에서 승인하게 하세요. 자격 증명을 입력하거나 대신 동의하지 마세요.
당사자가 직접 하게 하세요. Free에는 카드가 필요하지 않습니다.

## 1. 이 어시스턴트 연결

먼저 현재 호스트와 기존 SosoAPI 설정을 확인하세요. 재사용하세요:
작동 중인 연결을 사용하세요. 로그아웃하거나 설정을 덮어쓰거나 새로 만들지 마세요:
이 안내를 다시 열었다는 이유로 새 연결을 만들지 마세요.

로컬 셸에서는 Node.js 20 이상과 npx가 있는지 확인하세요. 다음을 사용하세요:
기존 지원 런타임을 사용하세요. 없으면 필요한 조건을 쉬운 말로 설명하세요.
언어. 권한이 필요한 변경이나 시스템 전체 변경을 자동 수행하지 마세요.

Claude Code:

```sh
claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

Codex:

```sh
codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

서버 등록 후 이 환경에서 도구 호출이 되는지 확인하세요:
대화. 호스트에 재연결 또는 재시작이 필요하면 어느 항목인지 알려주세요:
필요한 작업. 도구가 작동하기 전에는 연결이 준비되었다고 말하지 마세요.

새 연결은 일반 게시용 기존 28개 도구 core 프로필을 사용합니다.
미디어, 댓글, 인사이트. 작동 중인 full 프로필 연결을 재사용하세요.
요청한 관리 작업이 없으면 full 프로필을 설명하세요.
이용할 수 있습니다. 도구를 숨겨도 권한이 부여되거나 취소되지는 않습니다.

맞춤 MCP 앱을 지원하는 ChatGPT 같은 브라우저 전용 클라이언트에는 다음을 추가하세요:
원격 MCP URL을 추가하고 자동 클라이언트 등록이 있는 OAuth를 선택하세요:

`https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp`

API 키, 클라이언트 ID, 클라이언트 비밀 값을 붙여 넣을 필요는 없습니다. 당사자가 로그인합니다.
SosoAPI에 로그인하고 Workspace/작업을 선택합니다. ChatGPT 맞춤 앱은 다음에 따라 다릅니다:
해당 요금제와 개발자 모드 제공 여부. 작동하는 로컬 또는 원격 연결을 재사용하세요.
이미 설정된 연결이 있으면 재사용하세요.

X는 원본 텍스트와 링크를 지원합니다. 각 Organization은 Free X 크레딧 10을 공유합니다.
한 번, 또는 Pro 청구 기간마다 100입니다. 일반 텍스트는 1이며 URL이 있는 Post는
비용은 10입니다. 다음을 읽으세요: `sosoapi_get_x_usage` workspace_id를 지정하여 X 사용 계획 전에 확인하세요.
자동 초과 요금은 부과하지 않습니다. 불확실한 게시는 크레딧을 점유합니다.
예약이며 다른 전송 전에 대조해야 합니다.

## 2. API 키 없이 로그인

첫 인증 MCP 호출은 기존 브라우저 로그인과 에이전트
동의 흐름. 당사자는 Google을 사용하거나 가입하고 이메일을 인증할 수 있습니다.
사용자가 Workspace와 어시스턴트의 준비 전용 여부를 선택하게 하세요.
콘텐츠만 준비할지 예약과 게시도 가능하게 할지 정하게 하세요. 자격 증명을 복사하도록 요청하지 마세요.
게시 동의는 선택 범위 안에서 계속 유지되며 강제되는
게시물마다 승인 화면이 생기지 않습니다. 일반 게시에서는 키 관리를 꺼 두세요.

이메일 가입과 로그인은 백그라운드 보안 검증을 사용하며 다음이 없습니다:
체크박스는 당사자가 직접 해결하게 하세요. 검증에 실패하면 실제
오류를 보고 가능한 재시도 작업을 사용하세요. 당사자에게 다음을 찾거나 클릭하라고 요청하지 마세요:
CAPTCHA 상자 없이 진행됩니다. 기존 **Continue with Google** 옵션도 사용할 수 있습니다.
당사자가 Google을 사용하려는 경우입니다. Google에서 별도의 신원 확인을 요구할 수 있습니다.
당사자가 계정을 선택하고 접근을 승인하게 하세요.
현재 로그인/승인 링크와 돌아갈 대상을 유지하세요. 교체하지 마세요:
단순 가입 URL로 교체하거나 기존 관리자의 신원으로 조용히 전환하지 마세요.
로그인 오류 한 번이 모든 로그인 방법의 이용 불가를 증명하지는 않습니다.

당사자의 신원이나 동의가 필요한 단계만 멈추세요. 당사자가
완료하는 동안 설치 확인을 마치고 원래 초안을 준비하세요. 다음은 하지 마세요:
계정이나 Workspace를 만들어 추정하지 마세요. 이미 준비된 내용과 다음에 필요한 한 가지
다음 작업을 설명하세요. 로그인 후 인증된 컨텍스트를 다시 읽고 이어가세요:
같은 작업. CAPTCHA를 끄거나 관리자 가입 API를 사용하거나 토큰을 요청하지 마세요.
또는 실제 흐름이 끝나기 전에 계정/연결이 준비되었다고 말하지 마세요.

MCP 도구에 호스트 새로고침이 필요하면 로컬 CLI도 사용할 수 있습니다:
어시스턴트. 실행하세요: `npx -y sosoapi auth status` 먼저 확인한 뒤 다음을 사용하세요:
`npx -y sosoapi auth login` 로그인이 필요할 때만 사용하세요. 절대 읽지 마세요:
자격 증명 파일을 읽거나 토큰을 출력하지 마세요. 잘못된 브라우저 프로필로 로그인이 열리면 멈추세요.
새 작업을 시작하기 전에 해당 대기 로그인을 중지하세요: `npx -y sosoapi auth login --no-open`.
당사자가 의도한 프로필에서 새로 출력된 링크를 열고 다음을 확인합니다:
승인 전에 로그인된 계정을 확인하세요. 같은 링크에서 두 프로필을 동시에 사용하지 마세요.
사용하세요: `--help` 먼저 설치된 CLI에 이 복구 플래그가 있는지 확인하세요;
없으면 작동하는 플래그를 지어내지 말고 버전 제한을 설명하세요.
CLI에서 내장된 계약을 확인할 수 있습니다:

```sh
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/
```

CLI 요청 문법: `sosoapi api post </allowlisted-route> < request.json`.
파일 도구로 JSON을 작성하세요. 사용자 콘텐츠를 셸 명령에 삽입하지 마세요.
명령. 프로세스 종료 코드만 보지 말고 http_status와 응답 본문을 읽으세요.
코드. API 오류는 성공이 아닙니다. 다음의 라우트와 스키마만 사용하세요:
내장 계약. 이름을 지어내거나 없는 기능을 우회하지 마세요.

## 3. 당사자 소유 소셜 계정 연결

SosoAPI 컨텍스트에서 인증된 Organization과 Workspace를 확인하세요.
ID를 추측하거나 말없이 다른 Workspace로 바꾸지 마세요. 만약
적합한 브랜드가 여러 개면 어느 것을 원하는지 물으세요.

기존 연결이 정상이라면 사용하세요. 아니면 다음을 실행하세요:
`npx -y sosoapi connect <platform>` (instagram, threads, facebook, youtube 또는 x)
또는 당사자에게 제공하세요: https://app.sosoapi.ai/connect. 당사자가 제공업체
브라우저에서 동의하고 정확한 계정을 검토하게 하세요. 돌아온 후에는
계정과 게시 기능을 다시 읽으세요. 연결 콜백은
게시가 허용된 증거가 아닙니다. 원래 초안을 재사용하고 요청하지 마세요:
사람에게 내부 ID를 복사하거나 콘텐츠를 다시 만들도록 요청하지 마세요.

## 4. 원래 게시 작업 완료

기존 요청을 사용하거나 홍보하려는 내용을 물으세요. 하지 마세요:
테스트 게시물을 지어내지 마세요. 정확한 대상 계정, 콘텐츠, 미디어 및
첫 제출 전에 현지 날짜/시간을 확인하세요. 시간대가 다음 상태라면 확인하세요:
알 수 없음. 현재 계정 기능 정보를 읽으세요. 개인 Instagram 계정 또는 누락된
제공업체 권한에는 지원 계정 유형이나 재연결이 필요할 수 있습니다.

X는 원본 텍스트와 링크만 지원하므로 media는 비워 두세요. X 미디어, 답글,
인용, 재게시 및 스레드 게시는 지원하지 않습니다.

미디어 지원 대상은 예약 전에 등록하세요. 로컬 파일은 sosoapi_upload_asset을 사용하세요.
허용 폴더 안에서 사용하세요. 외부 URL은 sosoapi_import_asset_url을 사용하세요.
include_asset=true로 sosoapi_get_asset_import_status를 확인하여 다음까지 기다리세요:
범위가 제한된 가져오기가 준비될 때까지. 준비된 asset.id는 media.asset_id가 되고
asset.asset_url은 media.url이 되며 별도 get_asset 호출은 필요하지 않습니다.
같은 가져오기 ID를 유지하고 재시도 안내를 따르며 최종 상태에서 멈추세요:
실패. 요청 성공은 디코딩/가져오기 완료를 입증하지 않습니다.
진행이 멈추면 다른 작업 전에 해당 가져오기의 job_id로 sosoapi_job_status를 읽으세요.
다시 기다리기 전에 확인하세요. 대기 작업에도 실행 오류가 있을 수 있습니다. 서비스
설정 오류는 운영자의 조치가 필요합니다. 다른 가져오기, 새 소셜
당사자의 연결 또는 권한이 필요합니다. 성공을 주장하지 말고 차단 요인을 보고하세요.
이미지가 준비될 때까지.
반환된 등록 에셋 ID와 정식 미디어 URL을 함께 사용하세요. 절대
원래 외부 URL 또는 임시 미리보기 URL을 대신 예약하지 마세요.
Workspace와 ID를 확인한 뒤에만 기존의 준비된 에셋을 재사용하세요.

참고용 미리보기가 유용하면 sosoapi_get_scheduled_post_eligibility를 사용하세요;
선택 사항이며 정식 생성/실행 검증을 대체하지 않습니다.
정식 Scheduled Post 사용
도구. 게시물 하나는 대상 하나입니다. 재시도에는 같은 idempotency_key를 사용하세요.
정확히 같은 요청에 적용됩니다. 초안이 바뀌면 새 요청입니다. 시간 초과 후에는
다른 작업 전에 기존 게시물을 읽으세요. 무작정 다시 전송하지 마세요:
불확실한 제공업체 쓰기. 수정, 취소, 명시적 재시도에는 다음을 사용합니다:
현재 버전과 서버의 작업 적격성.

결과는 다음을 구별해야 합니다:

- 예약: 지정한 시간으로 접수됨; 아직 게시되지 않음.
- 진행 중 또는 대조 중: 최종 결과가 미확인 상태입니다. 다시 보내지 마세요.
- 게시 완료: 제공업체 근거가 있는 최종 결과가 정확한 게시물을 확인함;
  가능하면 공개 링크를 반환하세요.
- 실패 또는 주의 필요: 확인된 사실과 다음 허용 작업을 알리세요;
  당사자가 다시 접근을 허용해야 할 때는 해당 계정만 다시 연결하세요.

여러 대상은 각각 보고하세요. 전체 작업을 다음과 같이 말하지 마세요:
일부 플랫폼만 성공했을 때 전체 성공으로 말하지 마세요. 미래 예약에는 다음을 반환하세요:
게시물 ID와 접수 시간을 반환하세요. 다음까지 대화를 대기시키지 마세요:
예약 시각까지 기다리거나 반복 조회 루프를 만들지 마세요. 돌아오면 같은 게시물을 다시 읽으세요.
당사자는 다음에서 정확한 결과를 다시 볼 수도 있습니다:
https://app.sosoapi.ai/scheduled-posts/<post-id>, 반환된 실제 ID 사용
SosoAPI에서 확인할 수 있습니다. 해당 페이지는 본인의 승인된 로그인이 필요합니다. 맞춤
환경에서는 명시적으로 설정된 앱 origin을 대신 사용하세요.
닫힌 어시스턴트를 깨우거나 설정되지 않은 성공 알림을 보낸다고 약속하지 마세요:
설정 및 검증되지 않았습니다.

## 참조

- 사람을 위한 빠른 시작: https://app.sosoapi.ai/start
- 제품 안내: https://sosoapi.ai/ko/docs/quickstart
- 지원 범위: Instagram, Threads, Facebook Pages, YouTube 및 X 원본
  텍스트/링크. 형식과 권한은 계정마다 다르며 다른 플랫폼은
  당사자가 요청한다는 이유만으로 제공되는 것은 아닙니다.