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

# Usar la documentación con tu asistente de IA

> Conecta Claude Code, VS Code Copilot, Cursor, Codex o la aplicación Claude al MCP server de la documentación de ABBYY para que tu asistente pueda buscar y leer la documentación de Vantage, FineParser, FineReader Engine y FlexiCapture mientras trabajas.

El MCP server de la documentación de ABBYY permite que un asistente de IA busque y lea este sitio mientras trabajas: todos los productos documentados aquí (ABBYY Vantage, Vantage Self-Hosted, FineParser, FineReader Engine y FlexiCapture), además de las especificaciones OpenAPI de Vantage. Conéctalo una vez y tu asistente responderá a partir de la documentación actual y no de sus datos de entrenamiento.

El servidor es de solo lectura y público. No se conecta a ningún tenant de Vantage, no procesa documentos ni requiere credenciales de ABBYY, y no se ejecuta nada en tu equipo.

<Note>
  Esta página trata sobre la búsqueda en la documentación. No se refiere al MCP server de Vantage, que conecta un asistente a tu tenant de Vantage para ejecutar skills y procesar documentos.
</Note>

**Tiempo estimado:** \~5 minutos

<h2 id="connect-your-assistant">
  Conecte su asistente
</h2>

La dirección del servidor es la misma en todos los casos: `https://docs.abbyy.com/mcp`, transporte HTTP, sin autenticación. Elija su cliente.

<Tabs>
  <Tab title="Claude Code">
    Ejecute este comando en su terminal:

    ```bash theme={null}
    claude mcp add abbyy-docs https://docs.abbyy.com/mcp --transport http
    ```

    De forma predeterminada, el servidor se agrega en el ámbito **local**: solo estará disponible para usted en el proyecto actual. Use `--scope` para cambiarlo.

    | Ámbito                   | Dónde se almacena                                                                            | Cuándo usarlo                                                                    |
    | ------------------------ | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
    | `local` (predeterminado) | Su configuración de usuario de Claude Code, asociada al proyecto actual                      | Para probarlo en un solo proyecto                                                |
    | `project`                | `.mcp.json` en la raíz del proyecto, incluido en el control de versiones junto con el código | Para compartir el servidor con todas las personas que trabajan en el repositorio |
    | `user`                   | Su configuración de usuario de Claude Code, para todos los proyectos                         | Para tenerlo disponible en todo este equipo                                      |

    Para compartir el servidor mediante el control de versiones, cree o edite `.mcp.json` en la raíz del proyecto en lugar de ejecutar el comando:

    ```json theme={null}
    {
      "mcpServers": {
        "abbyy-docs": {
          "type": "http",
          "url": "https://docs.abbyy.com/mcp"
        }
      }
    }
    ```

    Claude Code lee este archivo al iniciarse y le solicita que apruebe el servidor la primera vez que se usa en ese proyecto.

    Reinicie Claude Code y ejecute `/mcp`. Debería ver `abbyy-docs` con el estado conectado.
  </Tab>

  <Tab title="VS Code (Copilot)">
    Requiere VS Code **1.99 o posterior** con la extensión de GitHub Copilot y la sesión iniciada.

    1. Abra la Command Palette con **Cmd+Shift+P** (macOS) o **Ctrl+Shift+P** (Windows/Linux)
    2. Ejecute **MCP: Add Server...**
    3. Seleccione **HTTP** como tipo de transporte
    4. Introduzca la URL `https://docs.abbyy.com/mcp`
    5. Introduzca el nombre `abbyy-docs`
    6. Elija **Workspace** (`.vscode/mcp.json`, compartido con el repositorio) o **User** (todos los proyectos de este equipo)

    Para configurarlo manualmente, cree o edite `.vscode/mcp.json`, o ejecute **MCP: Open User Configuration** para acceder al archivo de nivel de usuario:

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

    Ejecute **MCP: List Servers** y compruebe que `abbyy-docs` aparece como conectado. En Copilot Chat, cambie a **Agent mode**; las herramientas MCP solo están disponibles ahí.
  </Tab>

  <Tab title="Cursor">
    1. Abra **Cursor Settings** y seleccione **MCP**
    2. Haga clic en **Add new MCP server**
    3. Introduzca el nombre `abbyy-docs` y la URL `https://docs.abbyy.com/mcp`

    También puede agregar la entrada a `.cursor/mcp.json` en el proyecto (compartido con el repositorio) o a `~/.cursor/mcp.json` (todos los proyectos):

    ```json theme={null}
    {
      "mcpServers": {
        "abbyy-docs": {
          "url": "https://docs.abbyy.com/mcp"
        }
      }
    }
    ```

    El servidor aparece en la lista de configuración de MCP con un estado en verde una vez que Cursor se ha conectado.
  </Tab>

  <Tab title="Codex">
    Ejecute este comando en su terminal:

    ```bash theme={null}
    codex mcp add abbyy-docs --url https://docs.abbyy.com/mcp
    ```

    Reinicie Codex. El servidor estará disponible en todos los proyectos de este equipo.
  </Tab>

  <Tab title="Aplicación Claude">
    1. Abra **Settings** y seleccione **Connectors**
    2. Haga clic en **Add custom connector**
    3. Introduzca el nombre `ABBYY docs` y la URL `https://docs.abbyy.com/mcp`
    4. Haga clic en **Add**

    No es necesario iniciar sesión, ya que el servidor no requiere autenticación. En un chat, abra el menú de archivos adjuntos (el icono de más) y active el conector.
  </Tab>
