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

# Utiliser la documentation avec votre assistant IA

> Connectez Claude Code, VS Code Copilot, Cursor, Codex ou l'application Claude au serveur MCP de la documentation ABBYY afin que votre assistant puisse rechercher et consulter la documentation Vantage, FineParser, FineReader Engine et FlexiCapture pendant que vous travaillez.

Le serveur MCP de la documentation ABBYY permet à un assistant IA de rechercher et de consulter ce site pendant que vous travaillez : tous les produits documentés ici (ABBYY Vantage, Vantage Self-Hosted, FineParser, FineReader Engine et FlexiCapture), ainsi que les spécifications OpenAPI de Vantage. Il suffit de le connecter une fois pour que votre assistant réponde à partir de la documentation à jour, et non de ses données d'entraînement.

Le serveur est public et en lecture seule. Il ne se connecte à aucun tenant Vantage, ne traite aucun document et ne nécessite aucun identifiant ABBYY ; rien ne s'exécute sur votre machine.

<Note>
  Cette page porte sur la recherche dans la documentation. Il ne s'agit pas du serveur MCP Vantage, qui relie un assistant à votre tenant Vantage pour exécuter des compétences et traiter des documents.
</Note>

**Durée estimée :** \~5 minutes

<h2 id="connect-your-assistant">
  Connectez votre assistant
</h2>

L'adresse du serveur est la même partout : `https://docs.abbyy.com/mcp`, transport HTTP, sans authentification. Choisissez votre client.

