跳轉到主要內容

​
概述

您將完成的內容：
  • 將 ABBYY Vantage MCP server 新增到 Claude Code
  • 驗證連線是否正常運作
  • 使用 SearchAbbyyVantageDocumentation 工具在您的 AI 工作流程中搜尋說明文件
完成時間： 約 5 分鐘

​
什麼是 MCP 伺服器？

Model Context Protocol (MCP) 是一種開放標準，可讓 AI 助理連接到外部工具與資料來源。透過將 MCP 伺服器新增至 Claude Code，你可以讓 AI 直接存取結構化資料或各種功能——而不必手動複製與貼上內容。 ABBYY Vantage MCP 伺服器提供一個工具 SearchAbbyyVantageDocumentation，可在整套 Vantage 說明文件中執行語意搜尋。當 Claude Code 已連接此伺服器時，它可以自動查詢 API 參數、Skill 設定選項、疑難排解步驟等內容——並在你工作時於背景自動完成這些查詢。
MCP 伺服器僅提供對公開說明文件的唯讀存取。它不會連線到你的 Vantage 租戶、處理文件，也不需要任何 Vantage 認證。

​
先決條件

  • 已安裝並執行 Claude Code
  • 終端機存取權限 (macOS、Linux，或搭配 WSL 的 Windows)
不需要 ABBYY Vantage 租用戶或帳戶即可使用 MCP 伺服器。
1

透過 CLI 新增（建議）

在終端機中執行以下命令，將 MCP 伺服器註冊到 Claude Code：
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http
範圍選項：預設情況下，這會在專案層級新增伺服器，表示它僅在目前目錄中可用 (儲存在 .claude/settings.json 中) 。若要讓它可供你所有專案使用，請加入 --scope user 旗標：
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http --scope user
範圍設定檔使用時機
專案 (預設).claude/settings.json單一特定專案
使用者~/.claude/settings.json此機器上的所有專案
2

替代方式：手動設定

如果你偏好手動設定，請將以下 JSON 新增到你的設定檔中。
在專案根目錄中建立或編輯 .claude/settings.json：
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
編輯家目錄中的 ~/.claude/settings.json：
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

驗證連線

重新啟動 Claude Code，然後執行以下斜線命令，以確認伺服器已註冊：
/mcp
你應該會看到 abbyy-vantage 已列出且狀態為已連線。若要確認工具運作正常，請向 Claude 詢問一個與 Vantage 相關的問題：
“What parameters does the Vantage Processing API require to submit a document?”
Claude Code 會呼叫 SearchAbbyyVantageDocumentation，並回傳來自說明文件的結果。
如果伺服器沒有顯示在 /mcp 中，請檢查 URL 是否完全輸入為 https://docs.abbyy.com/mcp，且結尾沒有斜線。也請確認你的終端機具有可連線到該伺服器的網路存取能力。

​
可用工具

ABBYY Vantage MCP 伺服器只提供一個工具： SearchAbbyyVantageDocumentation 在 ABBYY Vantage 文件中執行語意搜尋，並傳回最相關的內容。當你提出與 Vantage 相關的問題時，Claude Code 會自動呼叫此工具。 查詢範例：
  • “如何在 Vantage 中設定一個文件 Skill？”
  • “minConfidence Parameter 的作用是什麼？”
  • “如何在 Vantage 中設定 LLM 連線？”
  • “Vantage 支援哪些匯出格式？”
  • “如何使用 Vantage REST API 進行身分驗證？“

​
使用情境

API 整合

在不離開 IDE 的情況下，查詢端點參數、驗證方式以及請求／回應格式

Skill 設定

迅速查找文件 Skill、流程技能與 Advanced Designer 的設定選項與最佳實務

疑難排解

搜尋錯誤訊息與已知問題，以在除錯整合時更快速排除問題

探索功能

在規劃專案時，瞭解 Vantage 支援的功能——擷取模型、支援的格式、租戶設定等

​
撰寫有效查詢的建議

  • 具體說明： 在問題中包含功能名稱或 API 端點，而非只提出籠統的問題
  • 使用 Vantage 術語： 像 “Process Skill”、“Document Skill”、“Skill Designer” 和 “tenant” 這類用語能帶來更精準的結果
  • 提出後續問題： Claude Code 會保留上下文，因此你可以透過後續提問來縮小結果範圍
  • 與你的程式碼搭配使用： 貼上 API 回應或設定片段，並請 Claude 參考 Vantage 文件為你說明

​
移除 MCP 伺服器

若要從 Claude Code 移除 ABBYY Vantage MCP 伺服器，請執行： 
claude mcp remove abbyy-vantage
如果您是在使用者層級新增伺服器，請加上 --scope user 旗標： 
claude mcp remove abbyy-vantage --scope user

​
疑難排解

伺服器未出現在 /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

提示式擷取

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