원격 MCP 서버를 지원하는 AI 에이전트에 PDFCraft를 연결하세요. PDF를 Markdown이나 EPUB으로 변환하고 PDF와 EPUB 도서를 번역할 수 있습니다. 잔액 조회, 비용 예상, 변환 결과 다운로드도 가능합니다.
연결 설정하기
- OOMOL Console에서 본인의 API Key를 만드세요.
- 에이전트 설정에서 원격 MCP 서버를 추가하세요. URL에
https://api.pdfcraft.ai/v1/mcp를 입력하고 전송 방식으로 Streamable HTTP를 선택하세요. Authorization: Bearer YOUR_API_KEY헤더를 추가하고YOUR_API_KEY를 본인의 키로 바꾸세요.
아래 JSON은 연결에 필요한 정보를 보여 줍니다. 설정 항목의 이름은 클라이언트마다 다르므로 URL과 HTTP 헤더 설정에 해당 값을 입력하세요.
{ "url": "https://api.pdfcraft.ai/v1/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" }}키는 클라이언트의 보안 설정에 보관하세요. 대화에 붙여 넣거나 파일 URL에 넣지 마세요. 변환에는 PDFCraft 크레딧이 사용되며, 충전 페이지에서 충전할 수 있습니다.
호환성 확인하기
서비스는 Streamable HTTP와 MCP 프로토콜 버전 2026-07-28을 사용합니다. 클라이언트가 이 버전을 지원하고 Bearer 인증 헤더를 직접 설정할 수 있어야 합니다. 2025년 버전의 이전 초기화 및 세션 방식은 지원하지 않습니다.
대화형 OAuth 로그인은 제공하지 않습니다. OAuth를 필수로 요구하고 Bearer API Key를 설정할 수 없는 클라이언트는 직접 연결할 수 없습니다.
첫 변환 시도하기
연결하면 에이전트가 도구 목록과 사용 설명을 확인할 수 있습니다. 먼저 get_capabilities를 호출해 지원 형식과 언어, 작업 순서를 확인하도록 요청하세요. 예를 들면 다음과 같습니다.
이 PDF를 EPUB으로 변환해 줘. 시작하기 전에 잔액을 확인하고 비용을 예상해 줘.
파일을 업로드하려면 에이전트가 실제 파일 내용을 읽을 수 있어야 합니다. 로컬 경로만으로는 원격 서버가 파일에 접근할 수 없습니다. 이후 작업 생성, 파일 업로드, 처리 시작, 진행 상황 조회, 다운로드 링크 발급을 진행할 수 있습니다. 나중에 이어서 진행할 수 있도록 작업 UUID를 저장하세요.
기본적으로 전체 파일을 다운로드합니다. 미납 금액으로 다운로드가 차단되었다면 충전 후 같은 작업의 링크를 다시 요청하세요. 일부만 포함된 파일은 명시적으로 요청하고 해당 버전이 있을 때만 제공됩니다.
애플리케이션에서 직접 연동하려면 REST API 레퍼런스를 참고하세요.