跳转到主要内容

​
概览

你将完成以下任务：
  • 将 ABBYY Vantage MCP 服务器添加到 Claude Code
  • 确认连接正常
  • 使用 SearchAbbyyVantageDocumentation 工具在你的 AI 工作流中搜索文档
完成时间： 约 5 分钟

​
什么是 MCP 服务器？

Model Context Protocol（MCP，模型上下文协议）是一种开放标准，允许 AI 助手连接到外部工具和数据源。通过将 MCP 服务器添加到 Claude Code，你可以为 AI 提供对结构化数据或功能的直接访问——无需手动复制粘贴内容。 ABBYY Vantage MCP 服务器公开了一个工具 SearchAbbyyVantageDocumentation，用于在完整的 Vantage 文档中执行语义搜索。当 Claude Code 连接到此服务器后，它可以在你工作过程中自动查询 API 参数、技能配置选项、故障排除步骤等内容。
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
作用域配置文件使用场景
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 显示为已连接状态。要确认工具是否正常工作，可以向 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 中配置文档技能？”
  • “minConfidence Parameter 有什么作用？”
  • “如何在 Vantage 中设置 LLM 连接？”
  • “Vantage 支持哪些导出格式？”
  • “如何使用 Vantage REST API 进行身份验证？”

​
使用场景

API 集成

在不离开 IDE 的情况下查询端点参数、身份验证方法以及请求/响应格式

技能配置

快速查找文档技能、流程技能以及 Advanced Designer 的配置选项和最佳实践

故障排查

搜索错误信息和已知问题，在调试集成时更快速地解决问题

功能探索

在规划项目时了解 Vantage 支持的功能——提取模型、支持的格式、租户设置等

​
高效查询提示

  • 要具体： 在你的问题中包含功能名称或 API 端点，而不是泛泛而问。
  • 使用 Vantage 术语： 使用诸如 “Process Skill”、“Document Skill”、“Skill Designer” 和 “tenant” 等术语可以获得更精确的结果。
  • 提出后续问题： Claude Code 会保留上下文，因此你可以通过后续提示来逐步缩小结果范围。
  • 结合你的代码： 粘贴一个 API 响应或配置代码片段，并让 Claude 基于 Vantage 文档为你进行解释。

​
故障排查

服务器未出现在 /mcp 中 请确认配置文件已正确保存且 JSON 格式有效（没有多余的尾随逗号）。完成更改后，请完全重启 Claude Code。 工具未被自动调用 Claude Code 会根据相关性调用 MCP 工具。如果工具没有被使用，尝试更明确地描述您的问题，例如：“在 ABBYY Vantage 文档中搜索……”或直接提到某个具体的 Vantage 功能名称。 搜索返回了不相关的结果 尝试使用 Vantage 界面或文档中的术语重新表述您的查询。避免单独使用诸如“workflow”或“settings”这样的通用术语——请将它们与“Vantage”或某个具体功能名称组合使用。

​
总结

您已经成功完成以下任务：
  • ✅ 将 ABBYY Vantage MCP 服务器添加到 Claude Code
  • ✅ 使用 /mcp 命令验证连接
  • ✅ 学会了如何在 AI 工作流程中触发文档搜索

​
后续步骤

API 介绍

开始使用 Vantage Processing REST API

处理文档

创建流程技能，并通过 SFTP 实现文档处理自动化

配置 LLM 连接

将 Vantage 连接到 OpenAI 或 Microsoft Foundry

基于提示的提取

使用自然语言提示从文档中提取数据