跳轉到主要內容

​
概覽

您將完成以下內容：
  • 將 ABBYY Vantage MCP 伺服器新增至 VS Code 中的 GitHub Copilot
  • 確認連線正常運作
  • 使用 SearchAbbyyVantageDocumentation 工具，直接在 Copilot Chat 中搜尋文件
完成時間： 約 5 分鐘

​
什麼是 MCP 伺服器？

Model Context Protocol (MCP) 是一項開放標準，可讓 AI 助理連接到外部工具和資料來源。將 MCP 伺服器新增至 GitHub Copilot 後，您就能讓 AI 直接存取結構化資料或功能，而無須手動複製貼上內容。 ABBYY Vantage MCP 伺服器提供單一工具 SearchAbbyyVantageDocumentation，可對完整的 Vantage 文件執行語意搜尋。當 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 中設定文件 Skill？”
  • “minConfidence 參數有什麼作用？”
  • “如何在 Vantage 中設定 LLM 連線？”
  • “Vantage 支援哪些匯出格式？”
  • “如何使用 Vantage REST API 進行身分驗證？“

​
使用情境

API 整合

不必離開 IDE，就能查詢端點參數、驗證方式，以及請求/回應格式

技能設定

快速找到文件 Skill、流程技能和 Advanced Designer 的設定選項與最佳做法

疑難排解

搜尋錯誤訊息和已知問題，讓您在偵錯整合時更快解決問題

探索功能

在規劃專案時，了解 Vantage 支援哪些功能——例如擷取模型、支援格式和租戶設定

​
有效查詢的建議

  • **請明確具體：**在問題中加入功能名稱或 API 端點，不要只做籠統提問
  • **使用 Vantage 術語：**像是「流程技能」、「文件 Skill」、「Skill Designer」和「租戶」這類術語，能得到更精確的結果
  • **提出後續問題：**Copilot 會保留上下文，因此您可以透過追問來進一步縮小結果範圍
  • **搭配您的程式碼：**貼上 API 回應或設定片段，並請 Copilot 根據 Vantage 文件加以說明
  • **使用 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 (在命令面板中選取 Developer: Reload Window) 。 VS Code 版本過舊 MCP 支援需要 VS Code 1.99 或更新版本。請透過 Help → About 檢查目前版本，並視需要更新。 工具未自動叫用 Copilot 只有在 Agent 模式下才會叫用 MCP 工具。請確認您已透過 Copilot Chat 面板頂端的模式選擇器，從「Ask」或「Edit」模式切換為「Agent」。如果工具仍未被使用，請嘗試用更明確的方式提問，例如：「搜尋 ABBYY Vantage 文件中關於……的內容」，或直接提及特定的 Vantage 功能名稱。 搜尋結果不相關 請改用 Vantage 介面或文件中的術語來重新表述查詢。避免單獨使用像是「workflow」或「settings」這類泛泛的詞彙——請將它們與「Vantage」或特定功能名稱搭配使用。

​
總結

您已成功完成：
  • ✅ 將 ABBYY Vantage MCP 伺服器新增至 VS Code 中的 GitHub Copilot
  • ✅ 使用 “MCP: List Servers” 驗證連線
  • ✅ 了解如何在 Agent 模式下，從 Copilot Chat 觸發說明文件搜尋

​
後續步驟

API 簡介

開始使用 Vantage Processing REST API

處理文件

建立流程技能，透過 SFTP 自動處理文件

設定 LLM 連線

將 Vantage 連接至 OpenAI 或 Microsoft Foundry

提示式擷取

使用自然語言提示從文件中擷取資料

Claude Code 的 MCP 伺服器

將相同的 MCP 伺服器新增至 Claude Code