</Tabs>

<h2 id="verify-the-connection">
  Verificar la conexión
</h2>

Haga a su asistente una pregunta sobre cualquier producto de ABBYY:

> «¿Qué parámetros requiere la API de procesamiento de Vantage para enviar un documento?»

El asistente llama a `search_abbyy_documentation` y, normalmente, después ejecuta `query_docs_filesystem_abbyy_documentation` para leer la página completa antes de responder. En los clientes que muestran las llamadas a herramientas, esos son los nombres que debe buscar.

<Warning>
  Si el servidor no aparece en su cliente, compruebe que la URL se haya introducido exactamente como `https://docs.abbyy.com/mcp`, sin barra final, y que su equipo tenga acceso de red para alcanzarla.
</Warning>

<h2 id="what-your-assistant-can-do">
  Qué puede hacer tu asistente
</h2>

El servidor expone tres herramientas. El asistente decide cuándo llamar a cada una según tu pregunta.

| Herramienta                                 | Qué hace                                                                                                                                                                                                                                                                       |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `search_abbyy_documentation`                | Búsqueda semántica en todo el sitio. Devuelve pasajes relevantes con títulos de página y enlaces. Admite un filtro `language` opcional (`en`, `de`, `es`, `fr`, `ja`); de forma predeterminada, los resultados se muestran en inglés                                           |
| `query_docs_filesystem_abbyy_documentation` | Lee la documentación como un sistema de archivos virtual de solo lectura. El asistente lo usa para ejecutar `cat` o `head` sobre páginas completas, `rg` para buscar palabras clave exactas y consultar las especificaciones OpenAPI con `jq`. No se ejecuta nada en tu equipo |
| `submit_feedback`                           | Informa de un problema de documentación al equipo de documentación de ABBYY, indicando la ruta de la página y una descripción del error                                                                                                                                        |

**Preguntas de ejemplo:**

* «¿Cómo configuro un Skill de documento en Vantage?»
* «¿Qué hace el parámetro `minConfidence`?»
* «¿Cómo configuro una conexión LLM en Vantage?»
* «¿Qué valores de `outputType` acepta FineParser?»
* «Enumera los endpoints de la Reporting API de Vantage»

<Tip>
  Si tu asistente encuentra una página incorrecta o desactualizada, pídele que informe del problema. Llamará a `submit_feedback` con la página y la incidencia, que llegará directamente al equipo de documentación.
</Tip>

<h2 id="tips-for-effective-questions">
  Consejos para formular preguntas eficaces
</h2>

