SosoAPI 설정 가이드

시작 지점 선택

SosoAPI는 기존에 사용하는 에이전트에 소셜 계정 연결 하나를 제공합니다. 에이전트가 콘텐츠 작성과 검토를 돕고 SosoAPI는 지원되는 계정 작업, 예약, 게시 결과를 처리합니다. 같은 게시물을 앱에서 검토하거나 자체 코드에서 API를 사용할 수도 있습니다.

이 가이드는 한 사람과 소셜 계정 하나로 시작합니다. 로컬 또는 호스팅 MCP 클라이언트 연결, 접근 선택, 소셜 계정 확인, 게시물 준비와 승인, 실제 결과 읽기를 안내합니다. 고급 안내는 CLI와 HTTP API를 다룹니다. 설정 자체에는 테스트 게시물이 필요하지 않습니다.

• Claude Code 또는 Codex에 설정 맡기기: 1단계
• MCP 클라이언트 직접 설정: 3단계
• 터미널 또는 백엔드 사용: 9단계
• 연결 수정: 10단계

시작 전

MCP 호환 AI 클라이언트, SosoAPI 계정, 관리 권한이 있는 소셜 계정이 필요합니다. 로그인 화면이 열리면 SosoAPI 계정을 만들 수 있습니다. 준비할 실제 콘텐츠 하나를 생각해 두세요.

로컬 MCP는 Node.js 20 이상, npm/npx, 선택한 AI 클라이언트가 필요합니다. 호스팅 MCP는 remote MCP, OAuth, 자동 클라이언트 등록을 지원하는 클라이언트가 필요하며 로컬 Node.js 설치는 필요하지 않습니다. 클라이언트 기능은 요금제와 관리자 설정에 따라 달라질 수 있습니다.

SosoAPI는 Instagram, Threads, Facebook Pages, YouTube, X에 연결됩니다. 계정 유형, 권한, 게시물 형식이 작업에 맞는 계정을 선택하세요. 자격을 갖춘 Threads 계정은 첫 텍스트 전용 예시로 유용합니다. Instagram과 YouTube는 지원되는 게시 형식에 적합한 미디어가 필요합니다. 연결 메뉴에 플랫폼이 있다고 해서 모든 계정에서 모든 작업을 사용할 수 있는 것은 아닙니다.

설정 중 계정별 기능을 확인하세요. 일괄 예약 전에 앱에서 현재 요금제와 한도를 읽으세요. X에는 조직별 별도 크레딧 한도가 있습니다. 한 플랫폼의 예시가 다른 플랫폼의 지원을 입증하지는 않습니다.

• 지원 플랫폼
• 게시 기능 및 계정 요건

1. 에이전트에게 설정 요청

기존 Claude Code 또는 Codex 대화에 붙여 넣으세요.

에이전트는 먼저 정상 작동하는 SosoAPI 연결이 있는지 확인하고 재사용해야 합니다. 없으면 설정 안내를 따르고 브라우저 로그인이나 클라이언트 재시작이 필요한 시점을 알려줍니다. 기대 결과는 현재 대화에서 SosoAPI 도구를 사용할 수 있는 것입니다. 설치 메시지만으로는 충분하지 않습니다. 로그인과 계정 확인을 계속하거나 수동 설정은 3단계를 사용하세요.

https://sosoapi.ai/setup.md 에 따라 SosoAPI를 설정해 줘. 현재 콘텐츠와 작업은 유지해 줘. 요청하면 내가 로그인하고 접근을 승인할게. 설정 중에는 아무것도 게시하지 마.

2. 로그인하고 에이전트 접근 권한 선택

의도한 계정을 사용하세요. Google로 계속하거나 이메일로 가입하고 인증을 완료하세요. 표시된 계정 또는 워크스페이스 설정을 완료하세요. 여러 워크스페이스에 속했다면 의도한 브랜드나 프로젝트를 선택하세요. 승인 전에 요청된 워크스페이스와 작업을 검토한 뒤 같은 대화로 돌아오세요.

