문서

사용 가이드

대시보드, API, SDK, CLI, MCP를 기준으로 Schift를 실제로 쓰는 팀을 위한 실전 안내입니다.

Schift는 문서 업로드, 검색, 출처 기반 답변 생성을 한 번에 제공하는 managed RAG 인프라입니다. 같은 데이터 표면을 대시보드, REST API, SDK, CLI, MCP에서 공통으로 사용할 수 있습니다.

어떤 표면을 써야 하나

표면	이럴 때 사용	진입점
대시보드	API 키 발급, 과금 확인, 버킷 상태 확인을 브라우저에서 하고 싶을 때	`https://schift.io/app`
REST API	가장 얌은 형태로 자체 백엔드나 서비스에 붙이고 싶을 때	`https://api.schift.io`
Python SDK	스크립트, ingestion, 검색, migration 작업을 빠르게 돌리고 싶을 때	`pip install schift`
TypeScript SDK	TS 또는 Node 환경에서 Schift를 붙일 때	`npm install @schift-io/sdk`
CLI	반복 가능한 터미널 명령과 운영 흐름이 필요할 때	`pip install schift-cli`
MCP	Claude Desktop 또는 Claude Code에서 Schift를 직접 붙이고 싶을 때	`npx schift-mcp`

일반적인 사용 흐름

대시보드에서 API 키를 만들거나 복사합니다.
파일을 버킷에 업로드하거나, 호스티드 컨렉션에 문서를 적재합니다.
검색만 필요하면 bucket search 또는 query를, 답변까지 한 번에 원하면 RAG chat을 사용합니다.
같은 키를 SDK, CLI, MCP에도 연결해서 로컬 툴과 운영 환경을 같은 계정으로 맞춥니다.

연동 체크리스트

bash# REST API
export SCHIFT_API_KEY=sch_your_key_here

# Python SDK
pip install schift

# TypeScript SDK
npm install @schift-io/sdk

# CLI
pip install schift-cli

# MCP
npx schift-mcp

하나의 기준 키를 유지

환경별로 살아 있는 API 키를 하나씩 정하고 가능하면 SCHIFT_API_KEY 환경변수를 기준으로 사용하세요. 그러면 SDK, CLI, MCP 설정이 따로 놀지 않습니다.

가장 많이 쓰는 작업

목표	권장 경로
원본 파일을 올리고 OCR, 청킹, 임베딩을 맡기기	`POST /v1/buckets/{id}/upload` 또는 SDK bucket helper
업로드한 문서 전체에 대해 시맨틱 검색하기	`POST /v1/buckets/{id}/search` 또는 `client.query(...)`
출처와 함께 답변을 한 번에 받기	`POST /v1/chat`
OpenAI 호환 LLM 라우터로 쓰기	`POST /v1/chat/completions`