* **Sea específico.** Incluya el nombre de la función o el endpoint de la API en lugar de preguntar en términos generales
* **Indique el producto.** El servidor abarca varios productos, así que «Vantage Process Skill» o «FineParser fast mode» acotan la búsqueda
* **Utilice la terminología del producto.** Términos como «Process Skill», «Skill de documento», «Skill Designer» y «tenant» devuelven resultados más precisos
* **Pregunte en otro idioma.** Pregunte en alemán, español, francés o japonés, o escriba «busca en la documentación en alemán», y el asistente aplicará el filtro `language` correspondiente
* **Haga preguntas de seguimiento.** Su asistente conserva el contexto, por lo que puede acotar los resultados con nuevas preguntas
* **Combínelo con su código.** Pegue una respuesta de la API o un fragmento de configuración y pida al asistente que se lo explique a partir de la documentación

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

<AccordionGroup>
  <Accordion title="El servidor no aparece en mi cliente">
    Compruebe que la configuración se haya guardado y, en el caso de los archivos JSON, que no haya comas sobrantes al final. Reinicie el cliente por completo. En un proyecto con un archivo `.mcp.json`, apruebe el servidor cuando Claude Code se lo solicite. En VS Code, la compatibilidad con MCP requiere la versión 1.99 o posterior; consulte **Ayuda → Acerca de**.
  </Accordion>

  <Accordion title="Las herramientas nunca se invocan">
    Los asistentes invocan las herramientas MCP según su relevancia. Formule la petición de forma más explícita («Busca en la documentación de ABBYY...») o mencione una función concreta del producto. En Copilot Chat, asegúrese de que el selector de modo esté en **Agent**; las herramientas no están disponibles en los modos Ask y Edit.
  </Accordion>

  <Accordion title="La búsqueda devuelve resultados irrelevantes">
    Reformule la consulta con términos de la interfaz del producto o de la documentación. Evite términos genéricos como «flujo de trabajo» o «configuración» por sí solos; combínelos con el nombre del producto o con una función concreta.
  </Accordion>

  <Accordion title="Los resultados están en otro idioma">
    La búsqueda utiliza el inglés de forma predeterminada. Pida al asistente que busque en la documentación en el idioma que desee y este establecerá el filtro `language`.
  </Accordion>
</AccordionGroup>

<h2 id="remove-the-server">
  Eliminar el servidor
</h2>

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp remove abbyy-docs
    ```

    Añada `--scope project` o `--scope user` según el ámbito con el que lo haya agregado.
  </Tab>

  <Tab title="VS Code (Copilot)">
    Ejecute **MCP: List Servers**, seleccione `abbyy-docs` y elija **Remove**. También puede eliminar la entrada de `.vscode/mcp.json` o de su configuración MCP de usuario.
  </Tab>

  <Tab title="Cursor">
    Elimine el servidor en **Cursor Settings → MCP** o quite la entrada de `.cursor/mcp.json` o `~/.cursor/mcp.json`.
  </Tab>

  <Tab title="Codex">
    ```bash theme={null}
    codex mcp remove abbyy-docs
    ```
  </Tab>

  <Tab title="Aplicación Claude">
    Abra **Settings → Connectors**, busque el conector y elimínelo.
  </Tab>
</Tabs>

<Note>
  Si agregó el servidor con un nombre anterior, como `abbyy-vantage`, seguirá funcionando. Elimínelo de la misma manera, usando ese nombre.
</Note>

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

<CardGroup cols={2}>
  <Card title="Primeros pasos con la Vantage API" icon="plug" href="/es/vantage/developer/getting-started">
    Realice su primera llamada y autentíquese con OAuth 2.0
  </Card>

  <Card title="LLMs en ABBYY Vantage" icon="brain" href="/es/vantage/documentation/llms/llms">
    Use su propia conexión LLM o ABBYY Phoenix Plus
  </Card>

  <Card title="Trabajar con skills" icon="wand-magic-sparkles" href="/es/vantage/documentation/skills/overview">
    Elija, cree y publique los skills que procesan sus documentos
  </Card>

  <Card title="FineParser y agentes de IA para programación" icon="robot" href="/es/fine-parser/getting-started/ai-agents">
    Use el mismo servidor para escribir una integración con FineParser
  </Card>
</CardGroup>