브라우저가 대기 중인 승인으로 돌아갈 수 있도록 에이전트가 제공한 로그인 링크를 유지하세요. 앱에서 먼저 시작한 뒤 에이전트로 돌아와도 됩니다. 대기 중인 승인 링크를 다른 로그인 링크로 바꾸지 마세요.

워크스페이스 역할과 플랫폼 권한은 계속 적용됩니다. 에이전트에 게시 접근이 있어도 뷰어가 편집자가 되지는 않습니다. 게시 접근은 부여한 범위에서 계속 유효하며 SosoAPI는 게시물마다 새 브라우저 승인을 요구하지 않습니다. 콘텐츠 검토를 위해 멈출 시점을 에이전트에게 알려 주세요. 일반 OAuth 설정은 소셜 비밀번호나 API 키를 에이전트에 붙여 넣을 필요가 없습니다.

기대 결과: 의도한 신원으로 로그인이 완료되고 에이전트가 승인한 워크스페이스를 가져올 수 있습니다. 잘못된 브라우저 프로필이 열리면 문제 해결을 확인하세요.

• SosoAPI 앱에서 시작

3. 필요한 경우 에이전트 수동 연결

연결 방식 하나를 선택하세요. 에이전트가 이미 정상적인 연결을 설정했다면 이 절은 건너뛰세요. 로컬 MCP는 Node.js와 npx를 먼저 확인하세요. Node.js는 20 이상이어야 합니다.

node --version
npx --version

로컬 MCP: Claude Code 또는 Codex

클라이언트에 맞는 명령만 실행하세요. 첫 번째는 Claude Code용이고 두 번째는 Codex용입니다. core 프로필은 일상적인 게시 작업을 포함합니다. 프로필은 표시 도구만 바꾸며 권한을 부여하지 않습니다. 정상 작동하는 full 프로필 연결이 있다면 유지하세요.

클라이언트가 요청하면 다시 연결하거나 재시작한 뒤 현재 대화에서 SosoAPI 도구를 사용할 수 있는지 확인하세요. 필요한 경우 첫 인증 호출이 브라우저 로그인을 시작합니다.

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

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

기타 로컬 MCP 클라이언트

mcpServers JSON을 사용하는 클라이언트는 기존 설정에 이 항목을 추가하고 다른 서버는 유지하세요. 다른 설정 형식은 클라이언트의 MCP 설정에서 같은 명령, 인수, 환경 변수를 제공하세요.

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• 설치 참고 및 패키지 선택

호스팅 MCP: 호환 브라우저 또는 원격 클라이언트

클라이언트의 사용자 지정 커넥터 또는 remote MCP 설정에서 아래 서버 URL로 SosoAPI라는 연결을 추가하세요. 제공되면 OAuth와 자동 클라이언트 등록을 선택하세요. SosoAPI에 로그인해 허용할 워크스페이스와 작업을 선택하고 대화로 돌아와 필요한 경우 연결을 활성화하세요. 승인된 계정을 확인하도록 에이전트에게 요청하세요.

새 호스팅 연결에는 https://sosoapi.ai 를 사용하세요. 기존 엔드포인트 https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp 도 계속 지원됩니다. 정상 작동하는 로컬 또는 호스팅 연결을 유지하고 URL만 바꾸려고 교체하지 마세요.

API 키, 클라이언트 ID, 클라이언트 시크릿을 붙여 넣을 필요가 없습니다. ChatGPT 사용자 지정 MCP 앱은 클라이언트 요금제, 개발자 모드, 관리자 설정에 따라 달라집니다. 이 안내는 앱 디렉터리 등록이 아닌 사용자 지정 연결에 대한 설명입니다. 호스팅 MCP는 로컬 파일을 읽을 수 없으므로 공개 URL 가져오기 또는 로컬 파일 업로드용 로컬 MCP를 사용하세요.

https://sosoapi.ai

• 사용자 지정 OAuth 클라이언트 등록 및 토큰 안내

선택 사항: 터미널 로그인 확인

