Passer au contenu principal

Vue d’ensemble

Ce que vous allez accomplir :
  • Ajouter le serveur MCP ABBYY Vantage à Claude Code
  • Vérifier que la connexion fonctionne
  • Utiliser l’outil SearchAbbyyVantageDocumentation pour rechercher dans la documentation au sein de votre flux de travail 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 et à des sources de données externes. 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 le contenu manuellement. 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 automatiquement des paramètres d’API, des options de configuration de Skill, des étapes de dépannage, et plus encore — au fil de votre travail.
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 à un terminal (macOS, Linux ou Windows avec WSL)
Aucun tenant ni compte ABBYY Vantage n’est requis pour utiliser le serveur MCP.

1

Ajout via la CLI (recommandé)

Exécutez la commande suivante dans votre terminal pour enregistrer le serveur MCP auprès de Claude Code :
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse
Options de portée :Par défaut, cela ajoute le serveur au niveau du projet, ce qui signifie qu’il n’est disponible que dans le répertoire actuel (enregistré dans .claude/settings.json). Pour le rendre disponible dans tous vos projets, ajoutez l’option --scope user :
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse --scope user
PortéeFichier de configurationQuand l’utiliser
Projet (par défaut).claude/settings.jsonUn projet spécifique
Utilisateur~/.claude/settings.jsonTous les projets sur cette machine
2

Alternative : configuration manuelle

Si vous préférez configurer manuellement, ajoutez le JSON suivant à votre fichier de paramètres.
Créez ou modifiez .claude/settings.json à la racine de votre projet :
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
Modifiez ~/.claude/settings.json dans votre répertoire personnel :
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

Vérifier la connexion

Redémarrez Claude Code, puis exécutez la commande suivante (slash command) pour vérifier que le serveur est bien enregistré :
/mcp
Vous devriez voir abbyy-vantage affiché avec un statut « connecté ». Pour confirmer que l’outil fonctionne, posez à Claude une question liée à Vantage :
« Quels paramètres l’API Vantage Processing nécessite-t-elle pour envoyer 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 est saisie exactement comme https://docs.abbyy.com/mcp sans barre oblique finale. Confirmez également que votre terminal dispose d’un accès réseau pour joindre le serveur.

Outils disponibles

Le serveur MCP d’ABBYY Vantage expose un outil : SearchAbbyyVantageDocumentation Effectue une recherche sémantique dans la documentation d’ABBYY Vantage et renvoie le contenu le plus pertinent. Claude Code appelle automatiquement cet outil lorsque vous posez des questions concernant 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 sont pris en charge par Vantage ?”
  • “Comment m’authentifier auprès de l’API REST de Vantage ?”

Cas d’utilisation

Intégrations API

Consultez les paramètres de point de terminaison, les méthodes d’authentification et les formats de requête/réponse sans quitter votre IDE

Configuration des Skills

Trouvez rapidement les options de configuration et les bonnes pratiques pour les Compétences de document, les Compétences de processus et Advanced Designer

Résolution des problèmes

Recherchez des messages d’erreur et des problèmes connus pour résoudre les incidents plus rapidement lors du débogage des intégrations

Exploration des fonctionnalités

Découvrez ce que Vantage propose — modèles d’extraction, formats pris en charge, paramètres du tenant — lors de la planification de votre projet

Conseils pour des requêtes efficaces

  • Soyez précis : Incluez le nom de la fonctionnalité ou de l’endpoint d’API dans votre question plutôt que de poser une question trop générale
  • Utilisez la terminologie Vantage : L’utilisation de termes comme « Process Skill », « Document Skill », « Skill Designer » et « tenant » fournira des résultats plus précis
  • Posez des questions de suivi : Claude Code conserve le contexte, ce qui vous permet de restreindre les résultats avec des questions complémentaires
  • Combinez avec votre code : Collez une réponse d’API ou un extrait de configuration et demandez à Claude de l’expliquer en s’appuyant sur la documentation de Vantage

Dépannage

Le serveur ne s’affiche pas dans /mcp Vérifiez que le fichier de configuration a été correctement enregistré et que le JSON est valide (sans virgules terminales). Redémarrez complètement Claude Code après avoir apporté des modifications. L’outil n’est pas invoqué automatiquement Claude Code invoque les outils MCP en fonction de leur pertinence. Si l’outil n’est pas utilisé, essayez de formuler votre demande de façon plus explicite : « Recherche dans la documentation ABBYY Vantage… » ou mentionnez une fonctionnalité spécifique 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 de Vantage. Évitez les termes génériques comme « workflow » ou « settings » seuls — associez-les à « Vantage » ou au nom d’une fonctionnalité spécifique.

Résumé

Vous avez réussi à :
  • ✅ Ajouter le serveur MCP ABBYY Vantage à Claude Code
  • ✅ Vérifier la connexion en utilisant la commande /mcp
  • ✅ Apprendre à lancer une recherche dans la documentation depuis votre flux de travail d’IA

Prochaines étapes