Octri API 문서 자동 생성과 SDK 개발 도구

Octri는 API 명세를 바탕으로 개발자 문서와 클라이언트 SDK를 만들고, MCP 연결과 모니터링까지 제공하는 개발 플랫폼입니다. API 문서 자동 생성 이후의 편집, 검토, 배포 과정도 함께 관리하려는 팀을 위한 서비스입니다.

Octri는 쉽게 말해 무엇을 하는 서비스인가요?

API 명세를 서비스의 사용 설명서 원본이라고 생각하면 됩니다. Octri는 이 원본을 개발자가 읽는 문서 사이트, 프로그램에 설치하는 라이브러리, AI 도우미가 API를 이용할 때 쓰는 도구로 바꿔 줍니다. 모니터링을 연결하면 배포된 연동에서 어떤 문제가 발생하는지도 살펴볼 수 있습니다.

SaaS 개발팀, API 제공 업체, 여러 언어의 고객 연동을 지원하는 작은 팀에 유용합니다. 실제로 작동하는 API와 올바른 명세가 먼저 있어야 하며, 생성된 설명과 코드의 검토는 필요합니다. 문서, SDK, MCP, 모니터링 모듈을 모두 함께 사용할 필요는 없습니다.

명세를 가져와 검토 후 게시하는 순서

API Studio에 명세 파일을 올리거나 GitHub 저장소를 연결하면 엔드포인트 설명, 중첩 스키마, 요청 예시를 구성할 수 있습니다. 생성한 페이지를 직접 수정하고 인증이나 온보딩을 설명하는 MDX 가이드도 추가할 수 있습니다.

1. 명세를 가져온 뒤 작업 이름, 인증 방식, 요청과 응답 스키마를 확인합니다.
2. 문서를 생성하고 실제 API 동작과 설명이 일치하는지 검토합니다.
3. 테스트 환경에서 대화형 요청 콘솔로 정상 응답과 오류 응답을 확인합니다. 요청은 브라우저에서 전송되므로 API의 CORS 설정을 점검해야 합니다.
4. 문서 게시 설정과 필요한 SDK 언어, 패키지 레지스트리 연결을 구성합니다.
5. 새 초안과 변경 사항을 확인한 뒤 배포를 승인합니다.

GitHub 동기화는 모든 요금제에서 제공됩니다. 명세 변경으로 다시 빌드할 수 있지만, 공식 절차에서는 새 SDK 버전을 레지스트리에 배포하기 전에 승인 단계를 거칩니다.

지원하는 SDK 언어와 조정할 수 있는 부분

SDK Studio는 TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift, Dart를 지원합니다. 메서드 이름과 언어별 설정을 조정하거나 특정 엔드포인트를 제외할 수 있고, 레지스트리 연동으로 라이브러리를 배포할 수 있습니다.

플랫폼의 전체 지원 언어가 10개라는 뜻이며, 실제로 활성화할 수 있는 언어 수는 요금제에 따라 다릅니다. 사용자 정의 SDK 코드는 Growth부터 제공됩니다. 배포 전에는 인증과 특이한 응답 스키마를 실제 API에 맞춰 확인하는 것이 좋습니다.

무료 사용 범위와 유료 요금제

2026년 10월 6일 확인한 공식 월간 가격입니다. 미국 달러 기준이며 세금은 별도입니다. 원화 결제 금액을 의미하지 않습니다.

• Free: 프로젝트 1개, SDK 언어 1개, 엔드포인트 50개, 월 모니터링 100MB, 최초 1회 AI 크레딧 100개.
• Starter: 월 49달러, SDK 언어 2개.
• Growth: 월 99달러, 언어 4개, 버전 관리와 사용자 정의 코드·컴포넌트.
• Business: 월 249달러, 전체 10개 언어와 화이트 라벨 옵션.
• Enterprise: 별도 견적. 생성기와 문서 렌더러를 자체 인프라에서 실행할 수 있습니다.

엔드포인트 하나의 설명 생성 또는 Ask-the-docs 답변 한 번에 AI 크레딧 1개가 사용됩니다. 수동 편집, SDK 빌드, 호스팅은 이 크레딧을 소모하지 않습니다. 크레딧이 없어지면 AI 생성과 답변이 중단되지만 게시된 문서, 빌드와 모니터링은 계속 작동합니다. 전체 한도와 추가 옵션은 공식 요금제 비교를 확인하세요.

운영 오류를 확인하고 데이터 처리를 이해하기

모니터링은 기본적으로 꺼져 있습니다. 생성된 SDK와 지원하는 백엔드 패키지에 연결하면 로그, 묶음으로 정리된 이슈, 트레이스, 가용성 검사, 알림을 확인할 수 있습니다. Octri는 클라이언트와 데이터 수집 단계에서 민감 정보를 가리는 처리를 설명하고 있습니다.

개인정보 처리방침에 따르면 생성 작업에는 필요한 명세 텍스트가 모델 제공 업체로 전달됩니다. Ask-the-docs에는 질문과 관련 문서 구절이 사용되고, 검색을 위한 임베딩에도 문서가 처리됩니다. Octri는 자사와 제공 업체가 해당 콘텐츠로 모델을 학습하지 않는다고 밝힙니다. 모든 처리가 사용자 컴퓨터 안에서만 이루어지는 서비스는 아닙니다.

MCP로 문서와 API를 AI 도우미에 연결하기

Octri MCP 서버에는 문서용 도구 7개가 있으며, 포함된 API 엔드포인트를 실행 가능한 도구로 제공할 수 있습니다. Claude, Cursor 등 MCP 클라이언트가 게시된 문서를 읽고 필요한 연동 정보를 찾는 데 활용할 수 있습니다.

문서 접근에는 프로젝트 ID가 필요하고, API 실행에는 해당 API의 인증 정보가 필요합니다. 인증 정보는 서버를 실행하는 장치에 보관됩니다. 실제 호출을 허용하기 전에 대상 환경, 권한 범위와 제외할 엔드포인트를 정하세요.

자주 묻는 질문

무료로 문서를 게시할 수 있나요?

네. Free 한도 안에서 시작할 수 있으며 사용자 지정 도메인과 GitHub 동기화도 제공됩니다. AI 크레딧 100개는 매월 충전되는 수량이 아니라 최초 1회 지급량입니다.

어떤 명세 파일을 가져올 수 있나요?

공식 지원 목록에는 OpenAPI 3.0/3.1, Swagger 2.0, Postman, AsyncAPI와 JSON·YAML 형식이 포함됩니다. 변환된 파일은 가져온 뒤 스키마와 예시를 확인하세요.

직접 수정한 설명은 업데이트 후에도 남나요?

Octri는 수동으로 수정한 필드를 유지하고 나머지 생성 필드를 갱신한다고 설명합니다. 명세가 바뀌면 초안과 변경 내역을 검토한 뒤 게시하세요.

공식 문서와 개발자 지원

• Octri 개발자 문서: 설정, SDK 언어별 가이드와 MCP 연결 방법.
• Octri GitHub: 공개 패키지와 SDK 문제 제보.
• 제품 및 결제 지원: 공식 문의와 문제 해결 안내.