로컬 연결은 auth status를 먼저 실행하세요. 로그인되지 않았다고 보고할 때만 auth login을 실행하세요. 브라우저 흐름을 완료한 뒤 상태를 다시 확인하세요. 토큰은 출력되지 않습니다. 이는 로컬 CLI 인증 확인이며 별도 호스팅 커넥터의 로그인을 확인하지 않습니다.

npx -y sosoapi auth status

npx -y sosoapi auth login

4. 소셜 계정 연결

계정 연결을 열거나 아래 로컬 명령을 사용하세요. 필요에 따라 threads를 instagram, facebook, youtube, x로 바꾸세요. 연결 흐름만 열리며 콘텐츠는 게시되지 않습니다.

표시된 조직과 워크스페이스를 확인하세요. 플랫폼을 선택하고 해당 승인 페이지에서 로그인한 뒤 정확한 계정, Page 또는 채널을 선택하세요. 동의와 복귀 시 필요한 계정 선택 확인을 완료하세요. 그다음 에이전트에게 의도한 워크스페이스의 연결된 계정을 새로 읽도록 요청하세요.

정상적인 기존 연결을 재사용하세요. 다른 조직이나 워크스페이스에 속해 있다면 앱에서 대상을 결정하고, 일반 설정 중 연결을 끊거나 이동하지 마세요. 기대 결과는 올바른 계정이 의도한 워크스페이스에 표시되고 현재 연결 상태와 기능 정보가 확인되는 것입니다. 콜백 성공만으로 게시 권한이 입증되지는 않습니다.

npx -y sosoapi connect threads

• 계정 연결

5. 게시 없이 접근 확인

연결된 에이전트 대화에 다음 내용을 붙여 넣으세요.

에이전트는 sosoapi_get_workspace_context와 sosoapi_list_connected_accounts를 사용해 알려진 정보를 재사용하고 선택한 workspace_id를 명시적으로 전달할 수 있습니다. 계정 초기화 중 첫 워크스페이스가 생성될 수 있지만 이 설정 확인은 소셜 게시물을 만들지 않습니다.

계속하기 전에 워크스페이스와 대상, 본인의 역할과 에이전트 접근 권한, 제안한 형식에 대한 대상의 지원을 확인하세요. 확인에 실패하면 문제 해결을 사용하세요. 패키지를 다시 설치해도 누락된 플랫폼 권한은 해결되지 않습니다.

게시하거나 예약하지 말고 내 SosoAPI 설정을 확인하세요.
사용할 수 있는 워크스페이스와 내가 선택한 워크스페이스의 소셜 계정을 보여 주세요.
내가 선택한 계정의 플랫폼, 계정 이름, 연결 상태, 제안한 형식의 게시 기능을 보여 주세요.
여러 워크스페이스나 계정이 일치할 수 있으면 어떤 것을 사용할지 물어보세요.
내부 ID는 도구 호출에 사용하고 나에게 찾거나 지어내라고 하지 마세요.

6. 첫 게시물 준비 및 승인

실제 게시물 하나와 대상 하나로 시작하세요. 이 초안 프롬프트의 대괄호 필드를 바꾸세요. 에이전트가 글을 쓰고 SosoAPI가 연결 및 게시 작업을 제공합니다. 주장, 맞춤법, 링크, 미디어는 직접 검토하세요.

향후 게시물에는 날짜, 현지 시간, IANA 시간대를 명시하세요. 일광 절약 시간제로 현지 시간이 모호하면 제출 전에 어느 시점을 뜻하는지 선택하세요. 이 단계의 기대 결과는 게시 요청을 제출하지 않고 검토할 정확한 초안을 만드는 것입니다.

SosoAPI를 사용해 제품 발표 하나를 준비하도록 도와주세요.

제품: [public product name]
확인된 사실: [what is available today]
대상 독자: [who this helps]
대상: [account label and platform]
언어: [language]
희망 현지 날짜 및 시간: [YYYY-MM-DD HH:mm]
시간대: [IANA timezone, for example Asia/Hong_Kong]
미디어: [none, a local file, or a public media URL]

