跳轉到主要內容

​
概述

您將完成的內容：
  • 將 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）
使用 MCP 伺服器不需要 ABBYY Vantage 租戶或帳戶。
1

透過 CLI 新增（建議使用）

在終端機中執行以下指令，將 MCP 伺服器註冊到 Claude Code：
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse
範圍選項：預設情況下，這會在專案層級新增伺服器，也就是它只在目前目錄中可用（儲存在 .claude/settings.json）。若要讓它可用於所有專案，請加入 --scope user 旗標：
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse --scope user
範圍設定檔使用時機
專案（預設）.claude/settings.json單一特定專案
使用者~/.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 顯示為已連線狀態。若要確認工具運作正常，請向 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 中 請確認設定檔已正確儲存且 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

提示式擷取

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