# 개발자 질문과 답변

표준 URL: https://sosoapi.ai/ko/docs/developer-faq

npm 별칭, API와 MCP 선택, 인증, 미디어, 안전한 재시도, 요청 제한, 게시 완료의 의미에 대한 명확한 답변.

## npm 패키지 네 개는 서로 다른 SDK인가요?

아니요. sosoapi 또는 별칭 @sosoapi/cli, sosoapi-cli, sosoapi-mcp 중 하나만 설치하세요. 각 별칭은 동일한 정확한 버전의 CLI와 MCP 구현을 사용합니다. 하나만 있으면 됩니다.

- [설치 및 패키지](https://sosoapi.ai/ko/docs/installation)

## HTTP, CLI, MCP 중 무엇을 써야 하나요?

서버에서는 HTTP, 셸 자동화와 스키마 확인에는 CLI, 호환 에이전트에는 MCP를 사용하세요. 같은 공개 API 계약을 사용합니다. MCP는 로컬 파일 업로드와 미디어 준비를 처리하는 이미지 URL 게시 도구도 제공합니다. 서버 자격 증명을 브라우저 코드에 넣지 마세요.

- [전체 API 참조](https://sosoapi.ai/ko/docs/api)

- [MCP 도구 참조](https://sosoapi.ai/ko/docs/mcp)

## 설정이나 OAuth 동의가 게시물을 게시하나요?

아니요. 설정은 아무것도 게시하지 않습니다. OAuth 동의는 선택한 범위에서 계속 접근을 허용하며 쓰기마다 새 브라우저 승인을 요구하지 않습니다. 검토를 기다릴 시점을 에이전트에 알려 주고 게시를 요청하기 전에 계정, 콘텐츠, 시간을 확인하세요.

- [인증 및 권한](https://sosoapi.ai/ko/docs/authentication)

## HTTP 200 또는 202는 게시 완료를 뜻하나요?

아니요. 요청은 접수, 예약 또는 처리 중일 수 있습니다. 게시물 ID를 저장하고 결과가 게시를 확인할 때까지 같은 Scheduled Post를 읽으세요. 가능하면 고유 링크를 포함하고 대상별 결과를 별도로 보고하세요.

- [게시 결과](https://sosoapi.ai/ko/docs/publishing-api-reference)

## 시간 초과 후 재시도해도 되나요?

먼저 기존 작업을 확인하세요. Scheduled Post ID를 유지하고 같은 요청에는 같은 멱등성 키를 재사용하세요. 페이로드가 바뀌면 다른 요청입니다. 기존 게시물의 재시도, 수정, 취소에는 현재 버전과 해당 상태에서 SosoAPI가 제공하는 작업을 사용하세요.

- [안전한 오류 처리](https://sosoapi.ai/ko/docs/troubleshooting)

## 클라이언트에 도구가 없는 이유는 무엇인가요?

프로필, 연결 유형, 클라이언트의 서버 재로드 여부를 확인하세요. core는 관리 도구를 숨기고 HTTP 연결에는 로컬 파일 업로드가 없습니다. 제공 여부는 도구 참조에 있습니다. 프로필 변경은 계정 권한이나 적격성을 바꾸지 않습니다.

- [MCP 도구 참조](https://sosoapi.ai/ko/docs/mcp)

## 원격 MCP로 로컬 파일을 업로드할 수 있나요?

아니요. 허용 폴더의 파일은 로컬 MCP로 업로드하거나 HTTP로 공개 미디어 URL을 가져오세요. 준비될 때까지 확인한 뒤 등록된 에셋 ID와 정식 URL을 함께 사용하세요. 접수된 가져오기는 아직 진행 중입니다.

- [MCP 도구 참조](https://sosoapi.ai/ko/docs/mcp)

## 요청 속도와 요금제 제한은 무엇인가요?

필드, 목록, 페이지 크기 제한은 각 스키마를 확인하세요. studio-api는 사람의 세션에 사용자당 분당 240개 요청을 허용하며, 해당 사용자의 머신 자격 증명에는 별도 분당 480개 버킷을 적용합니다. 429 및 Retry-After를 따르세요. 요금제 할당량, 제공업체 제한, 계정 적격성은 별개입니다. 대규모 실행 전에 현재 청구 및 기능 정보를 읽으세요.

- [게시 API 제한](https://sosoapi.ai/ko/docs/publishing-api-reference)

## Markdown과 스키마는 어디에 있나요?

안내, API 작업 또는 MCP 도구 URL에 .md를 붙이면 Markdown 버전을 볼 수 있습니다. API 색인에는 공개 JSON 계약과 OpenAPI 3.1 문서 링크가 있습니다. 페이지 색인은 llms.txt, 두 언어 전체 참조는 llms-full.txt에서 시작하세요. 공개 문서이며 계정 데이터나 자격 증명은 포함하지 않습니다.

- [전체 API 참조](https://sosoapi.ai/ko/docs/api)

- [LLM 색인](https://sosoapi.ai/ko/llms.txt)

## 이 문서가 검색 노출이나 AI 인용을 보장하나요?

아니요. HTML 페이지, 표준 URL, 구조화된 메타데이터, Markdown은 시스템의 문서 읽기를 돕습니다. 검색 엔진과 AI 서비스는 색인, 순위, 인용을 여전히 직접 선택합니다. 페이지 접근 가능 여부와 그 결과는 별도로 확인하세요.