내가 제공한 사실만 사용하고 대상의 형식 요건을 확인하세요.
정확한 초안, 미디어, 대상, 날짜, 시간, 시간대를 검토할 수 있도록 보여 주세요.
아직 예약하거나 게시하지 마세요.

예약 전에 정확한 게시물 승인

모든 세부 정보가 맞으면 아래 프롬프트로 구체적으로 지시하세요. 공개 게시로 이어질 수 있는 실제 예약이 생성됩니다. 실제로 게시하려는 콘텐츠와 계정을 사용하세요. 즉시 게시도 같은 세부 정보를 검토한 뒤 명시적으로 요청해야 합니다.

기대 결과: Scheduled Post ID, 의도한 대상, 접수된 시간, 현재 상태. 예약 접수는 제공자가 게시를 완료했다는 뜻이 아닙니다.

아래 승인된 정확한 게시물을 명시한 날짜, 시간, 시간대에 지정한 계정으로 예약하세요.

[최종 내용, 미디어, 대상, 날짜, 시간, 시간대를 붙여 넣으세요.]

먼저 일치하는 기존 예약을 확인하세요. 이 게시물을 한 번만 제출하고 저장된 결과를 다시 읽으세요. ID, 대상, 접수된 시간, 현재 상태를 반환하세요. 결과가 불확실하면 다른 작업 전에 기존 요청을 확인하세요.

7. 결과 확인, 일정 변경 또는 취소

에이전트에게 sosoapi_get_scheduled_post로 같은 Scheduled Post를 읽도록 요청하세요. 다음 페이지도 열 수 있습니다: https://app.sosoapi.ai/scheduled-posts/<post-id> 승인된 계정으로 로그인한 후 확인하세요. 여러 계정을 대상으로 하는 요청은 대상별로 확인하세요. 일부는 성공하고 다른 일부는 조치가 필요할 수 있습니다.

Scheduled Post [returned ID]의 현재 결과를 읽으세요.
대상, 예약 시간, 현재 상태, 게시 결과를 보여 주세요.
게시가 확인되면 사용 가능한 경우 실제 게시 링크도 포함하세요.
재시도하거나 일정을 변경하거나 다른 게시물을 만들지 마세요.

대기 중인 게시물 관리 및 나중에 확인

대기 중인 게시물을 변경하려면 ID와 새 세부 정보를 제공하세요. 에이전트는 지원되는 업데이트나 취소 전에 현재 버전과 가능한 작업을 읽어야 합니다. 취소 가능 여부는 전송 단계에 따라 달라지며 전송이 시작되면 사용할 수 없을 수 있습니다. 예약 취소로 이미 게시된 제공자 게시물이 삭제되지는 않습니다.

향후 예약의 저장된 세부 정보를 받은 뒤에는 대화를 떠나 나중에 같은 게시물로 돌아와도 됩니다. 별도로 설정하지 않았다면 종료된 에이전트 대화가 스스로 깨어나거나 알림을 보내겠다고 보장하지 않습니다.

8. 이미지 또는 동영상 추가 후 흐름 재사용

더 큰 일괄 작업을 준비하기 전에 단일 게시물 흐름부터 작동시키세요. 미디어가 로컬 파일인지, 공개 URL인지, 기존 SosoAPI 에셋인지 에이전트에게 알려 주세요.

로컬 파일은 로컬 MCP의 sosoapi_upload_asset로 업로드할 수 있습니다. 파일은 허용된 업로드 폴더 안에 있어야 하며, 범위 밖 경로를 지정하면 도구가 허용 위치를 안내합니다. 호스팅 MCP는 컴퓨터의 파일을 읽을 수 없습니다.

공개 URL은 sosoapi_import_asset_url로 가져온 뒤 include_asset=true로 sosoapi_get_asset_import_status를 확인하세요. 에셋이 준비될 때까지 기다리세요. 기존 에셋은 의도한 워크스페이스 소속이며 선택한 형식에 사용할 준비가 됐는지 확인하세요.

