메인 콘텐츠로 건너뛰기

​
개요

이 튜토리얼에서 수행할 작업:
  • ABBYY Vantage MCP 서버를 Claude Code에 추가합니다
  • 연결이 정상적으로 동작하는지 확인합니다
  • SearchAbbyyVantageDocumentation 도구를 사용해 AI 워크플로우 내에서 문서를 검색합니다
예상 소요 시간: 약 5분

​
MCP 서버란 무엇인가요?

Model Context Protocol(MCP)는 AI 어시스턴트가 외부 도구 및 데이터 소스에 연결할 수 있게 해 주는 오픈 표준입니다. Claude Code에 MCP 서버를 추가하면, 콘텐츠를 수동으로 복사해 붙여넣을 필요 없이 AI가 구조화된 데이터나 기능에 직접 접근할 수 있습니다. ABBYY Vantage MCP 서버는 SearchAbbyyVantageDocumentation라는 단일 도구를 제공하며, 전체 Vantage 문서를 대상으로 시맨틱 검색을 수행합니다. Claude Code가 이 서버에 연결되어 있으면, 작업하는 동안 API Parameter, Skill 구성 옵션, 문제 해결 단계 등을 자동으로 조회할 수 있습니다.
MCP 서버는 공개 문서에 대한 읽기 전용 액세스를 제공합니다. 이 서버는 사용자의 Vantage 테넌트에 연결하지 않으며, 문서를 처리하지도 않고, Vantage 자격 증명을 요구하지도 않습니다.

​
사전 준비 사항

  • Claude Code가 설치되어 실행 중이어야 합니다.
  • 터미널 접근 권한 (macOS, Linux, 또는 WSL이 있는 Windows)
MCP 서버를 사용하기 위해 ABBYY Vantage 테넌트나 계정은 필요하지 않습니다.
1

CLI를 통한 추가 (권장)

터미널에서 다음 명령을 실행하여 Claude Code에 MCP 서버를 등록합니다.
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse
Scope 옵션:기본적으로 이 명령은 MCP 서버를 프로젝트 수준으로 추가하므로, 현재 디렉터리에서만 사용할 수 있습니다(설정은 .claude/settings.json에 저장). 모든 프로젝트에서 사용할 수 있도록 하려면 --scope user 플래그를 추가합니다.
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse --scope user
Scope설정 파일사용 시점
Project (기본값).claude/settings.json특정 단일 프로젝트에서만 사용할 때
User~/.claude/settings.json이 컴퓨터의 모든 프로젝트에서 사용할 때
2

대안: 수동 구성

수동으로 구성하려면, 아래 JSON을 설정 파일에 추가합니다.
프로젝트 루트에 .claude/settings.json 파일을 생성하거나 수정합니다.
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
홈 디렉터리의 ~/.claude/settings.json 파일을 수정합니다.
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

연결 확인

Claude Code를 다시 시작한 다음, 서버가 등록되었는지 확인하기 위해 다음 슬래시 명령을 실행합니다.
/mcp
여기에서 abbyy-vantage가 연결됨 상태로 표시되어야 합니다. 도구가 정상 작동하는지 확인하려면 Vantage 관련 질문을 Claude에게 해 보십시오.
“Vantage Processing API에서 문서를 제출하려면 어떤 매개변수가 필요합니까?”
그러면 Claude Code가 SearchAbbyyVantageDocumentation를 호출하고 문서에서 검색한 결과를 반환합니다.
/mcp에 서버가 표시되지 않으면, URL이 끝에 슬래시 없이 https://docs.abbyy.com/mcp로 정확히 입력되어 있는지 확인하십시오. 또한 터미널에서 서버에 접근할 수 있도록 네트워크 연결 상태도 확인하십시오.

​
사용 가능한 도구

ABBYY Vantage MCP 서버는 다음과 같은 단일 도구를 제공합니다: SearchAbbyyVantageDocumentation ABBYY Vantage 문서 전체를 대상으로 시맨틱 검색을 수행하고, 가장 관련성이 높은 콘텐츠를 반환합니다. Vantage와 관련된 질문을 하면 Claude Code가 이 도구를 자동으로 호출합니다. 예시 쿼리:
  • “Vantage에서 Document Skill을 어떻게 구성하나요?”
  • “minConfidence 파라미터는 어떤 역할을 하나요?”
  • “Vantage에서 LLM 연결을 어떻게 설정하나요?”
  • “Vantage는 어떤 내보내기 형식을 지원하나요?”
  • “Vantage REST API로 어떻게 인증하나요?”

​
사용 사례

API 통합

IDE를 떠나지 않고도 엔드포인트 Parameter, 인증 방법, 요청/응답 형식을 바로 확인하세요

Skill 구성

Document Skills, 프로세스 스킬, Advanced Designer에 대한 구성 옵션과 모범 사례를 빠르게 찾아보세요

문제 해결

오류 메시지와 알려진 문제를 검색해 통합 디버깅 중 발생한 이슈를 더 빠르게 해결하세요

기능 탐색

프로젝트를 계획하면서 Vantage가 지원하는 기능(추출 모델, 지원 포맷, 테넌트 설정 등)을 살펴보세요

​
효과적인 질문을 위한 팁

  • 구체적으로 작성: 일반적으로 묻기보다 질문에 기능 이름이나 API 엔드포인트 이름을 포함하세요
  • Vantage 용어 사용: “Process Skill”, “Document Skill”, “Skill Designer”, “tenant”와 같은 용어를 사용하면 더 정확한 결과를 얻을 수 있습니다
  • 후속 질문 활용: Claude Code는 대화 맥락을 유지하므로, 후속 프롬프트로 결과 범위를 점점 더 좁혀 나갈 수 있습니다
  • 코드와 함께 사용: API 응답이나 구성 스니펫을 붙여 넣고, Vantage 설명서를 참고해 Claude에게 이를 설명해 달라고 요청하세요

​
문제 해결

서버가 /mcp에 표시되지 않음 구성 파일이 올바르게 저장되었는지, JSON이 유효한지(끝에 불필요한 쉼표가 없는지) 확인하세요. 변경 후 Claude Code를 완전히 종료했다가 다시 시작하세요. 도구가 자동으로 호출되지 않음 Claude Code는 관련성에 따라 MCP 도구를 호출합니다. 도구가 사용되지 않는다면 질문을 더 명확하게 작성해 보세요. 예를 들어 “Search the ABBYY Vantage docs for…”라고 말하거나, 특정 Vantage 기능 이름을 직접 언급해 보세요. 검색 결과가 관련성이 낮음 쿼리를 작성할 때 Vantage 인터페이스나 문서에 사용되는 용어를 사용해 다시 표현해 보세요. “workflow”나 “settings”처럼 포괄적인 용어만 단독으로 사용하는 것은 피하고, “Vantage” 또는 특정 기능 이름과 함께 사용하세요.

​
요약

다음을 모두 완료했습니다:
  • ✅ ABBYY Vantage MCP 서버를 Claude Code에 추가했습니다
  • ✅ /mcp를 사용해 연결을 확인했습니다
  • ✅ AI 워크플로우에서 문서 검색을 시작하는 방법을 익혔습니다

​
다음 단계

API 소개

Vantage Processing REST API 사용을 시작하세요

문서 처리

프로세스 스킬을 만들어 SFTP를 통해 문서 처리를 자동화하세요

LLM 연결 구성

Vantage를 OpenAI 또는 Microsoft Foundry에 연결하세요

프롬프트 기반 추출

자연어 프롬프트를 사용해 문서에서 데이터를 추출하세요