Saltar al contenido principal

​
Descripción general

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

​
¿Qué es el servidor MCP?

Model Context Protocol (MCP) es un estándar abierto que permite que los asistentes de IA se conecten a herramientas y fuentes de datos externas. Al agregar un servidor MCP a GitHub Copilot, le das a la IA acceso directo a datos estructurados o funciones, sin necesidad de 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 conectado este servidor, puede buscar parámetros de la API, opciones de configuración de skill, pasos de solución de problemas y mucho más automáticamente 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 necesita 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 ámbito: Workspace o User
2

Alternativa: configuración manual

Si prefieres hacerlo manualmente, agrega la entrada del servidor en el archivo de configuración correspondiente.
Crea o edita .vscode/mcp.json en la raíz de tu proyecto:
Abre la Paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P), escribe “MCP: Open User Configuration” y agrega la siguiente entrada:
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 pulsa Ctrl+Shift+I / Cmd+Shift+I)
  3. Cambia a Agent mode usando el selector de modo en la parte superior del panel de chat
  4. Haz clic en el icono de herramientas del cuadro de entrada del chat; confirma que SearchAbbyyVantageDocumentation aparezca en la lista
  5. Pruébalo 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 final. Confirma también que VS Code tenga acceso a la red para conectarse al servidor.

​
Herramientas disponibles

El servidor MCP de ABBYY Vantage ofrece 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 Agent mode 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 de API: Consulta parámetros de endpoint, métodos de autenticación y formatos de solicitud/respuesta sin salir de tu IDE
  • Configuración de Skills: Encuentra rápidamente opciones de configuración y prácticas recomendadas para Skills de documento, Habilidades de proceso y Advanced Designer
  • Resolución de problemas: Busca mensajes de error y problemas conocidos para resolver incidencias más rápido al depurar integraciones
  • Exploración de capacidades: Descubre qué admite Vantage — modelos de extracción, formatos compatibles 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 el endpoint de la API en su pregunta, en lugar de hacer una consulta 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 la API o un fragmento de configuración y pídale a Copilot que lo explique usando la documentación de Vantage
  • Use Agent mode: Las herramientas de MCP solo están disponibles en Agent mode; asegúrese de que el selector de modo esté configurado como “Agent” antes de preguntar

​
Eliminar el servidor MCP

Puede eliminar el servidor con cualquiera de estos métodos: Desde 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 (workspace) o de su configuración de usuario de MCP.

​
Solución de problemas

Server 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 finales). Si editaste el archivo manualmente, intenta recargar VS Code (Developer: Reload Window desde la Paleta de comandos). La versión de VS Code es demasiado antigua La compatibilidad con MCP requiere VS Code 1.99 o posterior. Comprueba tu versión en Ayuda → Acerca de y actualiza si es necesario. La herramienta no se invoca automáticamente Copilot solo invoca herramientas MCP en Agent mode. Asegúrate de haber cambiado del modo “Ask” o “Edit” al modo “Agent” con el selector de modo situado en la parte superior del panel de chat de Copilot. Si la herramienta sigue sin usarse, intenta formular tu pregunta de forma más explícita: “Busca en la documentación de ABBYY Vantage…” o menciona por nombre una función concreta 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ñadiste el servidor MCP de ABBYY Vantage a GitHub Copilot en VS Code
  • ✅ Verificaste la conexión con “MCP: List Servers”
  • ✅ Aprendiste a iniciar una búsqueda en la documentación desde Copilot Chat en Agent mode

​
Próximos pasos

Introducción a la API

Comience a usar la REST API de Vantage Processing

Procesamiento de documentos

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

Configuración de conexiones 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