일반 예약 요청에는 등록된 에셋 ID와 정식 에셋 URL을 함께 사용합니다. 임시 미리보기 URL이나 원본 외부 URL로 대체할 수 없습니다. 지원되는 단일 이미지 URL 흐름에서는 sosoapi_post_image_url이 가져오기와 제출을 함께 처리합니다. 게시 작업이므로 먼저 전체 게시물을 승인하세요. 처리 중에는 접수된 게시물 ID를 보관하고, 계속하려고 다른 가져오기를 시작하지 마세요.

X는 미디어 없는 원본 TEXT 게시물 또는 준비된 등록 MP4 동영상 하나가 있는 VIDEO를 지원합니다. 동영상은 최소 0.5초이며 500 MiB 업로드 한도 이내여야 합니다. 동영상은 정확한 계정의 검증된 can_publish_video가 필요하며 텍스트 접근 권한만으로는 부족합니다. 오래된 연결은 동영상 업로드 권한으로 다시 연결하도록 본인의 승인이 필요할 수 있습니다. 텍스트, 해시태그, 링크는 X의 가중 글자 수 제한 안에 있어야 합니다. 사진, 답글, 인용, 재게시, 스레드 게시는 지원하지 않습니다. 업로드 또는 동영상 처리 접수는 게시 완료 결과가 아닙니다.

X에 제출하기 전에 의도한 workspace_id와 최종 텍스트로 sosoapi_get_x_usage를 읽으세요. 해당 한도와 비용은 일반 요금제 한도와 별개입니다. 반복 제출로 크레딧 한도를 우회하지 말고, 불확실한 게시는 다시 보내기 전에 결과를 확인하세요.

검토할 일괄 초안 준비 및 성과를 정확히 읽기

첫 게시물이 성공하면 아래 제품 출시 프롬프트를 사용해 보세요. 정확한 표를 승인한 후 요금제 한도에 맞는지 일괄 작업을 확인하세요. 접수된 대상과 거부된 대상을 따로 보고하고 접수된 각 게시물의 식별 정보를 보관하세요.

게시 접근 권한과 분석 접근 권한은 다를 수 있습니다. 나중에 성과 검토를 요청하면 사용할 수 없는 지표는 사용할 수 없다고 보고해야 합니다. 영을 지어내거나 게시물이 게시됐다는 이유로 모든 지표를 읽을 수 있다고 추론하지 마세요.

동일한 검증된 설정을 사용해 내가 제공한 공개 사실로 하루에 하나씩 일곱 개의 제품 발표 초안을 준비하세요. 각 행에 초안, 대상, 미디어, 현지 날짜, 시간, 시간대가 있는 검토 표를 보여 주세요. 정확한 표를 승인할 때까지 일곱 개 모두 초안으로 유지하세요.

9. CLI 및 API 안내

명시적 요청 파일이나 백엔드 통합에는 이 선택 경로를 사용하세요. 에이전트 사용자는 건너뛰어도 됩니다. 예시는 MCP와 동일한 계정, 워크스페이스, 게시 권한을 사용합니다.

설치된 패키지의 도움말과 내장 계약을 먼저 확인하세요. 계약 검사는 로그인이 필요하지 않습니다. 해당 패키지에 포함된 작업과 스키마가 표시됩니다. 다른 제공자의 요청 형식 대신 해당 필드 이름을 사용하세요.

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

CLI: 첫 인증된 컨텍스트 요청

auth login을 완료하세요. 텍스트 편집기에서 아래 JSON을 workspaces.json으로 저장한 뒤 명령을 실행하세요. 내용을 셸 명령에 삽입하지 말고 요청 본문은 파일로 전달하세요.

CLI는 schema_version, http_status, body를 반환합니다. 성공 응답에는 body.active_workspace_id와 body.workspaces가 포함됩니다. 이 응답에서 의도한 워크스페이스를 선택하세요. 활성 워크스페이스가 새 작업 대상을 암묵적으로 결정하지 않습니다. 새 계정의 첫 호출은 첫 워크스페이스를 초기화할 수 있습니다.

