跳转到主要内容

​
概述

你将完成以下操作：
  • 将 ABBYY Vantage MCP 服务器添加到 VS Code 中的 GitHub Copilot
  • 验证连接是否正常
  • 使用 SearchAbbyyVantageDocumentation 工具直接在 Copilot Chat 中搜索文档
**完成时间：**约 5 分钟

​
什么是 MCP 服务器？

Model Context Protocol (MCP) 是一项开放标准，可让 AI 助手连接到外部工具和数据源。通过向 GitHub Copilot 添加 MCP 服务器，您可以让 AI 直接访问结构化数据或功能，而无需手动复制粘贴内容。 ABBYY Vantage MCP 服务器提供一个工具 SearchAbbyyVantageDocumentation，用于对整个 Vantage 文档执行语义搜索。连接此服务器后，Copilot 就能在您工作时自动查找 API 参数、技能配置选项、故障排查步骤等内容。
MCP 服务器对公开文档提供只读访问。它不会连接到您的 Vantage 租户、处理文档，也不需要任何 Vantage 凭据。

​
前提条件

使用 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 mode
  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 中配置文档技能？”
  • “minConfidence 参数有什么作用？”
  • “如何在 Vantage 中设置 LLM 连接？”
  • “Vantage 支持哪些导出格式？”
  • “如何通过 Vantage REST API 进行身份验证？”

​
使用场景

API 集成

无需离开 IDE，即可查找端点参数、身份验证方式以及请求/响应格式

技能配置

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

故障排除

搜索错误消息和已知问题，以便在调试集成时更快定位并解决问题

探索能力

在规划项目时，了解 Vantage 支持哪些能力——如提取模型、支持的格式和租户设置

​
高效查询的技巧

  • 明确具体： 在问题中包含功能名称或 API 端点，而非泛泛而问
  • 使用 Vantage 术语： 使用”流程技能”、“文档技能”、“Skill Designer”和”tenant”等术语可获得更精准的结果
  • 追问后续问题： Copilot 会保留上下文，因此您可以通过追问进一步缩小结果范围
  • 结合代码使用： 粘贴 API 响应或配置片段，并要求 Copilot 结合 Vantage 文档进行解释
  • 使用 Agent mode： MCP 工具仅在 Agent mode 下可用——请在提问前确保模式选择器已切换为”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 Server

将同一 MCP Server 添加至 Claude Code