Français (France) Čeština Deutsch English (United States) Español (España) Italiano 日本語

Afficher plus

Présentation et configuration de l'API et du MCP Scout

Qui est concerné par cet article ?

  • Comptes d'entreprises, partenaires, et petites entreprises.
  • Comptes dans tous les pays.

Vue d'ensemble

Scout vous donne accès à l'intelligence de visibilité via deux modèles de diffusion complémentaires, en plus de l'interface utilisateur : une API et un MCP.

L'API Scout fournit des points de terminaison HTTP structurés qui renvoient les données de visibilité Scout. Utilisez-la lorsque vous souhaitez intégrer directement les données Scout dans votre propre produit : pour alimenter des tableaux de bord personnalisés, automatiser des exportations vers un entrepôt de données ou un CRM, créer des rapports en marque blanche, ou déclencher des workflows de recommandations basés sur des signaux de visibilité.

Le MCP Scout supprime la charge de développement en vous permettant de connecter les données Scout à Claude ou OpenAI et de poser des questions en langage courant. Utilisez-le lorsque l'objectif est l'exploration rapide, les synthèses à la demande ou la génération de vues personnalisées sans écrire de code. Le MCP est disponible dans OpenAI, Claude, Perplexity, Gemini et Copilot. 

L'API Scout et le MCP sont tous deux en lecture seule pour les données Scout. Aucun des deux ne permet de déclencher des scans, de mettre à jour des mots-clés ou d'effectuer d'autres actions d'écriture dans Scout. Pour les fonctionnalités d'écriture, utilisez le MCP Yext plus large (dont fait partie le MCP Scout) ou l'API Yext Management, qui prennent tous deux en charge des actions comme la mise à jour des listings, la réponse aux avis et la gestion d'autres fonctionnalités Yext.

Avertissement : validez avant de partager

Le MCP Scout récupère les données depuis de véritables points de terminaison, mais les modèles d'IA peuvent produire du contenu qui semble sûr de lui sans être exact. Avant de partager quoi que ce soit avec une partie prenante, appliquez-lui le même niveau d'exigence que vous appliqueriez à toute analyse portant votre nom.

Vérifiez chaque chiffre, date et entité nommée dans l'API ou l'interface Scout, et sachez où s'arrête la couverture de Scout. Les prompts qui sortent du jeu d'indicateurs pris en charge peuvent renvoyer des réponses inventées. Au-delà des chiffres, vérifiez que le récit correspond réellement au client. Les modes d'échec courants ne sont pas toujours évidents : chiffres inversés, mauvais concurrent, indicateur obsolète, citation inventée.

Aucun contenu généré par le MCP ne doit être transmis à un client sans une deuxième vérification. La personne qui présente les informations est responsable de leur exactitude, pas le modèle.

Comment l'API et le MCP fonctionnent ensemble 

Le MCP Scout et l'API s'appuient sur les mêmes données sous-jacentes. La différence réside dans la manière dont vous y accédez.

L'API Scout vous offre un accès structuré et programmatique, afin que vous puissiez contrôler la façon dont les données sont présentées et connectées à la logique de votre produit. Le MCP Scout vous donne un accès en langage naturel via un LLM, sans développement requis.

En pratique, de nombreux partenaires et clients utilisent les deux : le MCP pour l'exploration rapide et la création d'interfaces personnalisées, et l'API pour les produits intégrés et évolutifs.

Comment obtenir l'accès

Les instructions dépendront du modèle que vous utilisez. Consultez la section correspondante ci-dessous pour connaître les étapes de connexion avec chaque fournisseur.

Vous pouvez accéder à la documentation de l'API Scout directement depuis votre compte en cliquant sur l'icône des paramètres en haut à droite de n'importe quelle page Scout, puis sur Afficher la référence API. 

Vous pouvez également accéder directement à la documentation de l'API en consultant les liens suivants :

Remarque : vous devez être connecté(e) à votre compte pour accéder à cette documentation.

 

Claude

Ce dont vous aurez besoin : 

  • Identifiants de connexion à votre compte Yext 
  • Accès à Claude avec les permissions suffisantes pour ajouter un connecteur personnalisé. Consultez la documentation Ajouter un connecteur personnalisé de Claude pour plus d'informations sur les permissions requises.

Comment se connecter au MCP Yext

  1. Dans Claude, trouvez l'option Ajouter un connecteur personnalisé et cliquez dessus. Cette option se trouve généralement dans la section Connecteurs du menu Paramètres.
  2. Saisissez un nom et l'URL du serveur MCP distant.
  1. Cliquez sur Ajouter.
  2. Après avoir ajouté l'URL, cliquez sur Connecter. Claude vous invitera à vous connecter à Yext.
  3. Connectez-vous à votre compte Yext avec vos identifiants. 
  4. Vous devrez autoriser la connexion avec un accès en lecture/écriture au MCP Scout. Cliquez sur Autoriser.
  5. Vous serez redirigé(e) vers Claude après l'autorisation, et la connexion sera alors active.
  6. Cliquez sur le connecteur personnalisé MCP Yext dans la barre latérale pour afficher la liste complète des outils MCP Scout disponibles.

Et voilà ! Vous pouvez maintenant utiliser ces outils directement dans vos conversations Claude pour accéder à vos données Yext.

OpenAI

Ce dont vous aurez besoin : 

  • Identifiants de connexion à votre compte Yext 
  • Accès à OpenAI avec les permissions suffisantes pour ajouter une application personnalisée

Comment connecter le MCP Scout à OpenAI

  1. Dans ChatGPT, accédez à la page Paramètres, puis cliquez sur Applications.
  2. Cliquez sur Paramètres avancés.

  1. Activez le Mode Développeur. Cliquez ensuite sur Créer une appli.

  1. Saisissez les détails de l'application.
  • Nom : nous recommandons d'utiliser MCP Yext comme nom de connecteur.
  • Connexion : assurez-vous que Server URL est sélectionné (c'est l'option par défaut) puis saisissez https://api.yext.com/mcp pour les comptes dont la région source est les États-Unis, ou https://api.eu.yextapis.com/mcp pour les comptes dont la région source est l'Europe.
  • Authentification : sélectionnez OAuth.
  1. Cochez la case pour confirmer la connexion à un serveur MCP personnalisé. 
  2. Cliquez sur Créer.

  1. Il vous sera demandé de vous connecter à Yext pour autoriser la connexion au MCP Scout. Cliquez sur Se connecter. Cliquez ensuite sur Autoriser après vous être connecté(e) à votre compte Yext. Une fois la connexion autorisée, vous serez redirigé(e) vers votre liste d'applications.

Et voilà ! Vous pouvez maintenant utiliser ces outils directement dans vos conversations ChatGPT pour accéder à vos données Yext.

 

CoPilot

Les instructions officielles seront bientôt disponibles. En attendant, vous pouvez consulter l'article expliquant comment connecter votre agent à un serveur MCP (Model Context Protocol) existant sur le site d'aide Microsoft Copilot et utiliser l'URL OAuth https://api.yext.com/mcp pour les comptes dont la région source est les États-Unis, ou https://api.eu.yextapis.com/mcp pour les comptes dont la région source est l'Europe, afin de commencer.