셸 종료 코드뿐 아니라 http_status와 body를 확인하세요. API 작업이 성공하지 않아도 명령이 HTTP 오류 봉투를 반환할 수 있습니다.

{}

npx -y sosoapi api post /identity-api/workspace/list < workspaces.json

CLI: 연결된 소셜 계정 선택

계정에 반환된 워크스페이스 ID로 accounts.json을 저장한 뒤 명령을 실행하세요. body.accounts에서 의도한 계정을 선택하세요. 예약에 쓰는 social_account_id는 SosoAPI 계정 ID이며 사용자 이름이나 제공자의 Page ID로 대체할 수 없습니다.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>"
}

npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.json

CLI: 승인한 Threads 텍스트 게시물 하나 예약

이것은 바로 실행할 게시물이 아니라 요청 템플릿입니다. 파일 편집기로 post.json을 저장하고 대괄호 값을 본인이 승인한 값으로 바꾸세요. 명시적 UTC 오프셋 또는 UTC를 뜻하는 Z가 있는 미래 ISO 타임스탬프를 선택하세요. display_timezone은 표시용 IANA 시간대이며 모호한 현지 타임스탬프를 완전한 일정으로 바꾸지는 않습니다.

UUID 같은 고유한 idempotency_key를 생성해 정확한 요청 본문과 함께 보관하세요. 동일한 요청을 재시도할 때는 같은 키를 사용하세요. 응답이 늦다고 새 키를 생성하면 안 됩니다. 게시물을 변경하면 다른 요청이므로 새 식별자를 선택하기 전에 원래 결과를 확인하세요.

내용, 계정, 시간, 권한, 현재 한도를 확인한 뒤 create 명령을 실행하세요. 실제 게시물이 예약됩니다. 접수되면 body.post.id를 보관하고 body.post.status, body.post.scheduled_at, body.post.destination을 읽으세요. body.deduped는 기존 요청의 재사용 여부를 나타냅니다. 접수는 제공자가 확인한 게시 완료를 뜻하지 않습니다.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>",
  "social_account_id": "<YOUR_THREADS_ACCOUNT_ID>",
  "caption": "<YOUR_APPROVED_POST_TEXT>",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<FUTURE_ISO_8601_TIME_WITH_OFFSET>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<NEW_STABLE_REQUEST_KEY>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/create < post.json

CLI: 저장된 게시물과 결과 읽기

반환된 ID로 post-status.json을 저장하세요. body.post, body.delivery, body.actions, body.outcomes를 읽으세요. 게시 완료 결과를 확인한 뒤 성공을 보고하세요. create 응답이 유실됐다면 저장된 식별 정보로 원래 요청을 복구하고 새 키로 다른 예약을 만들지 마세요.

