Connectez un assistant IA compatible MCP à Perk pour pouvoir poser des questions en langage naturel sur les données de voyage, de dépenses, de facturation et d'événements de votre entreprise. Cet article vous explique comment ajouter le connecteur MCP Perk à votre assistant et vous connecter avec vos identifiants Perk.

Perk MCP fonctionne avec Utilisez Claude et ChatGPT comme assistants IA via l'interface de chat native, ou Gemini, VS Code et Cursor via la ligne de commande. Quel que soit l'assistant choisi, ajoutez la même URL de serveur Perk MCP et connectez-vous avec vos identifiants Perk. Sélectionnez votre assistant ci-dessous.

Remarque : Le MCP de Perk est un serveur distant. Utilisez la même URL partout : https://mcp.perk.com/api/mcp/mcpLes noms des menus de chaque assistant peuvent changer au fil du temps. Si une étape vous semble différente, consultez la documentation MCP de votre assistant.

Connectez Claude à Perk

Ajouter Perk comme connecteur personnalisé dans Claude.

1. Dans Claude, accédez à Personnaliser > Connecteurs.
2. Recherchez Perk et cliquez sur Connecter.
3. Si vous n'êtes pas déjà connecté à Perk, le système vous invite à le faire car le MCP Perk utilise vos identifiants Perk existants via OAuth.
4. Dans la fenêtre d'autorisation Perk, cliquez sur Autoriser l'application.

Si vous n'êtes pas déjà connecté, vous devrez peut-être cliquer sur Se connecter à nouveau sur la page Connecteurs après s'être connecté à Perk.

Connectez ChatGPT à Perk

ChatGPT se connecte à Perk via le mode développeur, où un administrateur crée et publie une application MCP personnalisée. La version complète de MCP est disponible sur ChatGPT Business, Enterprise et Edu ; les utilisateurs Pro peuvent s'y connecter en lecture et en récupération.

Attention : Seuls l'administrateur ou le propriétaire de l'espace de travail peuvent activer le mode développeur et publier l'application. Les MCP personnalisés ne peuvent être utilisés que sur la version web de ChatGPT, et non sur mobile.

1. Un administrateur active le mode développeur dans Paramètres > Applications > Paramètres avancés.
2. Dans les paramètres de l'espace de travail, allez dans Applications > Créer.
3. Saisissez l'URL du serveur Perk MCP : https://mcp.perk.com/api/mcp/mcp avec les informations requises, et choisissez OAuth pour l'authentification.
4. Cliquez sur Outils de numérisationConnectez-vous ensuite avec votre compte Perk lorsque vous y êtes invité et attendez que l'analyse soit terminée.
5. Cliquez sur Créer pour enregistrer l'application en tant que brouillon.
6. Un administrateur ou un propriétaire publie l'application depuis Paramètres de l'espace de travail > Applications > Brouillons.

Connectez Gemini à Perk

Connectez Perk à Gemini via l'interface de ligne de commande Gemini en ajoutant le serveur Perk MCP à votre fichier de paramètres.

1. Ouvrez ou créez le fichier ~/.gemini/settings.json.

2. Ajouter un avantage sous mcpServers:

   {
     "mcpServers": {
       "perk": {
         "httpUrl": ""
       }
     }
   }
   

3. Redémarrez l'interface de ligne de commande Gemini.
4. Connectez-vous avec votre compte Perk lorsque vous y êtes invité.

Connectez VS Code à Perk

Ajoutez un avantage à VS Code depuis la ligne de commande avec la commande ` --add-mcp`. commande.

1. Dans votre terminal, exécutez :

   code --add-mcp "{\"name\":\"perk\",\"type\":\"http\",\"url\":\"

2. Rechargez VS Code si vous y êtes invité.
3. Connectez-vous avec votre compte Perk lorsque vous y êtes invité.

Conseil : Vous avez besoin du code Commande disponible dans votre terminal — dans VS Code, exécutez Commande Shell : Installez la commande « code » dans le PATH Tout d'abord, depuis la palette de commandes.

Connecter le curseur à Perk

Ajoutez l'avantage aux paramètres MCP de Cursor. Utilisez ~/.cursor/mcp.json pour rendre Perk disponible dans chaque projet, ou .cursor/mcp.json dans un dossier de projet pour limiter sa portée à ce projet.

1. Ouvrez ou créez ~/.cursor/mcp.json.

2. Ajouter Perk sous mcpServers:

   {
    "mcpServers": {
    "avantage" : {
    "url": ""
    }
    }
   }
   

3. Rechargez le curseur, puis ouvrez Paramètres > MCP et vérifiez que Perk est connecté.
4. Connectez-vous avec votre compte Perk lorsque vous y êtes invité.

Se connecter depuis la ligne de commande

Les agents de codage exécutés dans le terminal peuvent ajouter des avantages en une seule commande. Les exemples ci-dessous concernent Claude Code et Codex.

Pour Claude Code :

claude mcp ajouter --transport http perk 

Pour le Codex :

codex mcp ajouter l'avantage --url 

Une fois le serveur ajouté, démarrez une session et connectez-vous avec votre compte Perk lorsque vous y êtes invité.

Autoriser le téléchargement des rapports

Perk MCP fournit les rapports de voyage et de dépenses sous forme de lien de téléchargement pré-signé. Votre assistant récupère ensuite le fichier depuis le stockage cloud de Perk. Pour que les téléchargements fonctionnent, le propriétaire du compte de votre assistant IA doit autoriser ce dernier à accéder aux domaines suivants :

• https://tk-prod-custom-report-download.s3.amazonaws.com — récits de voyage
• http://storage.googleapis.com — rapports de dépenses

Si ces domaines ne figurent pas sur la liste blanche de votre assistant, un rapport peut être généré, mais le téléchargement ne s'ouvrira pas.

Choses à savoir

Gardez les points suivants à l'esprit après avoir connecté votre assistant à Perk :

• Vous pouvez consulter les données relatives aux voyages et aux dépenses et générer des rapports, mais vous ne pouvez ni réserver, ni modifier, ni envoyer quoi que ce soit par l'intermédiaire de votre assistant.
• Vos données sont limitées à votre rôle Perk et aux modules de votre entreprise. Vous ne voyez que les données déjà accessibles dans Perk.
• Les actions d'écriture, telles que la réservation et l'envoi de notes de frais, seront bientôt disponibles dans une prochaine version.

Remarque : Vous vous authentifiez avec vos identifiants Perk existants via OAuth. L'assistant agit dans le cadre de vos autorisations existantes et ne peut accéder à aucune donnée qui ne soit pas déjà visible dans Perk.

Où aller ensuite

Votre assistant est maintenant connecté. Essayez une première invite. Pour plus d'informations, consultez Posez votre première question à PerkSi votre assistant ne parvient pas à se connecter ou si vous constatez moins de données que prévu, consultez Dépannage de Perk MCP.