> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ajouter le serveur MCP Vantage à GitHub Copilot

> Connectez le serveur MCP ABBYY Vantage à GitHub Copilot dans VS Code pour effectuer instantanément des recherches dans la documentation lors du développement d’intégrations Vantage.

<div id="overview">
  ## Vue d’ensemble
</div>

**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

***

<div id="what-is-the-mcp-server">
  ## Qu’est-ce que le serveur MCP ?
</div>

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.

<Note>
  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.
</Note>

***

<div id="prerequisites">
  ## Prérequis
</div>

* [VS Code](https://code.visualstudio.com/) version **1.99 ou ultérieure** (prise en charge MCP requise)
* Extension [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) installée et connectée

<Note>
  Aucun tenant ni compte ABBYY Vantage n'est requis pour utiliser le serveur MCP.
</Note>

***

<Steps>
  <Step title="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ée    | Emplacement de la configuration                    | Quand l'utiliser                   |
    | --------- | -------------------------------------------------- | ---------------------------------- |
    | Workspace | `.vscode/mcp.json`                                 | Un projet spécifique               |
    | User      | Paramètres utilisateur via la palette de commandes | Tous les projets sur cette machine |
  </Step>

  <Step title="Alternative : configuration manuelle">
    Si vous préférez configurer le serveur manuellement, ajoutez son entrée dans le fichier de configuration approprié.

    <AccordionGroup>
      <Accordion title="Workspace (.vscode/mcp.json)">
        Créez ou modifiez `.vscode/mcp.json` à la racine de votre projet :

        ```json theme={null}
        {
          "servers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>

      <Accordion title="Paramètres au niveau utilisateur">
        Ouvrez la palette de commandes (**Cmd+Shift+P** / **Ctrl+Shift+P**), saisissez **« MCP: Open User Configuration »**, puis ajoutez l'entrée suivante :

        ```json theme={null}
        {
          "servers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="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.

    <Warning>
      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.
    </Warning>
  </Step>
</Steps>

***

<div id="available-tools">
  ## Outils disponibles
</div>

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 ?"

***

<div id="use-cases">
  ## Cas d'utilisation
</div>

* **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 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 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

***

<div id="tips-for-effective-queries">
  ## Conseils pour formuler des requêtes efficaces
</div>

* **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

***

<div id="removing-the-mcp-server">
  ## Suppression du serveur MCP
</div>

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.

***

<div id="troubleshooting">
  ## Dépannage
</div>

**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.

***

<div id="summary">
  ## Résumé
</div>

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

***

<div id="next-steps">
  ## Étapes suivantes
</div>

<CardGroup cols={2}>
  <Card title="Introduction à l’API" icon="plug" href="/fr/vantage/developer/api-introduction">
    Découvrez l’API REST de traitement de Vantage
  </Card>

  <Card title="Traitement des documents" icon="file-lines" href="/fr/vantage/how-to/process-skill">
    Créez une Compétence de processus et automatisez le traitement des documents via SFTP
  </Card>

  <Card title="Configuration des connexions LLM" icon="brain" href="/fr/vantage/how-to/connections">
    Connectez Vantage à OpenAI ou à Microsoft Foundry
  </Card>

  <Card title="Extraction basée sur des prompts" icon="wand-magic-sparkles" href="/fr/vantage/how-to/prompt-extraction">
    Utilisez des prompts en langage naturel pour extraire des données de documents
  </Card>

  <Card title="Serveur MCP pour Claude Code" icon="terminal" href="/fr/vantage/how-to/mcp-server">
    Ajoutez le même serveur MCP à Claude Code
  </Card>
</CardGroup>