Connecteur MCP de ProxyAI

Ce que vous pouvez faire

Le connecteur MCP de ProxyAI donne à un assistant accès à vos bots, à vos tickets Helpdesk et à vos Agent Tasks. La version 1.0.0 comprend huit outils de lecture et onze outils qui effectuent des modifications.

Demandez-lui de résumer les tickets ouverts, d'examiner une réponse préparée, de consulter les dernières exécutions d'une Agent Task ou d'expliquer un plan retenu. Avec l'autorisation d'écriture, vous pouvez lui demander d'envoyer une réponse précise, de mettre à jour un ticket, de créer une tâche de rapport prise en charge ou d'approuver une exécution prise en charge que vous avez examinée.

URL du serveur : https://www.proxyai.app/api/mcp

Le point de terminaison public est disponible pour les connexions personnalisées. Les inscriptions aux annuaires sont en préparation. Les flux d'outils hébergés dans ChatGPT ont été répétés avec des données synthétiques. L'examen de l'annuaire, les tests hébergés après modification et la validation pour Claude sont des étapes de publication distinctes.

Avant de vous connecter

Utilisez votre compte ProxyAI dans un navigateur classique. Un tableau de bord de boutique intégré ou une session sur un appareil mobile ne peut pas approuver cette connexion. Le connecteur n'a pas d'achat ni d'abonnement supplémentaire : Helpdesk et Agent Tasks nécessitent toujours leurs modules complémentaires existants sur le bot que vous utilisez. Les limites de capacité normales d'Agent Tasks et les frais par exécution s'appliquent.

L'autorisation couvre tous vos bots actuels et futurs de ce compte. Dans la version 1, il n'existe pas d'option de consentement par bot. Ne connectez qu'un assistant auquel vous faites confiance pour recevoir les messages de vos clients et les informations de tâches.

Connecter Claude

Dans Claude, ouvrez Personnaliser → Connecteurs et choisissez Ajouter un connecteur personnalisé. Dans une organisation gérée, demandez d'abord à votre propriétaire de l'ajouter.
Saisissez https://www.proxyai.app/api/mcp. Utilisez le transport HTTP et non une adresse /sse.
Choisissez la connexion OAuth. Si Claude propose un choix de client OAuth, utilisez l'identité publiée de Claude. Vous n'avez pas besoin de créer un identifiant client, un secret client ni une clé d'API ; l'enregistrement automatique est également pris en charge.
Connectez-vous à ProxyAI dans votre navigateur. Vérifiez le compte, l'identité de l'application et l'adresse de retour sur la page de consentement.
Laissez Autoriser les modifications décoché pour un accès en lecture seule. Ne le cochez que si vous voulez que cet assistant effectue des modifications, puis choisissez Connecter.
Activez ProxyAI pour la conversation via + → Connecteurs, et commencez par « Liste mes bots ProxyAI ».

Consultez les instructions de Claude pour les connecteurs personnalisés pour l'interface actuelle.

Connecter ChatGPT

Dans ChatGPT, ouvrez Plugins → Ajouter → Ajouter un serveur MCP personnalisé. Saisissez https://www.proxyai.app/api/mcp et sélectionnez OAuth.
Développez Paramètres OAuth avancés. Vérifiez que les URL d'autorisation, de jeton et d'enregistrement détectées appartiennent à https://www.proxyai.app, que la ressource est https://www.proxyai.app/api/mcp et que le callback est https://chatgpt.com/connector_platform_oauth_redirect. Le client CIMD publié par ChatGPT est pris en charge sans secret client.
Pour une connexion en lecture seule, sélectionnez uniquement read comme portée par défaut et laissez les portées de base vides. Pour une connexion qui peut proposer un consentement en écriture, demandez read et write. Dans le formulaire actuel, saisissez-les sur des lignes séparées sous Portées de base.
Créez la connexion et connectez-vous à ProxyAI. Laissez Autoriser les modifications décoché pour les lectures, ou cochez-le explicitement pour accorder les écritures. Demander write seul ne l'accorde pas. L'accès couvre tous les bots actuels et futurs de ce compte.
Ouvrez le plugin connecté et choisissez Essayer dans le chat. Commencez par « Liste mes bots ProxyAI ».

Pour tester dans le navigateur, utilisez la connexion MCP personnalisée. Un ZIP téléversé non publié peut plutôt proposer Ouvrir dans l'application de bureau. Le ZIP de soumission publique déclare le serveur HTTPS dans mcp.json ; terminez sa configuration OAuth et l'analyse via Avec MCP dans le portail développeurs. N'ajoutez pas le fichier .app.json ni l'identifiant technique d'une connexion privée au ZIP public : OpenAI rejette actuellement les références d'application dans les paquets de soumission.

