Utiliser la documentation avec votre assistant IA

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.

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.

Durée estimée : ~5 minutes

Connectez votre assistant

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

Claude Code
VS Code (Copilot)
Cursor
Codex
Application Claude

Exécutez cette commande dans votre terminal :

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 :

{
  "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é ».

Nécessite VS Code 1.99 ou version ultérieure avec l’extension GitHub Copilot connectée.

Ouvrez la Command Palette avec Cmd+Maj+P (macOS) ou Ctrl+Maj+P (Windows/Linux)
Exécutez MCP: Add Server…
Sélectionnez HTTP comme type de transport
Saisissez l’URL https://docs.abbyy.com/mcp
Saisissez le nom abbyy-docs
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 :

{
  "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.

Ouvrez Cursor Settings et sélectionnez MCP
Cliquez sur Add new MCP server
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) :

{
  "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.

Exécutez cette commande dans votre terminal :

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.

Ouvrez Settings et sélectionnez Connectors
Cliquez sur Add custom connector
Saisissez le nom ABBYY docs et l’URL https://docs.abbyy.com/mcp
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.

Vérifier la connexion

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.

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.

Ce que votre assistant peut faire

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 »

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.

Conseils pour poser des questions efficaces

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

Résolution des problèmes

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.

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.

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.

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.

Supprimer le serveur

Claude Code
VS Code (Copilot)
Cursor
Codex
Application Claude

claude mcp remove abbyy-docs

Ajoutez --scope project ou --scope user selon le scope utilisé lors de l’ajout.

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.

Supprimez le serveur dans Cursor Settings → MCP, ou supprimez l’entrée dans .cursor/mcp.json ou ~/.cursor/mcp.json.

codex mcp remove abbyy-docs

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.

Étapes suivantes

Premiers pas avec l’API Vantage

Effectuez votre premier appel et authentifiez-vous avec OAuth 2.0

Les LLM dans ABBYY Vantage

Utilisez votre propre connexion LLM ou ABBYY Phoenix Plus

Travailler avec les compétences

Choisissez, créez et publiez les compétences qui traitent vos documents

FineParser et les agents de codage IA

Utilisez le même serveur pour développer une intégration FineParser

Getting Started

Go Deeper

Utiliser la documentation avec votre assistant IA

Connectez votre assistant

Vérifier la connexion

Ce que votre assistant peut faire

Conseils pour poser des questions efficaces

Résolution des problèmes

Supprimer le serveur

Étapes suivantes

Premiers pas avec l’API Vantage

Les LLM dans ABBYY Vantage

Travailler avec les compétences

FineParser et les agents de codage IA

​Connectez votre assistant

​Vérifier la connexion

​Ce que votre assistant peut faire

​Conseils pour poser des questions efficaces

​Résolution des problèmes

​Supprimer le serveur

​Étapes suivantes

Premiers pas avec l’API Vantage

Les LLM dans ABBYY Vantage

Travailler avec les compétences

FineParser et les agents de codage IA

Connectez votre assistant

Vérifier la connexion

Ce que votre assistant peut faire

Conseils pour poser des questions efficaces

Résolution des problèmes

Supprimer le serveur

Étapes suivantes