Passer au contenu principal

​
Vue d’ensemble

Ce que vous allez faire :
  • Ajouter le serveur MCP ABBYY Vantage à Claude Code
  • Vérifier que la connexion fonctionne
  • Utiliser l’outil SearchAbbyyVantageDocumentation pour effectuer des recherches dans la documentation depuis votre workflow d’IA
Temps nécessaire : ~5 minutes

​
Qu’est-ce que le serveur MCP ?

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux assistants IA de se connecter à des outils externes et à des sources de données. En ajoutant un serveur MCP à Claude Code, vous donnez à l’IA un accès direct à des données structurées ou à des fonctionnalités, sans avoir à copier-coller manuellement du contenu. Le serveur MCP ABBYY Vantage expose un seul outil, SearchAbbyyVantageDocumentation, qui effectue une recherche sémantique dans l’ensemble de la documentation Vantage. Lorsque Claude Code est connecté à ce serveur, il peut rechercher des paramètres d’API, des options de configuration des Skills, des étapes de dépannage, et bien plus encore, automatiquement, pendant que vous travaillez.
Le serveur MCP fournit un accès en lecture seule à la documentation publique. Il ne se connecte pas à votre tenant Vantage, ne traite pas de documents et ne nécessite aucun identifiant Vantage.

​
Prérequis

  • Claude Code installé et en cours d’exécution
  • Accès au terminal (macOS, Linux ou Windows avec WSL)
Aucun tenant ni compte ABBYY Vantage n’est nécessaire pour utiliser le serveur MCP.
1

Ajouter via CLI (recommandé)

Exécutez la commande suivante dans votre terminal pour enregistrer le serveur MCP dans Claude Code :
Options de portée :Par défaut, cette commande ajoute le serveur au niveau du projet, ce qui signifie qu’il n’est disponible que dans le répertoire actuel (dans .claude/settings.json). Pour le rendre disponible dans tous vos projets, ajoutez l’option --scope user :
2

Alternative : configuration manuelle

Si vous préférez effectuer la configuration manuellement, ajoutez le JSON suivant à votre fichier de paramètres.
Créez ou modifiez .claude/settings.json à la racine de votre projet :
Modifiez ~/.claude/settings.json dans votre répertoire personnel :
3

Vérifier la connexion

Redémarrez Claude Code, puis exécutez la commande slash suivante pour vérifier que le serveur est bien enregistré :
Vous devriez voir abbyy-vantage dans la liste, avec l’état connecté. Pour confirmer que l’outil fonctionne, posez à Claude une question sur Vantage :
« Quels parameters l’API de traitement Vantage requiert-elle pour soumettre un document ? »
Claude Code appellera SearchAbbyyVantageDocumentation et renverra des résultats issus de la Documentation.
Si le serveur n’apparaît pas dans /mcp, vérifiez que l’URL a bien été saisie exactement sous la forme https://docs.abbyy.com/mcp, sans barre oblique finale. Vérifiez également que votre terminal dispose d’un accès réseau au serveur.

​
Outils disponibles

Le serveur MCP ABBYY Vantage met à disposition un outil : SearchAbbyyVantageDocumentation Effectue une recherche sémantique dans la documentation ABBYY Vantage et renvoie le contenu le plus pertinent. Claude Code invoque automatiquement cet outil lorsque vous posez des questions sur Vantage. Exemples de requêtes :
  • “Comment configurer une compétence de document dans Vantage ?”
  • “À quoi sert le paramètre minConfidence ?”
  • “Comment configurer une connexion LLM dans Vantage ?”
  • “Quels formats d’export Vantage prend-il en charge ?”
  • “Comment m’authentifier avec l’API REST de Vantage ?”

​
Cas d’usage

  • Intégrations API : consultez les paramètres du point de terminaison, les méthodes d’authentification et les formats de requête/réponse sans quitter votre IDE
  • Configuration des compétences : trouvez rapidement les options de configuration et les bonnes pratiques pour les Compétences de document, les Compétences de processus et Advanced Designer
  • Dépannage : recherchez des messages d’erreur et des problèmes connus pour résoudre plus vite les problèmes lors du débogage des intégrations
  • Exploration des fonctionnalités : découvrez ce que Vantage prend en charge — modèles d’extraction, formats pris en charge, paramètres du tenant — lors de la planification de votre projet

​
Conseils pour formuler des requêtes efficaces

  • Soyez précis : indiquez le nom de la fonctionnalité ou du point de terminaison API dans votre question, plutôt que de poser une question trop générale
  • Utilisez la terminologie de Vantage : des termes comme “Compétence de processus”, “Compétence de document”, “Skill Designer” et “tenant” donneront des résultats plus précis
  • Posez des questions de suivi : Claude Code conserve le contexte, vous pouvez donc affiner les résultats avec des prompts de suivi
  • Combinez avec votre code : collez une réponse d’API ou un extrait de configuration, puis demandez à Claude de l’expliquer à l’aide de la documentation Vantage

​
Suppression du serveur MCP

Pour supprimer le serveur MCP ABBYY Vantage de Claude Code, exécutez :
Si vous avez ajouté le serveur au niveau utilisateur, incluez l’indicateur --scope user :

​
Résolution des problèmes

Server n’apparaît pas dans /mcp Vérifiez que le fichier de configuration a bien été enregistré et que le JSON est valide (sans virgule finale). Redémarrez complètement Claude Code après avoir effectué les modifications. L’outil n’est pas appelé automatiquement Claude Code appelle les outils MCP en fonction de leur pertinence. Si l’outil n’est pas utilisé, essayez de formuler votre question de manière plus explicite : « Recherchez dans la documentation ABBYY Vantage… » ou mentionnez une fonctionnalité précise de Vantage par son nom. La recherche renvoie des résultats non pertinents Reformulez votre requête en utilisant des termes issus de l’interface ou de la documentation Vantage. Évitez les termes génériques comme « workflow » ou « paramètres » pris isolément — associez-les à « Vantage » ou au nom d’une fonctionnalité précise.

​
Résumé

Vous avez réussi à :
  • ✅ Ajouter le serveur MCP ABBYY Vantage à Claude Code
  • ✅ Vérifier la connexion à l’aide de /mcp
  • ✅ Apprendre à déclencher une recherche dans la documentation depuis votre workflow d’IA

​
Étapes suivantes

Introduction à l’API

Commencez à utiliser l’API REST Vantage Processing

Traitement des documents

Créez une Compétence de processus et automatisez le traitement des documents via SFTP

Configuration des connexions LLM

Connectez Vantage à OpenAI ou Microsoft Foundry

Extraction basée sur des prompts

Utilisez des prompts en langage naturel pour extraire des données de documents