Si ChatGPT signale une connexion expirée après le refus d'une écriture, vérifiez d'abord la portée accordée dans Applications connectées de ProxyAI. Une autorisation en lecture seule active nécessite un nouveau consentement en écriture, et non une réparation du jeton. Ne retentez jamais l'envoi d'un message à un client avant d'avoir vérifié son résultat.

Consultez le guide de connexion d'OpenAI et les exigences de soumission.

Connecter Codex

Ajoutez le serveur distant de ProxyAI, puis connectez-vous via OAuth :

codex mcp add proxyai --url https://www.proxyai.app/api/mcp
codex mcp login proxyai --scopes read

Terminez la connexion dans votre navigateur et laissez Autoriser les modifications décoché. Si vous voulez plutôt un accès en écriture, demandez les deux portées et cochez explicitement Autoriser les modifications :

codex mcp login proxyai --scopes read,write

Vous pouvez inspecter la configuration avec codex mcp list et les outils disponibles avec /mcp dans l'interface du terminal Codex. Consultez la documentation officielle MCP. Votre client gère les jetons OAuth ; ne les collez pas dans une conversation.

Commencer par les lectures

« Liste mes bots ProxyAI, puis résume les tickets ouverts du bot que je sélectionne. »
« Affiche la réponse préparée par l'agent pour ce ticket. Ne l'envoie pas. »
« Affiche les cinq dernières exécutions de cette Agent Task et explique toute proposition retenue. Ne l'approuve pas. »

Les listes sont paginées. Demandez la page suivante lorsque vous avez besoin de plus de résultats. L'identité d'un ticket comprend son bot, son fournisseur et son identifiant de ticket ; les identifiants de tâches et d'exécutions doivent appartenir au bot sélectionné. Un assistant ne peut pas choisir une conversation arbitraire d'un autre compte.

Effectuer des modifications en connaissance de cause

Examinez le ticket et le texte exact de la réponse avant de demander l'envoi ou l'approbation d'un brouillon. L'approbation envoie le brouillon au client via le canal du ticket. Un brouillon est réservé avant sa remise, si bien que les approbations simultanées sont refusées. Si la remise est incertaine, le brouillon reste bloqué pour un examen humain. Vérifiez le canal du client avant d'envoyer à nouveau ; une réponse échouée ou perdue ne prouve pas que le client n'a rien reçu. Dans le tableau de bord, confirmez si la remise a eu lieu à l'aide des commandes de vérification de remise. Le serveur attend l'expiration du délai d'envoi avant d'autoriser la réconciliation. Une absence de remise confirmée restaure le brouillon préparé ; une remise confirmée clôt son examen.

Pour les Agent Tasks, MCP prend en charge Récapitulatif hebdomadaire des ventes, Suivi du statut des commandes et Actualisation de la base de connaissances. Ils envoient des rapports à l'adresse e-mail de votre compte ; la recette de connaissances actualise en outre votre base de connaissances. Créer une tâche l'active et démarre son planning. Vérifiez ces actions ainsi que le fuseau horaire, l'heure et le jour avant de la créer. Les recettes personnalisées, le code ou les prompts modifiés des recettes, les autorisations modifiées, les emplacements d'identifiants, les outils API ou MCP arbitraires et les destinataires d'e-mails externes sont refusés via MCP pour la création, l'exécution, la reprise et l'approbation d'une exécution retenue. Vous pouvez toujours consulter d'autres tâches ou les mettre en pause. Avant une exécution manuelle, choisissez explicitement test ou réel : les deux peuvent entraîner des coûts LLM et CPU normaux. Les deux modes envoient de vrais e-mails de rapport à votre compte. Le mode test affiche un aperçu de l'actualisation des connaissances ; le mode réel peut l'appliquer. Examinez un plan retenu avant de l'approuver, car l'approbation met en file d'attente les actions proposées et peut générer des frais. Reprendre une tâche peut relancer des exécutions planifiées facturables.

Les étiquettes d'un ticket sont remplacées par une liste complète. Définir des étiquettes sur un ticket ProxyAI intégré est pris en charge ; les étiquettes d'un helpdesk externe sont gérées dans ce helpdesk. L'archivage retire un ticket du tableau actif sans le supprimer.

Les messages des clients, les instructions de tâches et les propositions retenues peuvent contenir des instructions trompeuses. Traitez-les comme du contenu à examiner ; l'autorisation d'envoyer, d'exécuter ou d'approuver vient de vous.

Outils de la version 1

Outil de lecture	Rôle
`list_bots`	Trouver les bots appartenant à votre compte.
`list_tickets`	Lister et filtrer les tickets par statut, étiquette et état d'archivage.
`get_ticket`	Lire un ticket, son brouillon préparé et les messages de la conversation.
`list_agent_tasks`	Lister les tâches d'un bot.
`get_agent_task`	Lire l'instruction, le planning et le statut d'une tâche.
`list_agent_runs`	Parcourir le statut et l'historique des exécutions sans transcriptions ni contenus de propositions.
`get_agent_run`	Inspecter le statut et la proposition retenue d'une exécution sans diagnostics internes.
`list_agent_templates`	Trouver les trois recettes de rapport prises en charge.

