Saltar al contenido principal

​
Descripción general

Qué lograrás:
  • Agregar el servidor MCP de ABBYY Vantage a GitHub Copilot en VS Code
  • Verificar que la conexión funcione correctamente
  • Usar la herramienta SearchAbbyyVantageDocumentation para buscar en la documentación desde Copilot Chat
Tiempo estimado: ~5 minutos

​
¿Qué es el servidor MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas externas y fuentes de datos. Al agregar un servidor MCP a GitHub Copilot, le das a la IA acceso directo a datos estructurados o capacidades, sin tener que copiar y pegar contenido manualmente. El servidor MCP de ABBYY Vantage expone una única herramienta, SearchAbbyyVantageDocumentation, que realiza una búsqueda semántica en toda la documentación de Vantage. Cuando Copilot tiene este servidor conectado, puede buscar automáticamente parámetros de API, opciones de configuración de skill, pasos para la solución de problemas y mucho más mientras trabajas.
El servidor MCP proporciona acceso de solo lectura a la documentación pública. No se conecta a tu tenant de Vantage, no procesa documentos ni requiere credenciales de Vantage.

​
Requisitos previos

  • VS Code versión 1.99 o posterior (se requiere compatibilidad con MCP)
  • Extensión GitHub Copilot instalada y con sesión iniciada
No se requiere ningún tenant ni cuenta de ABBYY Vantage para usar el servidor MCP.
1

Agregar mediante la Paleta de comandos (recomendado)

Usa la Paleta de comandos de VS Code para registrar el servidor MCP:
  1. Abre la Paleta de comandos con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
  2. Escribe “MCP: Add Server…” y selecciónalo
  3. Selecciona HTTP como tipo de transporte
  4. Introduce la URL: https://docs.abbyy.com/mcp
  5. Introduce el nombre: abbyy-vantage
  6. Elige el alcance: Workspace o User
AlcanceUbicación de la configuraciónCuándo usarlo
Workspace.vscode/mcp.jsonUn proyecto específico
UserConfiguración de usuario mediante la Paleta de comandosTodos los proyectos de este equipo
2

Alternativa: configuración manual

Si prefieres configurar manualmente, agrega la entrada del servidor al archivo de configuración correspondiente.
Crea o edita .vscode/mcp.json en la raíz de tu proyecto:
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
Abre la Paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P), escribe “MCP: Open User Configuration” y agrega la siguiente entrada:
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

Verificar la conexión

  1. Abre la Paleta de comandos y ejecuta “MCP: List Servers” — confirma que abbyy-vantage aparezca como conectado
  2. Abre Copilot Chat (haz clic en el icono de Copilot en la barra lateral o presiona Ctrl+Shift+I / Cmd+Shift+I)
  3. Cambia al modo Agent usando el selector de modo en la parte superior del panel de chat
  4. Haz clic en el icono de herramientas en el campo de entrada del chat — confirma que SearchAbbyyVantageDocumentation aparezca en la lista
  5. Prueba con una pregunta:
“¿Qué parámetros requiere la API de procesamiento de Vantage para enviar un documento?”
Copilot invocará SearchAbbyyVantageDocumentation y devolverá resultados de la documentación.
La URL debe introducirse exactamente como https://docs.abbyy.com/mcp, sin barra diagonal final. Confirma también que VS Code tenga acceso a la red para acceder al servidor.

​
Herramientas disponibles

El servidor MCP de ABBYY Vantage expone una herramienta: SearchAbbyyVantageDocumentation Realiza una búsqueda semántica en la documentación de ABBYY Vantage y devuelve el contenido más relevante. Copilot invoca esta herramienta automáticamente en modo Agent cuando haces preguntas relacionadas con Vantage. Consultas de ejemplo:
  • “¿Cómo configuro una Skill de documento en Vantage?”
  • “¿Qué hace el parámetro minConfidence?”
  • “¿Cómo configuro una conexión LLM en Vantage?”
  • “¿Qué formatos de exportación admite Vantage?”
  • “¿Cómo me autentico con la API REST de Vantage?”

