> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agregar el servidor MCP de Vantage a GitHub Copilot

> Conecta el servidor MCP de ABBYY Vantage a GitHub Copilot en VS Code para buscar documentación al instante mientras desarrollas integraciones con Vantage.

<div id="overview">
  ## Descripción general
</div>

**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

***

<div id="what-is-the-mcp-server">
  ## ¿Qué es el servidor MCP?
</div>

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.

<Note>
  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.
</Note>

***

<div id="prerequisites">
  ## Requisitos previos
</div>

* [VS Code](https://code.visualstudio.com/) versión **1.99 o posterior** (se requiere compatibilidad con MCP)
* Extensión [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) instalada y con sesión iniciada

<Note>
  No se requiere ningún tenant ni cuenta de ABBYY Vantage para usar el servidor MCP.
</Note>

***

<Steps>
  <Step title="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**

    | Alcance   | Ubicación de la configuración                           | Cuándo usarlo                      |
    | --------- | ------------------------------------------------------- | ---------------------------------- |
    | Workspace | `.vscode/mcp.json`                                      | Un proyecto específico             |
    | User      | Configuración de usuario mediante la Paleta de comandos | Todos los proyectos de este equipo |
  </Step>

  <Step title="Alternativa: configuración manual">
    Si prefieres configurar manualmente, agrega la entrada del servidor al archivo de configuración correspondiente.

    <AccordionGroup>
      <Accordion title="Workspace (.vscode/mcp.json)">
        Crea o edita `.vscode/mcp.json` en la raíz de tu proyecto:

        ```json theme={null}
        {
          "servers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>

      <Accordion title="Configuración a nivel de usuario">
        Abre la Paleta de comandos (**Cmd+Shift+P** / **Ctrl+Shift+P**), escribe **"MCP: Open User Configuration"** y agrega la siguiente entrada:

        ```json theme={null}
        {
          "servers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="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.

    <Warning>
      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.
    </Warning>
  </Step>
</Steps>

***

<div id="available-tools">
  ## Herramientas disponibles
</div>

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?"

***

<div id="use-cases">
  ## Casos de uso
</div>

* **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

***

<div id="tips-for-effective-queries">
  ## Consejos para hacer consultas eficaces
</div>

* **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

***

<div id="removing-the-mcp-server">
  ## Eliminar el servidor MCP
</div>

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.

***

<div id="troubleshooting">
  ## Solución de problemas
</div>

**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.

***

<div id="summary">
  ## Resumen
</div>

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

***

<div id="next-steps">
  ## Siguientes pasos
</div>

<CardGroup cols={2}>
  <Card title="Introducción a la API" icon="plug" href="/es/vantage/developer/api-introduction">
    Empiece a usar la API REST de procesamiento de Vantage
  </Card>

  <Card title="Procesamiento de documentos" icon="file-lines" href="/es/vantage/how-to/process-skill">
    Cree una Habilidad de proceso y automatice el procesamiento de documentos mediante SFTP
  </Card>

  <Card title="Configuración de conexiones con LLM" icon="brain" href="/es/vantage/how-to/connections">
    Conecte Vantage a OpenAI o Microsoft Foundry
  </Card>

  <Card title="Extracción basada en prompts" icon="wand-magic-sparkles" href="/es/vantage/how-to/prompt-extraction">
    Use prompts en lenguaje natural para extraer datos de documentos
  </Card>

  <Card title="Servidor MCP para Claude Code" icon="terminal" href="/es/vantage/how-to/mcp-server">
    Añada el mismo servidor MCP a Claude Code
  </Card>
</CardGroup>