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 externes et à des sources de données. 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 d’ABBYY Vantage expose un seul outil, SearchAbbyyVantageDocumentation, qui effectue une recherche sémantique dans toute la documentation Vantage. Lorsque ce serveur est connecté à Copilot, celui-ci peut rechercher automatiquement, pendant que vous travaillez, des paramètres d’API, des options de configuration des compétences, des étapes de dépannage, et bien plus encore.
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 MCP requise)
  • Extension GitHub Copilot installée et connectée
Aucun tenant ni compte ABBYY Vantage n’est requis pour utiliser le serveur MCP.
1

Ajout via la palette de commandes (recommandé)

Utilisez la palette de commandes 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. Entrez l’URL : https://docs.abbyy.com/mcp
  5. Entrez le nom : abbyy-vantage
  6. Choisissez la portée : Workspace ou User
PortéeEmplacement de la configurationQuand l’utiliser
Workspace.vscode/mcp.jsonUn projet spécifique
UserParamètres utilisateur via la palette de commandesTous les projets sur cette machine
2

Alternative : configuration manuelle

Si vous préférez configurer le serveur manuellement, ajoutez son entrée dans le fichier de configuration approprié.
Créez ou modifiez .vscode/mcp.json à la racine de votre projet :
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
Ouvrez la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P), saisissez « MCP: Open User Configuration », puis ajoutez l’entrée suivante :
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

Vérification de la connexion

  1. Ouvrez la palette de commandes et exécutez « MCP: List Servers » — vérifiez que abbyy-vantage s’affiche 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 mode Agent à 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 :
« Quels paramètres l’API de traitement Vantage requiert-elle pour soumettre un document ? »
Copilot invoquera 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 pour atteindre le serveur.

​
Outils disponibles

Le serveur MCP ABBYY Vantage expose 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 Agent mode lorsque vous posez des questions liées à 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’exportation Vantage prend-il en charge ?”
  • “Comment m’authentifier auprès de l’API REST de Vantage ?”

​
Cas d’utilisation

Intégrations API

Consultez les paramètres des points 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

Dépannage

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

Découverte des capacité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 le point de terminaison de l’API dans votre question, plutôt que de poser une question générale
  • Utilisez la terminologie 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, vous pouvez donc affiner 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 à Copilot de l’expliquer à l’aide de la documentation Vantage
  • Utilisez le mode Agent : les outils MCP sont uniquement disponibles 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 à l’aide de l’une 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 (espace de travail) 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 depuis la palette de commandes). Version de VS Code trop ancienne La prise en charge de MCP nécessite VS Code 1.99 ou version ultérieure. Vérifiez votre version via Help → About 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 situé en haut du panneau Copilot Chat. Si l’outil n’est toujours pas utilisé, essayez de formuler votre question plus explicitement : « Search the ABBYY Vantage docs for… » ou mentionnez une fonctionnalité Vantage précise par son nom. La recherche renvoie des résultats non pertinents Reformulez votre requête en utilisant des termes de l’interface ou de la documentation Vantage. Évitez les termes génériques comme « workflow » ou « settings » seuls — associez-les à « Vantage » ou à un nom de fonctionnalité spécifique.

​
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 à lancer une recherche dans la documentation depuis Copilot Chat en mode Agent

​
Étapes suivantes

Introduction à l’API

Découvrez l’API REST de traitement de Vantage

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