​
Casos de uso

Integraciones con la API

Consulta parámetros de endpoints, métodos de autenticación y formatos de solicitud y respuesta sin salir de tu IDE

Configuración de Habilidades

Encuentra rápidamente opciones de configuración y prácticas recomendadas para Skills de documento, Habilidades de proceso y Advanced Designer

Solución de problemas

Busca mensajes de error e incidencias conocidas para resolver problemas más rápido mientras depuras integraciones

Exploración de capacidades

Descubre qué admite Vantage — modelos de extracción, formatos admitidos y configuración del tenant — mientras planificas tu proyecto

​
Consejos para hacer consultas eficaces

  • Sea específico: Incluya el nombre de la función o del endpoint de API en su pregunta, en lugar de formular una pregunta general
  • Use la terminología de Vantage: Términos como “Habilidad de proceso”, “Skill de documento”, “Skill Designer” y “tenant” devolverán resultados más precisos
  • Haga preguntas de seguimiento: Copilot conserva el contexto, por lo que puede acotar los resultados con preguntas de seguimiento
  • Combínelo con su código: Pegue una respuesta de API o un fragmento de configuración y pídale a Copilot que lo explique utilizando la documentación de Vantage
  • Use el modo Agent: Las herramientas de MCP solo están disponibles en el modo Agent; asegúrese de que el selector de modo esté configurado en “Agent” antes de preguntar

​
Eliminar el servidor MCP

Puede eliminar el servidor con cualquiera de estos dos métodos: Mediante la paleta de comandos:
  1. Abra la paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P)
  2. Ejecute “MCP: List Servers”
  3. Seleccione abbyy-vantage
  4. Elija Remove
Mediante el archivo de configuración: Elimine la entrada abbyy-vantage de .vscode/mcp.json (área de trabajo) o de la configuración de MCP de su usuario.

​
Solución de problemas

El servidor no aparece en “MCP: List Servers” Verifica que el archivo de configuración se haya guardado correctamente y que el JSON sea válido (sin comas al final). Si editaste el archivo manualmente, intenta recargar VS Code (Developer: Reload Window desde la Command Palette). La versión de VS Code es demasiado antigua La compatibilidad con MCP requiere VS Code 1.99 o una versión posterior. Comprueba tu versión en Help → About y actualiza si es necesario. La herramienta no se invoca automáticamente Copilot solo invoca herramientas MCP en modo Agent. Asegúrate de haber cambiado del modo “Ask” o “Edit” a “Agent” con el selector de modo situado en la parte superior del panel Copilot Chat. Si la herramienta sigue sin utilizarse, intenta formular tu pregunta de forma más explícita: “Search the ABBYY Vantage docs for…” o menciona por nombre una función específica de Vantage. La búsqueda devuelve resultados irrelevantes Reformula tu consulta usando términos de la interfaz o de la documentación de Vantage. Evita usar términos genéricos como “workflow” o “settings” por sí solos; combínalos con “Vantage” o con el nombre de una función específica.

​
Resumen

Has completado correctamente lo siguiente:
  • ✅ Añadido el servidor MCP de ABBYY Vantage a GitHub Copilot en VS Code
  • ✅ Verificado la conexión con “MCP: List Servers”
  • ✅ Aprendido a activar la búsqueda en la documentación desde Copilot Chat en modo Agent

​
Siguientes pasos

Introducción a la API

Empiece a usar la API REST de procesamiento de Vantage

Procesamiento de documentos

Cree una Habilidad de proceso y automatice el procesamiento de documentos mediante SFTP

Configuración de conexiones con LLM

Conecte Vantage a OpenAI o Microsoft Foundry

Extracción basada en prompts

Use prompts en lenguaje natural para extraer datos de documentos

Servidor MCP para Claude Code

Añada el mismo servidor MCP a Claude Code