메인 콘텐츠로 건너뛰기

​
개요

수행할 내용:
  • VS Code의 GitHub Copilot에 ABBYY Vantage MCP 서버를 추가합니다.
  • 연결이 정상적으로 작동하는지 확인합니다.
  • Copilot Chat 내에서 SearchAbbyyVantageDocumentation 도구를 사용해 문서를 검색합니다.
완료 시간: 약 5분

​
MCP 서버란 무엇인가요?

Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구와 데이터 소스에 연결할 수 있도록 하는 개방형 표준입니다. GitHub Copilot에 MCP 서버를 추가하면 콘텐츠를 수동으로 복사해 붙여넣지 않아도 AI가 구조화된 데이터나 기능에 직접 액세스할 수 있습니다. ABBYY Vantage MCP 서버는 전체 Vantage 문서에서 시맨틱 검색을 수행하는 단일 도구 SearchAbbyyVantageDocumentation을 제공합니다. Copilot에 이 서버가 연결되어 있으면 작업 중에 API 매개변수, 스킬 구성 옵션, 문제 해결 단계 등을 자동으로 찾아볼 수 있습니다.
MCP 서버는 공개 문서에 대한 읽기 전용 액세스를 제공합니다. Vantage 테넌트에 연결하지 않으며, 문서를 처리하지도 않고, Vantage 자격 증명도 필요하지 않습니다.

​
사전 요구 사항

  • VS Code 버전 1.99 이상 (MCP 지원 필요)
  • GitHub Copilot 확장 프로그램이 설치되어 있고 로그인한 상태여야 합니다
MCP 서버를 사용하는 데 ABBYY Vantage 테넌트나 계정은 필요하지 않습니다.
1

명령 팔레트로 추가(권장)

VS Code 명령 팔레트를 사용해 MCP 서버를 등록합니다:
  1. Cmd+Shift+P(macOS) 또는 Ctrl+Shift+P(Windows/Linux)로 명령 팔레트를 엽니다
  2. **“MCP: Add Server…”**를 입력하고 선택합니다
  3. 전송 유형으로 HTTP를 선택합니다
  4. URL을 입력합니다: https://docs.abbyy.com/mcp
  5. 이름을 입력합니다: abbyy-vantage
  6. 범위를 선택합니다: Workspace 또는 User
범위구성 위치사용 시기
Workspace.vscode/mcp.json특정 프로젝트 하나
User명령 팔레트를 통한 사용자 설정이 컴퓨터의 모든 프로젝트
2

대안: 수동 구성

수동으로 구성하려면 해당 구성 파일에 서버 항목을 추가합니다.
프로젝트 루트에 .vscode/mcp.json 파일을 만들거나 편집합니다:
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
명령 팔레트(Cmd+Shift+P / Ctrl+Shift+P)를 열고 **“MCP: Open User Configuration”**을 입력한 다음, 아래 항목을 추가합니다:
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

연결 확인

  1. 명령 팔레트를 열고 **“MCP: List Servers”**를 실행한 뒤 abbyy-vantage가 연결된 상태로 표시되는지 확인합니다
  2. Copilot Chat을 엽니다(사이드바에서 Copilot 아이콘을 클릭하거나 Ctrl+Shift+I / Cmd+Shift+I를 누릅니다)
  3. 채팅 패널 상단의 모드 선택기를 사용해 Agent 모드로 전환합니다
  4. 채팅 입력창에서 도구 아이콘을 클릭한 뒤 목록에 SearchAbbyyVantageDocumentation이 표시되는지 확인합니다
  5. 질문으로 테스트합니다:
“문서를 제출하려면 Vantage Processing API에 어떤 매개변수가 필요합니까?”
Copilot은 SearchAbbyyVantageDocumentation를 호출하고 문서에서 결과를 반환합니다.
URL은 끝에 슬래시를 붙이지 말고 반드시 https://docs.abbyy.com/mcp로 정확히 입력해야 합니다. 또한 VS Code가 서버에 연결할 수 있도록 네트워크에 액세스할 수 있는지도 확인하세요.

​
사용 가능한 도구

ABBYY Vantage MCP 서버는 하나의 도구를 제공합니다. SearchAbbyyVantageDocumentation ABBYY Vantage 문서 전체에서 시맨틱 검색을 수행해 가장 관련성이 높은 콘텐츠를 반환합니다. Vantage와 관련된 질문을 하면 Copilot이 Agent 모드에서 이 도구를 자동으로 호출합니다. 예시 쿼리:
  • “Vantage에서 Document Skill을 어떻게 구성하나요?”
  • “minConfidence 매개변수는 어떤 역할을 하나요?”
  • “Vantage에서 LLM 연결을 어떻게 설정하나요?”
  • “Vantage는 어떤 내보내기 형식을 지원하나요?”
  • “Vantage REST API에서는 어떻게 인증하나요?”

