MCP·AI로 소스 활용하기
Cursor, Windsurf 같은 AI 코드 에디터나 Claude Code, Claude Desktop 같은 AI 도구를 사용하면, 소스(Sauce)의 API 문서와 개발 가이드·일반 문서를 자연어 질의만으로 확인하고 연동 작업을 진행할 수 있습니다. 이를 위해 소스(Sauce)는 Sauce MCP 서버와 llms.txt 문서 인덱스를 제공합니다.
1. AI 도구 활용 방식
소스(Sauce) 연동 작업에서는 API 문서와 개발 가이드를 찾아보고 API 호출 코드를 작성하는 과정이 반복적으로 필요합니다.
아래 두 가지 방식을 활용하면 필요한 정보를 AI 도구에서 자연어 질의로 확인하고, 반복적인 문서 검색과 코드 작성 과정을 줄이며 연동 작업을 진행할 수 있습니다.
| 기능 영역 | 설명 | 제공 방식 |
|---|---|---|
| API 호출 | AI 도구가 Sauce API 기능을 직접 호출할 수 있습니다. | Sauce MCP 서버 |
| API 문서 조회 | API 스펙을 실시간으로 검색해 필요한 정보를 조회합니다. | Sauce MCP 서버 |
| 실시간 데이터 조회 | 연동된 Sauce 계정의 데이터를 즉시 조회합니다. | Sauce MCP 서버 |
| 코드 생성 지원 | Sauce 연동에 필요한 코드 작성을 지원합니다. | Sauce MCP 서버 |
| 개발 가이드 및 사용자 가이드 | 게시된 Sauce 개발 가이드 문서와 사용자 가이드를 찾아 답변에 활용합니다. | llms.txt 문서 인덱스 |
2. MCP로 API 문서 조회하기
설정하기
소스는 https://docs.sauce.im/mcp 에서 원격 MCP 서버를 제공합니다. 사용 중인 AI 도구에 아래 정보를 추가해 MCP 서버를 등록합니다.
터미널에서 아래 명령어로 등록:
claude mcp add --transport http sauce-doc https://docs.sauce.im/mcp등록 후 claude mcp list 명령으로 연결 상태를 확인할 수 있습니다.
$ claude mcp list
sauce-doc: https://docs.sauce.im/mcp (HTTP) - ✔ Connected설정 파일을 직접 수정한 경우, 적용을 위해 사용 중인 AI 에디터(또는 Claude Code) 세션을 재시작해야 새로 등록한 MCP 서버가 로드됩니다.
사용 예시
설정이 끝나면 AI 도구의 대화창에서 바로 아래처럼 질문할 수 있습니다.
- "상품 조회 API 스펙 알려줘" →
product-v2스펙의GET /v2/product/{productId}엔드포인트를 찾아 파라미터와 응답 형식을 보여줍니다. - "라이브 조회하는 API 있어?" →
saucelive스펙의GET /V1/front/broadcast/{partnerId}/{broadcastId}(특정 라이브 조회),GET /V1/front/broadcast(최신 라이브 및 VOD 조회) 등을 찾아줍니다. - "클립 조회 API 예시 보여줘" →
sauceclip스펙의GET /clip/{clipId}엔드포인트 상세 스펙과 curl 예시를 보여줍니다.
이처럼 AI 도구가 MCP 서버를 통해 스펙 목록 조회, 엔드포인트 검색, 엔드포인트 상세 조회, API 실행까지 자연어 요청만으로 처리합니다.
3. llms.txt로 개발 가이드 및 사용자 가이드 확인하기
사용 방법
연동 방법, 주의 사항 같은 개발 가이드 문서 뿐 아니라 계정 관리, 운영 프로세스 정보를 담은 사용자 가이드까지 별도 설정 없이 사용 중인 AI 도구가 가진 웹 페이지 조회 기능으로 함께 확인할 수 있습니다.
소스는 개발 가이드·API 레퍼런스·일반 문서를 모두 포함한 전체 문서 목록을 정리한 인덱스 파일을 https://docs.sauce.im/llms.txt 에서 제공합니다.
AI에게 이 주소를 참고하도록 요청하면, AI가 인덱스에서 관련 문서 링크를 찾은 뒤 해당 페이지를 직접 읽고 답변합니다.
사용 예시
- "https://docs.sauce.im/llms.txt 참고해서 소스라이브 플레이어 설치 방법 찾아줘" → AI가
llms.txt인덱스에서라이브러리 설치문서 링크를 찾고, 해당 페이지를 읽어 설치 절차를 요약해 답변합니다. - "https://docs.sauce.im/llms.txt 에서 브릿지 연동 방법 문서 찾아줘" →
브릿지 이벤트 연동문서 링크를 찾아, 상품 클릭/쿠폰/리워드 등 이벤트별 연동 방법을 요약해 답변합니다.
개발 가이드뿐 아니라 계정 관리, 운영 프로세스 같은 정보를 담은 사용자 가이드도 같은 방식으로 찾아 확인할 수 있습니다.