> ## 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 ABBYY 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 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.

<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 de MCP requise)
* extension [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) installée, avec connexion au compte effectuée

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

***

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

    | 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 effectuer la configuration manuellement, ajoutez l’entrée du serveur 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 de l’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é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.

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

***

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

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

***

<div id="use-cases">
  ## Cas d’usage
</div>

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

***

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

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

***

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

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.

***

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

***

<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 à déclencher 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 comment démarrer avec l'API REST Vantage Processing
  </Card>

  <Card title="Traitement des documents" icon="file-lines" href="/fr/vantage/documentation/skills/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/documentation/skills/connections">
    Connectez Vantage à OpenAI ou Microsoft Foundry
  </Card>

  <Card title="Extraction basée sur des prompts" icon="wand-magic-sparkles" href="/fr/vantage/documentation/skills/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/developer/mcp-server">
    Ajoutez le même serveur MCP à Claude Code
  </Card>
</CardGroup>