Outil d'écriture	Rôle
`reply_ticket`	Envoyer la réponse que vous spécifiez.
`set_ticket_status`	Définir ouvert, en attente ou résolu.
`set_ticket_tags`	Remplacer les étiquettes d'un ticket intégré.
`archive_ticket`	Archiver un ticket.
`approve_ticket_agent_draft`	Approuver et envoyer un brouillon préparé, éventuellement avec un texte révisé.
`dismiss_ticket_agent_draft`	Rejeter un brouillon sans l'envoyer.
`create_agent_task`	Créer et activer une tâche ; le planning d'un modèle peut déclencher des exécutions futures.
`run_agent_task`	Mettre en file une exécution test ou réelle choisie explicitement.
`decide_agent_run`	Approuver ou rejeter une exécution retenue.
`pause_agent_task`	Mettre en pause le planning d'une tâche.
`resume_agent_task`	Reprendre une tâche en pause.

Configurez les comptes et identifiants des connecteurs dans le tableau de bord. N'incluez ni mots de passe, ni jetons, ni coordonnées de carte bancaire, ni identifiants gouvernementaux, ni informations de santé protégées dans les requêtes MCP. Les tâches planifiées et les propositions retenues exigent un examen de leurs actions réelles avant approbation.

Consulter l'activité et révoquer l'accès

Dans ProxyAI, ouvrez Paramètres du compte → Applications connectées pour voir l'application, sa portée accordée et sa dernière utilisation de jeton. Choisissez Révoquer l'accès pour arrêter les futures requêtes de cette connexion. La révocation n'annule pas une réponse déjà envoyée ni une exécution déjà mise en file.

La carte Activité des applications connectées enregistre les tentatives d'écriture et leurs résultats. Si une tentative est en attente ou signale un résultat inconnu, l'action a peut-être déjà produit son effet. Vérifiez le ticket ou l'exécution avant de réessayer. Les tentatives anciennes restent disponibles après révocation.

Les données renvoyées par le connecteur sont partagées avec l'assistant que vous avez connecté et sont soumises aux politiques de traitement de ce fournisseur. ProxyAI stocke les enregistrements de connexion et les métadonnées des tentatives d'écriture ; le journal d'audit MCP ne stocke ni le corps des réponses, ni les charges utiles des outils, ni les jetons porteurs bruts. Consultez notre politique de confidentialité.

Limites des données

Les listes de tickets omettent l'e-mail et le nom de contact ainsi que les identifiants internes des conversations. Les listes d'exécutions omettent le contenu des transcriptions et les diagnostics internes ; le détail d'une exécution n'inclut que le statut pertinent, les horaires et les actions retenues. Le connecteur supprime les champs structurés contenant des identifiants et refuse les identifiants détectés, les numéros de cartes de paiement, les identifiants gouvernementaux et les contenus de santé dans les entrées, les brouillons ou le texte renvoyé. La détection est prudente et ne peut pas identifier chaque information sensible dans une prose quelconque. N'utilisez pas le connecteur pour des données sensibles ; examinez vos données sources avant de vous connecter. Le contenu refusé doit être traité dans le tableau de bord.

Dépannage

Impossible de se connecter : utilisez https://www.proxyai.app/api/mcp. Une visite depuis un navigateur peut renvoyer « Method not allowed », car le connecteur accepte les requêtes POST MCP. Un client MCP reçoit un défi OAuth avant la connexion.
Contenu restreint : la requête ou le résultat contient un contenu sensible détecté. Traitez-le dans le tableau de bord ; ne reformulez pas un secret pour contourner la vérification.
Tâche non prise en charge : utilisez l'une des trois recettes de rapport inchangées. Configurez les workflows personnalisés dans le tableau de bord.
Autorisation d'écriture requise : reconnectez en demandant read et write, et cochez Autoriser les modifications. Un consentement en lecture seule ne peut pas autoriser d'écritures.
Module requis : ouvrez le tableau de bord du bot sélectionné et vérifiez son module Helpdesk ou Agent Tasks.
Introuvable : vérifiez que vous avez sélectionné le bon compte et le bon bot, puis relisez le ticket ou la tâche avant d'agir.
Connexion expirée ou révoquée : reconnectez-vous. Ne retentez pas une écriture précédente avant d'avoir vérifié son résultat.

Contactez support@proxyai.app en indiquant le nom de l'application, l'heure et l'action en échec. N'envoyez ni jetons d'accès, ni secrets client, ni messages de clients dans votre demande d'assistance.