> ## 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 ABBYY Vantage a GitHub Copilot

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

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

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

***

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

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.

<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 necesita 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 ámbito: **Workspace** o **User**

    | Ámbito    | 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 hacerlo manualmente, agrega la entrada del servidor en el 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 de 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 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.

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

***

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

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

***

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

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

***

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

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

***

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

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.

***

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

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

***

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

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

***

<div id="next-steps">
  ## Próximos pasos
</div>

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

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

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

  <Card title="Extracción basada en prompts" icon="wand-magic-sparkles" href="/es/vantage/documentation/skills/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/developer/mcp-server">
    Añada el mismo servidor MCP a Claude Code
  </Card>
</CardGroup>