Passer au contenu principal

​
Vue d’ensemble

Ce que vous allez faire :
  • Ajouter le serveur MCP ABBYY Vantage à GitHub Copilot dans VS Code
  • Vérifier que la connexion fonctionne
  • Utiliser l’outil SearchAbbyyVantageDocumentation pour effectuer des recherches dans la documentation depuis Copilot Chat
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 à GitHub Copilot, 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 Copilot est connecté à ce serveur, il peut rechercher des paramètres d’API, des options de configuration des compétences, 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

  • VS Code version 1.99 ou ultérieure (prise en charge de MCP requise)
  • extension GitHub Copilot installée, avec connexion au compte effectuée
Aucun tenant ni compte ABBYY Vantage n’est requis pour utiliser le serveur MCP.
1

Ajouter via la palette de commandes (recommandé)

Utilisez la palette de commandes de VS Code pour enregistrer le serveur MCP :
  1. Ouvrez la palette de commandes avec Cmd+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
  2. Saisissez “MCP: Add Server…” et sélectionnez cette option
  3. Sélectionnez HTTP comme type de transport
  4. Saisissez l’URL : https://docs.abbyy.com/mcp
  5. Saisissez le nom : abbyy-vantage
  6. Choisissez la portée : Workspace ou User
2

Alternative : configuration manuelle

Si vous préférez effectuer la configuration manuellement, ajoutez l’entrée du serveur dans le fichier de configuration approprié.
Créez ou modifiez .vscode/mcp.json à la racine de votre projet :
Ouvrez la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P), saisissez “MCP: Open User Configuration”, puis ajoutez l’entrée suivante :
3

Vérifier la connexion

  1. Ouvrez la palette de commandes et exécutez “MCP: List Servers” — vérifiez que abbyy-vantage apparaît comme connecté
  2. Ouvrez Copilot Chat (cliquez sur l’icône Copilot dans la barre latérale ou appuyez sur Ctrl+Shift+I / Cmd+Shift+I)
  3. Passez en Agent mode à l’aide du sélecteur de mode en haut du panneau de chat
  4. Cliquez sur l’icône des outils dans le champ de saisie du chat — vérifiez que SearchAbbyyVantageDocumentation apparaît dans la liste
  5. Testez avec une question :
“De quels paramètres l’API de traitement Vantage a-t-elle besoin pour soumettre un document ?”
Copilot appellera SearchAbbyyVantageDocumentation et renverra des résultats issus de la documentation.
L’URL doit être saisie exactement sous la forme https://docs.abbyy.com/mcp, sans barre oblique finale. Vérifiez également que VS Code dispose d’un accès réseau au serveur.

​
Outils disponibles

Le serveur MCP ABBYY Vantage met à disposition un outil : SearchAbbyyVantageDocumentation Il effectue une recherche sémantique dans la documentation ABBYY Vantage et renvoie le contenu le plus pertinent. Copilot invoque automatiquement cet outil en mode Agent 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 auprès de l’API REST de Vantage ?”

​
Cas d’usage

  • Intégrations API : Recherchez 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 afin de résoudre plus rapidement les problèmes lors du débogage des intégrations
  • Découverte 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 : incluez le nom de la fonctionnalité ou du point de terminaison API dans votre question, plutôt que de rester général
  • 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 : Copilot conserve le contexte, ce qui vous permet d’affiner les résultats avec des questions complémentaires
  • Combinez avec votre code : collez une réponse API ou un extrait de configuration et demandez à Copilot de l’expliquer à l’aide de la documentation Vantage
  • Utilisez le mode Agent : les outils MCP sont disponibles uniquement en mode Agent — assurez-vous que le sélecteur de mode est défini sur “Agent” avant de poser votre question

​
Suppression du serveur MCP

Vous pouvez supprimer le serveur en utilisant l’une ou l’autre des méthodes suivantes : Via la palette de commandes :
  1. Ouvrez la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P)
  2. Exécutez “MCP: List Servers”
  3. Sélectionnez abbyy-vantage
  4. Choisissez Supprimer
Via le fichier de configuration : Supprimez l’entrée abbyy-vantage de .vscode/mcp.json (workspace) ou de votre configuration MCP utilisateur.

​
Dépannage

Le serveur n’apparaît pas dans « MCP: List Servers » Vérifiez que le fichier de configuration a bien été enregistré et que le JSON est valide (sans virgule finale). Si vous avez modifié le fichier manuellement, essayez de recharger VS Code (Developer: Reload Window dans la palette de commandes). Version de VS Code trop ancienne La prise en charge de MCP nécessite VS Code 1.99 ou une version ultérieure. Vérifiez votre version via Aide → À propos et mettez à jour si nécessaire. L’outil n’est pas appelé automatiquement Copilot n’appelle les outils MCP qu’en mode Agent. Assurez-vous d’être passé du mode “Ask” ou “Edit” au mode “Agent” à l’aide du sélecteur de mode en haut du volet Copilot Chat. Si l’outil n’est toujours pas utilisé, essayez de formuler votre question plus explicitement : “Recherchez dans la documentation ABBYY Vantage…” ou mentionnez explicitement une fonctionnalité de Vantage. La recherche renvoie des résultats non pertinents Reformulez votre requête en utilisant les termes de l’interface ou de la documentation Vantage. Évitez d’utiliser seuls des termes génériques comme “workflow” ou “settings” — associez-les à “Vantage” ou au nom d’une fonctionnalité précise.

​
Résumé

Vous avez réussi à :
  • ✅ ajouter le serveur MCP ABBYY Vantage à GitHub Copilot dans VS Code
  • ✅ vérifier la connexion à l’aide de “MCP: List Servers”
  • ✅ apprendre à déclencher une recherche dans la documentation depuis Copilot Chat en mode Agent

​
Étapes suivantes

Introduction à l'API

Découvrez comment démarrer avec 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

serveur MCP pour Claude Code

Ajoutez le même serveur MCP à Claude Code