{
  "id": "<RETURNED_POST_ID>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.json

CLI: 현재 결과에서 허용할 때만 취소

최신 읽기에서 취소가 허용되고 취소하려는 경우 반환된 ID와 현재 숫자 body.post.version으로 cancel.json을 저장하세요. 예시의 1은 설명용이므로 방금 읽은 버전으로 바꾸세요. 그다음 명령을 실행하고 결과를 확인하세요.

버전이 바뀌었거나 취소할 수 없으면 같은 게시물을 다시 읽고 실제 가능한 작업을 사용하세요. 버전 충돌을 우회하거나 취소를 이미 게시된 게시물 삭제와 혼동하지 마세요.

{
  "id": "<RETURNED_POST_ID>",
  "expected_version": 1
}

npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.json

HTTP: 자체 백엔드에서 호출

서버 측 통합은 Connection → API에서 API 키를 만들고 시크릿을 서버의 비밀 설정에 저장하세요. 현재 화면은 이름만 요청하며 워크스페이스나 기능 선택기는 없습니다. 사용자가 만든 키는 접근 가능한 워크스페이스 전체에서 operate, publish, engage를 기본으로 허용합니다. 이 권한이 통합에 적합한지 확인하세요. API 계약은 capabilities와 workspace_ids를 명시적으로 제한한 키도 지원합니다.

일반 에이전트 설정은 OAuth를 사용하므로 이 API 키 단계가 필요하지 않습니다. 예시의 SOSOAPI_ACCESS_TOKEN은 키를 담는 서버 측 예시 변수이며 SosoAPI CLI 설정이 아닙니다. CLI의 선택적 개인 액세스 토큰 변수는 VICKY_API_KEY입니다.

위의 workspaces.json 파일을 사용하세요. 직접 HTTP는 CLI의 http_status/body 봉투 없이 엔드포인트 본문을 반환하므로 실제 HTTP 상태와 JSON을 읽으세요. 자격 증명은 백엔드에 보관하고 브라우저 코드, 프롬프트, 스크린샷, 공유 요청 파일에 넣지 마세요.

자사 고객을 위한 제품에 소셜 연결을 내장하는 것은 별도의 통합 작업입니다. 이 단일 계정 안내는 고객 온보딩 흐름의 준비 완료를 입증하지 않습니다.

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer ${SOSOAPI_ACCESS_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data-binary @workspaces.json \
  'https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/workspace/list'

• API 키 관리: Connection → API
• API 참조
• API 키 생성 및 명시적 권한
• 인증 및 권한
• CLI 참조

10. 문제 해결

실제 오류와 진단 중인 연결을 기준으로 처리하세요. 권한을 늘리거나 제출을 반복한다고 모든 실패가 해결되지는 않습니다.

업데이트, 접근 철회 또는 도움 요청

아래 첫 명령은 MCP 서버를 시작하지 않고 최신 패키지 도움말을 확인합니다. 클라이언트가 저장된 명령에서 버전을 고정했다면 해당 명령을 의도적으로 업데이트하세요. 별도의 전역 설치를 업데이트해도 클라이언트에 고정된 사본은 바뀌지 않습니다.

로컬 기기를 철회하려면 Connection → Agent 또는 아래 auth logout 명령을 사용하세요. 호스팅 커넥터는 Connection → Agent에서 해당 승인을 철회하세요. API 키는 Connection → API에서 별도로 관리합니다. 에이전트 접근 권한을 철회해도 이미 접수된 예약은 취소되지 않으므로 따로 관리하세요.

도움이 필요하면 클라이언트 및 패키지 버전, 실패한 단계, 표시된 오류, 시간과 시간대를 제공하세요. 필요한 요청 또는 게시물 ID는 지원팀에 비공개로 공유하세요. 자격 증명, 승인 링크, 토큰이 포함될 수 있는 원시 로그는 보내지 마세요.

npx -y sosoapi@latest --help

npx -y sosoapi auth logout

• 에이전트 클라이언트 관리: Connection → Agent
• API 키 관리: Connection → API
• 문제 해결 참고
• SosoAPI 지원팀에 문의

설정 완료 체크리스트

게시물을 제출하지 않고도 연결 설정을 완료할 수 있습니다. 게시했다면 별도의 결과 확인으로 첫 게시 흐름이 완료됐는지 확인하세요.

• 클라이언트에서 SosoAPI 도구를 사용하거나 CLI/API에서 승인된 요청을 수행할 수 있습니다.
• 의도한 계정으로 로그인하고 올바른 워크스페이스를 선택했습니다.
• 소셜 계정이 표시되고 작업에 필요한 기능이 있습니다.
• 에이전트가 작업 준비만 할 수 있는지 예약과 게시도 할 수 있는지 이해합니다.
• 초안을 준비하고 정확한 대상, 내용, 시간을 검토할 수 있습니다.
• 게시물을 제출했다면 ID를 보관했으며 접수와 게시 확인을 구분할 수 있습니다.
• 실패를 확인하고 대기 중인 예약을 관리하며 접근 권한을 철회하는 방법을 알고 있습니다.