> ## Documentation Index > Fetch the complete documentation index at: https://docs.alterhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Connecter un agent IA avec Remote MCP > Utilisez Alter comme serveur MCP distant pour les réunions, actions enregistrées et conversations sur votre Mac MCP Gateway permet à un agent IA compatible d'appeler les outils d'Alter via une URL HTTPS privée. Utilisez-le pour rechercher des réunions, lire des transcriptions, lancer les actions enregistrées autorisées et démarrer ou poursuivre des conversations Alter. Alter exécute les outils sur votre Mac. Un relais Alter connecte votre agent IA à l'application ouverte. Vous n'avez pas besoin d'exposer un port sur votre Mac ni de lancer une commande MCP locale distincte. > [!TIP] > > Vous utilisez ChatGPT pour ordinateur ? Suivez [Utiliser Alter dans ChatGPT](/fr/apps-tools/gateways-chatgpt.md) pour installer le plugin. Ce guide présente la connexion Remote MCP pour les agents compatibles. ## Avant de commencer * Connectez-vous à Alter sur votre Mac. * Utilisez un agent IA qui permet d'ajouter l'URL d'un **serveur MCP HTTPS distant**. Un client qui n'accepte qu'une commande locale ne peut pas utiliser directement cette URL. * Gardez votre Mac connecté à Internet et Alter ouvert pendant l'utilisation. > [!NOTE] > > ChatGPT est la première intégration testée. La compatibilité des autres clients avec le point de terminaison Remote MCP d'Alter n'a pas encore été vérifiée de bout en bout. La prise en charge des outils et des abonnements aux événements peut varier dans un même client. ## Activer MCP Gateway **1. Ouvrir Gateways dans Alter** Appuyez sur **⌘,** pour ouvrir **Settings**, puis sélectionnez **Gateways** sous **Integrations**. Choisissez **Add gateway → MCP Gateway**, ou ouvrez une MCP Gateway existante. **2. Choisir les accès et enregistrer** Activez **Enabled**. Sous **Allowed access**, activez les fonctionnalités que l'agent peut utiliser. Pour un test de lecture seule des réunions, activez **Read meeting transcripts**. Choisissez **Save and restart**, puis attendez que la connexion soit prête. ![Réglages MCP Gateway d'Alter avec Enabled activé et les commandes de connexion](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-connection.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=4b8b77cf9de2094d96a8b0b3cdfad0f9) Activez MCP Gateway et enregistrez la connexion avant de l'ajouter à votre agent IA. **3. Copier l'URL de connexion** Choisissez **Copy connection URL** dans la section **Connection**. Il s'agit de votre point de terminaison Remote MCP privé. Gardez l'URL complète confidentielle, y compris la clé à la fin. ## Ajouter Alter à votre agent IA Ouvrez les réglages MCP ou intégrations de votre agent et ajoutez un serveur distant avec ces valeurs : | Champ | Valeur | | - | - | | Nom | **Alter** | | Server URL | Collez l'URL complète obtenue avec **Copy connection URL**. | | Authentication | **No authentication**, ou l'équivalent de votre client. L'accès est déjà inclus dans l'URL privée. | Enregistrez la connexion, puis actualisez ou recherchez ses outils. Les libellés exacts dépendent du client. Vous n'avez pas besoin d'une clé API supplémentaire ni d'une connexion OAuth pour cette connexion. Commencez par une demande en lecture seule : > Liste mes réunions récentes dans Alter. Votre agent peut vous demander d'approuver l'appel d'un outil. Si aucune réunion n'apparaît, vérifiez que des réunions sont enregistrées dans Alter et que l'accès aux transcriptions est activé. ## Choisir les accès autorisés ![Section Allowed access de MCP Gateway d'Alter avec les options réunion, action, chat et historique](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-access.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=ed9df89e68ddf7d65d5debac27cbffec) Activez uniquement les fonctionnalités que l'agent connecté doit pouvoir utiliser. | Réglage | Outils et comportement | | - | - | | **Read meeting transcripts** | `list_meetings`, `search_meetings` et `get_meeting_transcript` listent et recherchent les réunions enregistrées, puis lisent une transcription sélectionnée. | | **Run saved actions** | `list_actions` et `run_action` découvrent et lancent les actions enregistrées autorisées pour cette gateway. | | **Chat with Alter** | `create_conversation` et `send_message` démarrent et poursuivent des conversations avec les actions autorisées. | | **Read conversation history** | `list_conversations`, `search_conversations` et `get_conversation` recherchent et lisent les conversations dont les actions sont autorisées pour cette gateway. | | **Notify when transcripts are ready** | Autorise les événements de transcription prête pour les clients pris en charge ayant un abonnement actif. Consultez [Prise en charge des événements](#prise-en-charge-des-événements) pour connaître les restrictions actuelles. | Les fonctionnalités désactivées sont retirées des outils disponibles et ne peuvent pas être utilisées par appel direct. Après avoir modifié les accès, choisissez **Save and restart**, puis actualisez les outils de l'agent. Le redémarrage de la gateway annule les tâches actives qui l'utilisent. ### Action par défaut et actions enregistrées Sous **Behavior**, choisissez la **Default action** des nouveaux chats. **Ask Anything** est généralement l'action par défaut. Pour utiliser une autre action enregistrée, ouvrez **Action Editor → Gateways** et activez **MCP Gateway** ou **All**. La liste **Available actions** de la gateway indique les actions autorisées. L'agent a également besoin de l'accès **Run saved actions** pour les découvrir et les lancer. Les nouvelles conversations **Ask Anything** utilisent votre espace de travail Alter par défaut. Les autres actions utilisent l'espace de travail qui leur est configuré. La poursuite d'une conversation conserve son espace de travail et ses autorisations d'action. ## Exemples de demandes | Objectif | Exemple | | - | - | | Trouver une réunion par sujet | « Recherche dans mes réunions Alter les discussions sur les tarifs et résume les résultats correspondants. » | | Examiner les réunions récentes | « Liste mes réunions récentes dans Alter, puis lis la transcription la plus récente. » | | Découvrir les actions enregistrées | « Quelles actions Alter peux-tu lancer via cette connexion ? » | | Démarrer un chat Alter | « Demande à Alter d'examiner les fichiers récents de son espace de travail actuel sans les modifier. » | | Rechercher des conversations précédentes | « Retrouve mes anciennes conversations Alter sur l'intégration des nouveaux employés. » | La recherche des réunions porte sur les termes du contenu indexé. La recherche des conversations porte sur les titres et messages indexés. Demandez à l'agent de lire la transcription ou la conversation correspondante pour obtenir plus de détails. ### Questions et autorisations Les chats et les actions peuvent renvoyer un identifiant de tâche pendant qu'Alter travaille. L'agent utilise `get_task` pour récupérer le résultat et peut utiliser `cancel_task` pour arrêter une tâche en cours. Une tâche Alter peut s'interrompre pour poser une question ou demander l'accès à un fichier. Votre agent doit afficher la question et les choix, attendre votre réponse et la transmettre à Alter avant de continuer. Les choix d'autorisation peuvent inclure **Allow once**, **Always allow**, ou le refus d'accès. La connexion n'approuve pas automatiquement ces demandes. Si l'agent attend sans afficher de question, demandez-lui d'examiner la question en attente de la tâche et d'utiliser l'outil `answer_questions` après votre réponse. ## Prise en charge des événements L'accès aux outils distants ne crée pas automatiquement un abonnement aux événements. La prise en charge dépend également de l'agent IA et du mode sélectionné. Alter accepte actuellement les destinations webhook de transcription prête uniquement sur les domaines ChatGPT/OpenAI. Les autres agents MCP peuvent utiliser les outils compatibles, mais les destinations d'événement tierces arbitraires ne sont pas prises en charge. Consultez [Notifications de réunions dans ChatGPT](/fr/apps-tools/gateways-chatgpt.md#recevoir-les-notifications-de-nouvelles-réunions) pour la configuration d'abonnement prise en charge. ## Confidentialité et disponibilité L'URL de connexion accorde les accès activés pour cette gateway. Traitez-la comme un mot de passe et enregistrez-la uniquement dans des clients de confiance. Les outils s'exécutent dans Alter sur votre Mac. Les demandes et résultats transitent par le relais d'Alter, y compris le texte des transcriptions lorsque l'agent en fait la demande. Vos réunions et conversations enregistrées restent dans Alter ; l'agent connecté reçoit les données renvoyées par les appels autorisés. Gardez Alter ouvert et votre Mac connecté à Internet. La désactivation de la gateway interrompt l'accès et annule ses tâches actives. La suppression puis la recréation de la gateway génère une nouvelle URL de connexion ; remplacez l'ancienne dans chaque client connecté. ## Dépannage | Symptôme | Vérification | | - | - | | Le client ne propose qu'un champ de commande ou d'exécutable | Choisissez un client ou un type de connexion qui prend en charge l'URL d'un serveur MCP HTTPS distant. | | Le serveur ne se connecte pas | Vérifiez qu'Alter est ouvert et que MCP Gateway est activé et connecté. Essayez **Reconnect** dans la section **Connection** d'Alter, puis actualisez le client. La reconnexion annule les tâches actives de la gateway. | | Des outils manquent | Activez l'option correspondante dans **Allowed access**, enregistrez, puis actualisez la liste d'outils de l'agent. Pour les actions, vérifiez aussi **Action Editor → Gateways**. | | Une tâche attend une réponse | Vérifiez si Alter attend une réponse explicite ou une décision d'accès à un fichier. | | Les outils fonctionnent, mais pas les événements | Vérifiez le client et le mode. Les destinations d'événement sont limitées aux domaines ChatGPT/OpenAI et exigent un abonnement actif. | | L'accès s'est interrompu après un changement de compte Alter ou la recréation d'une gateway | Copiez l'URL de connexion actuelle et remplacez-la dans votre agent. | ## Pages connexes * [Utiliser Alter dans ChatGPT](/fr/apps-tools/gateways-chatgpt.md) * [Vue d'ensemble des Gateways](/fr/apps-tools/gateways.md) * [Alter Actions](/fr/workflows/alter-actions.md) * [Données locales et confidentialité](/fr/references/local-data-and-privacy.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.