<Tabs>
  <Tab title="Claude Code">
    Exécutez cette commande dans votre terminal :

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

    Par défaut, le serveur est ajouté au scope **local** : il n'est disponible que pour vous, dans le projet en cours. Utilisez `--scope` pour modifier ce comportement.

    | Scope                | Emplacement de stockage                                                  | Quand l'utiliser                                                            |
    | -------------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
    | `local` (par défaut) | Votre configuration utilisateur Claude Code, associée au projet en cours | Pour faire un essai dans un seul projet                                     |
    | `project`            | `.mcp.json` à la racine du projet, versionné avec le code                | Pour partager le serveur avec toutes les personnes travaillant sur le dépôt |
    | `user`               | Votre configuration utilisateur Claude Code, pour tous les projets       | Pour en disposer partout sur cette machine                                  |

    Pour partager le serveur via le version control, créez ou modifiez `.mcp.json` à la racine du projet plutôt que d'exécuter la commande :

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

    Claude Code lit ce fichier au démarrage et vous demande d'approuver le serveur lors de sa première utilisation dans ce projet.

    Redémarrez Claude Code et exécutez `/mcp`. `abbyy-docs` doit apparaître avec le statut « connecté ».
  </Tab>

  <Tab title="VS Code (Copilot)">
    Nécessite VS Code **1.99 ou version ultérieure** avec l'extension GitHub Copilot connectée.

    1. Ouvrez la Command Palette avec **Cmd+Maj+P** (macOS) ou **Ctrl+Maj+P** (Windows/Linux)
    2. Exécutez **MCP: Add Server...**
    3. Sélectionnez **HTTP** comme type de transport
    4. Saisissez l'URL `https://docs.abbyy.com/mcp`
    5. Saisissez le nom `abbyy-docs`
    6. Choisissez **Workspace** (`.vscode/mcp.json`, partagé avec le dépôt) ou **User** (tous les projets sur cette machine)

    Pour configurer manuellement, créez ou modifiez `.vscode/mcp.json`, ou exécutez **MCP: Open User Configuration** pour le fichier au niveau utilisateur :

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

    Exécutez **MCP: List Servers** et vérifiez que `abbyy-docs` apparaît comme connecté. Dans Copilot Chat, basculez en **Agent mode** : c'est le seul mode où les outils MCP sont disponibles.
  </Tab>

  <Tab title="Cursor">
    1. Ouvrez **Cursor Settings** et sélectionnez **MCP**
    2. Cliquez sur **Add new MCP server**
    3. Saisissez le nom `abbyy-docs` et l'URL `https://docs.abbyy.com/mcp`

    Vous pouvez aussi ajouter l'entrée dans `.cursor/mcp.json` au sein du projet (partagé avec le dépôt) ou dans `~/.cursor/mcp.json` (tous les projets) :

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

    Une fois Cursor connecté, le serveur apparaît dans la liste des paramètres MCP avec un statut vert.
  </Tab>

  <Tab title="Codex">
    Exécutez cette commande dans votre terminal :

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

    Redémarrez Codex. Le serveur est disponible dans tous les projets de cette machine.
  </Tab>

  <Tab title="Application Claude">
    1. Ouvrez **Settings** et sélectionnez **Connectors**
    2. Cliquez sur **Add custom connector**
    3. Saisissez le nom `ABBYY docs` et l'URL `https://docs.abbyy.com/mcp`
    4. Cliquez sur **Add**

    Aucune étape de connexion n'est requise, car le serveur ne nécessite pas d'authentification. Dans une conversation, ouvrez le menu des pièces jointes (l'icône plus) et activez le connector.
  </Tab>
</Tabs>

<h2 id="verify-the-connection">
  Vérifier la connexion
</h2>

Posez à votre assistant une question sur n'importe quel produit ABBYY :

> « Quels paramètres l'API de traitement Vantage exige-t-elle pour soumettre un document ? »

L'assistant appelle `search_abbyy_documentation`, puis enchaîne généralement avec `query_docs_filesystem_abbyy_documentation` pour lire la page entière avant de répondre. Dans les clients qui affichent les appels d'outils, ce sont ces noms qu'il faut repérer.

<Warning>
  Si le serveur n'apparaît pas dans votre client, vérifiez que l'URL saisie est exactement `https://docs.abbyy.com/mcp`, sans barre oblique finale, et que votre machine dispose d'un accès réseau lui permettant de l'atteindre.
</Warning>

<h2 id="what-your-assistant-can-do">
  Ce que votre assistant peut faire
</h2>

Le serveur expose trois outils. L'assistant décide quand appeler chacun d'eux en fonction de votre question.

| Outil                                       | Rôle                                                                                                                                                                                                                                                                                      |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_abbyy_documentation`                | Recherche sémantique sur l'ensemble du site. Renvoie les passages pertinents avec les titres de page et les liens. Accepte un filtre `language` facultatif (`en`, `de`, `es`, `fr`, `ja`) ; par défaut, les résultats sont en anglais                                                     |
| `query_docs_filesystem_abbyy_documentation` | Lit la documentation comme un système de fichiers virtuel en lecture seule. L'assistant s'en sert pour exécuter `cat` ou `head` sur des pages entières, `rg` pour rechercher des mots-clés exacts et interroger les spécifications OpenAPI avec `jq`. Rien ne s'exécute sur votre machine |
| `submit_feedback`                           | Signale un problème de documentation à l'équipe documentation d'ABBYY, en précisant le chemin de la page et la nature du problème                                                                                                                                                         |

**Exemples de questions :**

* « Comment configurer une Compétence de document dans Vantage ? »
* « À quoi sert le paramètre `minConfidence` ? »
* « Comment configurer une connexion LLM dans Vantage ? »
* « Quelles valeurs de `outputType` FineParser accepte-t-il ? »
* « Liste les points de terminaison de la Vantage Reporting API »

<Tip>
  Si votre assistant tombe sur une page erronée ou obsolète, demandez-lui de signaler le problème. Il appelle `submit_feedback` en transmettant la page et le problème constaté, qui parvient directement à l'équipe documentation.
</Tip>

<h2 id="tips-for-effective-questions">
  Conseils pour poser des questions efficaces
</h2>

* **Soyez précis.** Indiquez le nom de la fonctionnalité ou du point de terminaison d'API plutôt que de poser une question d'ordre général
* **Nommez le produit.** Le serveur couvre plusieurs produits : une requête telle que « Vantage Process Skill » ou « FineParser fast mode » affine la recherche
* **Employez la terminologie produit.** Des termes comme « Process Skill », « Compétence de document », « Skill Designer » ou « tenant » donnent des résultats plus précis
* **Demandez une autre langue.** Posez votre question en allemand, en espagnol, en français ou en japonais, ou précisez « recherche dans la documentation allemande » : l'assistant applique alors le filtre `language` correspondant
* **Posez des questions complémentaires.** Votre assistant conserve le contexte : vous pouvez donc affiner les résultats à l'aide de prompts de suivi
* **Combinez avec votre code.** Collez une réponse d'API ou un extrait de configuration et demandez à l'assistant de vous l'expliquer en s'appuyant sur la documentation

<h2 id="troubleshooting">
  Résolution des problèmes
</h2>

<AccordionGroup>
  <Accordion title="Le serveur n’apparaît pas dans mon client">
    Vérifiez que la configuration a bien été enregistrée et, pour les fichiers JSON, qu’il n’y a pas de virgule superflue en fin de liste. Redémarrez complètement le client. Dans un projet comportant un fichier `.mcp.json`, approuvez le serveur lorsque Claude Code vous y invite. Dans VS Code, la prise en charge de MCP nécessite la version 1.99 ou une version ultérieure ; vérifiez via **Help → About**.
  </Accordion>

  <Accordion title="Les outils ne sont jamais appelés">
    Les assistants appellent les outils MCP en fonction de leur pertinence. Formulez une demande plus explicite (« Recherche dans la documentation ABBYY... ») ou citez une fonctionnalité précise du produit. Dans Copilot Chat, assurez-vous que le sélecteur de mode est positionné sur **Agent** ; les outils ne sont pas disponibles dans les modes Ask et Edit.
  </Accordion>

  <Accordion title="La recherche renvoie des résultats non pertinents">
    Reformulez votre requête avec des termes issus de l’interface du produit ou de la documentation. Évitez les termes génériques tels que « workflow » ou « paramètres » employés seuls ; associez-les au nom du produit ou à une fonctionnalité précise.
  </Accordion>

  <Accordion title="Les résultats sont dans la mauvaise langue">
    La recherche s’effectue en anglais par défaut. Demandez à l’assistant de rechercher dans la documentation dans la langue souhaitée : il définira alors le filtre `language`.
  </Accordion>
</AccordionGroup>

<h2 id="remove-the-server">
  Supprimer le serveur
</h2>

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

    Ajoutez `--scope project` ou `--scope user` selon le scope utilisé lors de l'ajout.
  </Tab>

  <Tab title="VS Code (Copilot)">
    Exécutez **MCP: List Servers**, sélectionnez `abbyy-docs`, puis choisissez **Remove**. Vous pouvez aussi supprimer l'entrée dans `.vscode/mcp.json` ou dans votre configuration MCP utilisateur.
  </Tab>

  <Tab title="Cursor">
    Supprimez le serveur dans **Cursor Settings → MCP**, ou supprimez l'entrée dans `.cursor/mcp.json` ou `~/.cursor/mcp.json`.
  </Tab>

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

  <Tab title="Application Claude">
    Ouvrez **Settings → Connectors**, repérez le connector, puis supprimez-le.
  </Tab>
</Tabs>

<Note>
  Si vous avez ajouté le serveur sous un ancien nom tel que `abbyy-vantage`, il continue de fonctionner. Supprimez-le de la même manière, en utilisant ce nom.
</Note>

<h2 id="next-steps">
  Étapes suivantes
</h2>

<CardGroup cols={2}>
  <Card title="Premiers pas avec l’API Vantage" icon="plug" href="/fr/vantage/developer/getting-started">
    Effectuez votre premier appel et authentifiez-vous avec OAuth 2.0
  </Card>

  <Card title="Les LLM dans ABBYY Vantage" icon="brain" href="/fr/vantage/documentation/llms/llms">
    Utilisez votre propre connexion LLM ou ABBYY Phoenix Plus
  </Card>

  <Card title="Travailler avec les compétences" icon="wand-magic-sparkles" href="/fr/vantage/documentation/skills/overview">
    Choisissez, créez et publiez les compétences qui traitent vos documents
  </Card>

  <Card title="FineParser et les agents de codage IA" icon="robot" href="/fr/fine-parser/getting-started/ai-agents">
    Utilisez le même serveur pour développer une intégration FineParser
  </Card>
</CardGroup>