​
활용 사례

API 연동

IDE를 벗어나지 않고 엔드포인트 매개변수, 인증 방식, 요청/응답 형식을 확인할 수 있습니다

스킬 구성

Document Skills, 프로세스 스킬, Advanced Designer의 구성 옵션과 모범 사례를 빠르게 찾을 수 있습니다

문제 해결

통합을 디버깅하는 동안 오류 메시지와 알려진 문제를 검색해 더 빠르게 문제를 해결할 수 있습니다

기능 살펴보기

프로젝트를 계획하면서 Vantage가 지원하는 추출 모델, 지원 형식, 테넌트 설정을 확인할 수 있습니다

​
효과적인 쿼리를 위한 팁

  • 구체적으로 질문하세요: 막연하게 묻기보다는 질문에 기능 이름이나 API 엔드포인트를 포함하세요
  • Vantage 용어를 사용하세요: “프로세스 스킬”, “Document skill”, “Skill Designer”, “tenant” 같은 용어를 사용하면 더 정확한 결과를 얻을 수 있습니다
  • 후속 질문을 하세요: Copilot은 문맥을 유지하므로 후속 프롬프트로 결과 범위를 더 좁힐 수 있습니다
  • 코드와 함께 활용하세요: API 응답이나 구성 스니펫을 붙여 넣고, Vantage 문서를 기반으로 Copilot에 설명해 달라고 요청하세요
  • Agent 모드를 사용하세요: MCP 도구는 Agent 모드에서만 사용할 수 있으므로, 질문하기 전에 모드 선택기가 “Agent”로 설정되어 있는지 확인하세요

​
MCP 서버 제거

다음 두 가지 방법 중 하나로 서버를 제거할 수 있습니다. 명령 팔레트에서:
  1. 명령 팔레트(Cmd+Shift+P / Ctrl+Shift+P)를 엽니다
  2. **“MCP: List Servers”**를 실행합니다
  3. abbyy-vantage를 선택합니다
  4. Remove를 선택합니다
구성 파일에서: .vscode/mcp.json(워크스페이스) 또는 사용자 MCP 구성에서 abbyy-vantage 항목을 삭제합니다.

​
문제 해결

“MCP: List Servers”에 서버가 표시되지 않음 구성 파일이 올바르게 저장되었고 JSON이 유효한지(끝에 쉼표가 없는지) 확인하세요. 파일을 수동으로 편집했다면 VS Code를 다시 로드해 보세요(Command Palette에서 Developer: Reload Window 선택). VS Code 버전이 너무 오래됨 MCP를 지원하려면 VS Code 1.99 이상이 필요합니다. Help → About에서 버전을 확인하고, 필요하면 업데이트하세요. 도구가 자동으로 호출되지 않음 Copilot은 Agent 모드에서만 MCP 도구를 호출합니다. Copilot Chat 패널 상단의 모드 선택기를 사용해 “Ask” 또는 “Edit” 모드에서 “Agent”로 전환했는지 확인하세요. 그래도 도구가 사용되지 않으면 질문을 더 구체적으로 작성해 보세요. 예: “Search the ABBYY Vantage docs for…” 또는 특정 Vantage 기능 이름을 직접 언급하세요. 검색 결과의 관련성이 낮음 Vantage 인터페이스나 문서에서 사용하는 용어로 질의를 다시 작성해 보세요. “workflow”나 “settings”처럼 일반적인 용어는 단독으로 쓰지 말고, “Vantage” 또는 특정 기능 이름과 함께 사용하세요.

​
요약

다음을 성공적으로 완료했습니다:
  • ✅ VS Code의 GitHub Copilot에 ABBYY Vantage MCP 서버를 추가했습니다
  • ✅ “MCP: List Servers”를 사용해 연결을 확인했습니다
  • ✅ Agent 모드의 Copilot Chat에서 문서 검색을 시작하는 방법을 익혔습니다

​
다음 단계

API 소개

Vantage Processing REST API를 시작해 보세요

문서 처리

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

LLM 연결 구성

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

프롬프트 기반 추출

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

Claude Code용 MCP 서버

동일한 MCP 서버를 Claude Code에 추가하세요