문서

MCP

ChatGPT, Claude, Cursor 같은 MCP 클라이언트에서 Schift API 키로 Schift를 바로 연결하는 방법입니다.

AI 클라이언트에서 Schift 메모리, 버킷 검색, 승인된 워크플로우 도구를 바로 쓰려면 호스팅 MCP 엔드포인트를 사용하세요. 별도 MCP 서버를 직접 띄울 필요가 없습니다.

호스팅 서버 연결

항목	값
Server URL	`https://mcp.schift.io/mcp`
Authorization	`Bearer <your-schift-api-key>`

Schift API 키를 그대로 사용

mcp.schift.io는 전달받은 bearer token으로 https://api.schift.io를 호출합니다. 따라서 모든 도구 호출은 해당 Schift API 키의 권한으로 실행됩니다.

OpenAI Responses API 예시

json{
  "type": "mcp",
  "server_label": "schift",
  "server_url": "https://mcp.schift.io/mcp",
  "headers": {
    "Authorization": "Bearer <your-schift-api-key>"
  },
  "allowed_tools": [
    "search",
    "fetch",
    "schift_search",
    "schift_upload_document",
    "schift_memory_search",
    "schift_workflow_list",
    "schift_workflow_dry_run",
    "schift_workflow_run"
  ],
  "require_approval": "never"
}

도구가 하는 일

도구	용도
`search` / `fetch`	Schift 버킷 내부 문서 검색과 검색 결과 본문 조회. 외부 웹 검색이 아닙니다.
`schift_search`	특정 Schift 버킷 또는 컬렉션 내부 검색
`schift_upload_document`	텍스트 또는 base64 파일을 Schift 버킷에 업로드하고 비동기 인덱싱 작업 생성
`schift_memory_search`	인증된 사용자의 연결된 메모리 소스 검색
`schift_workflow_list`	사용자가 볼 수 있는 워크플로우 도구 목록 조회
`schift_workflow_dry_run`	외부 효과가 나기 전에 워크플로우 실행 미리보기
`schift_workflow_run`	게시된 워크플로우 실행. Schift의 리뷰 경계는 그대로 적용됩니다.

직접 호스팅은 선택 사항

사내 전용 MCP 배포가 필요할 때만 schift-mcp를 직접 실행하세요. 일반 사용자는 mcp.schift.io에 Schift API 키를 넣어 연결하면 됩니다.