> ## 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 d’ABBYY Vantage à Claude Code

> Ajoutez le serveur MCP d’ABBYY Vantage à Claude Code pour effectuer des recherches directement dans la documentation Vantage depuis votre assistant IA lors de la création d’intégrations et de compétences.

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

**Ce que vous allez faire :**

* Ajouter le serveur MCP ABBYY Vantage à Claude Code
* Vérifier que la connexion fonctionne
* Utiliser l’outil `SearchAbbyyVantageDocumentation` pour effectuer des recherches dans la documentation depuis votre workflow d’IA

**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 à Claude Code, 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 Claude Code est connecté à ce serveur, il peut rechercher des paramètres d’API, des options de configuration des Skills, 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>

* [Claude Code](https://claude.ai/code) installé et en cours d’exécution
* Accès au terminal (macOS, Linux ou Windows avec WSL)

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

***

<Steps>
  <Step title="Ajouter via CLI (recommandé)">
    Exécutez la commande suivante dans votre terminal pour enregistrer le serveur MCP dans Claude Code :

    ```bash theme={null}
    claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http
    ```

    **Options de portée :**

    Par défaut, cette commande ajoute le serveur au **niveau du projet**, ce qui signifie qu’il n’est disponible que dans le répertoire actuel (dans `.claude/settings.json`). Pour le rendre disponible dans tous vos projets, ajoutez l’option `--scope user` :

    ```bash theme={null}
    claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http --scope user
    ```

    | Portée              | Fichier de configuration  | Quand l’utiliser                   |
    | ------------------- | ------------------------- | ---------------------------------- |
    | Projet (par défaut) | `.claude/settings.json`   | Un projet spécifique               |
    | Utilisateur         | `~/.claude/settings.json` | Tous les projets sur cette machine |
  </Step>

  <Step title="Alternative : configuration manuelle">
    Si vous préférez effectuer la configuration manuellement, ajoutez le JSON suivant à votre fichier de paramètres.

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

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

      <Accordion title="Niveau utilisateur (~/.claude/settings.json)">
        Modifiez `~/.claude/settings.json` dans votre répertoire personnel :

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

  <Step title="Vérifier la connexion">
    Redémarrez Claude Code, puis exécutez la commande slash suivante pour vérifier que le serveur est bien enregistré :

    ```
    /mcp
    ```

    Vous devriez voir `abbyy-vantage` dans la liste, avec l’état connecté. Pour confirmer que l’outil fonctionne, posez à Claude une question sur Vantage :

    > « Quels parameters l’API de traitement Vantage requiert-elle pour soumettre un document ? »

    Claude Code appellera `SearchAbbyyVantageDocumentation` et renverra des résultats issus de la Documentation.

    <Warning>
      Si le serveur n’apparaît pas dans `/mcp`, vérifiez que l’URL a bien été saisie exactement sous la forme `https://docs.abbyy.com/mcp`, sans barre oblique finale. Vérifiez également que votre terminal 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`**

Effectue une recherche sémantique dans la documentation ABBYY Vantage et renvoie le contenu le plus pertinent. Claude Code invoque automatiquement cet outil 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 avec l’API REST de Vantage ?"

***

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

* **Intégrations API** : consultez 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 pour résoudre plus vite les problèmes lors du débogage des intégrations
* **Exploration 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 :** indiquez le nom de la fonctionnalité ou du point de terminaison API dans votre question, plutôt que de poser une question trop générale
* **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 :** Claude Code conserve le contexte, vous pouvez donc affiner les résultats avec des prompts de suivi
* **Combinez avec votre code :** collez une réponse d’API ou un extrait de configuration, puis demandez à Claude de l’expliquer à l’aide de la documentation Vantage

***

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

Pour supprimer le serveur MCP ABBYY Vantage de Claude Code, exécutez :

```bash theme={null}
claude mcp remove abbyy-vantage
```

Si vous avez ajouté le serveur au niveau utilisateur, incluez l’indicateur `--scope user` :

```bash theme={null}
claude mcp remove abbyy-vantage --scope user
```

***

<div id="troubleshooting">
  ## Résolution des problèmes
</div>

**Server n’apparaît pas dans `/mcp`**

Vérifiez que le fichier de configuration a bien été enregistré et que le JSON est valide (sans virgule finale). Redémarrez complètement Claude Code après avoir effectué les modifications.

**L’outil n’est pas appelé automatiquement**

Claude Code appelle les outils MCP en fonction de leur pertinence. Si l’outil n’est pas utilisé, essayez de formuler votre question de manière plus explicite : « Recherchez dans la documentation ABBYY Vantage... » ou mentionnez une fonctionnalité précise 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 Vantage. Évitez les termes génériques comme « workflow » ou « paramètres » pris isolément — 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 à Claude Code
* ✅ Vérifier la connexion à l’aide de `/mcp`
* ✅ Apprendre à déclencher une recherche dans la documentation depuis votre workflow d’IA

***

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

<CardGroup cols={2}>
  <Card title="Introduction à l’API" icon="plug" href="/fr/vantage/developer/api-introduction">
    Commencez à utiliser 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>
</CardGroup>