--- title: "Travailler avec le Serveur MCP d'Origine de la connexion de Cato" slug: "working-with-the-cato-remote-mcp-server" updated: 2026-11-10T00:13:18Z published: 2026-11-10T00:13:18Z canonical: "knowledge.catonetworks.com/working-with-the-cato-remote-mcp-server" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Travailler avec le Serveur MCP d'Origine de la connexion de Cato ## Aperçu Le serveur MCP distant fournit un accès aux données historiques pendant la [période de rétention](https://knowledge.catonetworks.com/docs/guide-to-cato-data-lake) de votre compte. Par exemple, un compte avec trois mois de rétention peut interroger trois mois de données. Vous pouvez vous authentifier avec une clé API ou vous connecter avec les identifiants Cato Admin en utilisant OAuth. L'accès aux données et aux actions respecte les autorisations de la clé API ou de l'Admin Cato authentifié. Pour des informations sur les autorisations, voir [Gérer les rôles d'admin à l'aide de RBAC](https://knowledge.catonetworks.com/docs/managing-admin-roles-using-rbac). Vous pouvez examiner les événements pour les appels d'outils Cato MCP afin d'identifier l'outil invoqué, le client MCP connecté et la clé API ou l'Admin Cato utilisée pour l'authentification. Pour plus d'informations, voir [Audit des appels d'outils Cato MCP](/v1/docs/working-with-the-cato-remote-mcp-server#auditing-cato-mcp-tool-calls). ### Exemples de Cas d'Utilisation #### Investigation des Menaces Assistée par AI Un analyste demande : Enquêter sur cette IP et résumer les événements de sécurité associés. Le client MCP : 1. Appelle l'outil d'Événements de Sécurité 2. Récupère les données structurées pertinentes 3. Retourne les résultats au LLM 4. Le LLM résume les conclusions #### Enrichissement Automatisé des Incidents XOps Lorsqu'une histoire XOps est générée, l'agent IA récupère : les flux associés, la réputation des cibles, et l'historique des utilisateurs. L'agent répond ensuite avec : - Un rapport contextuel - Actions de mitigation suggérées #### Dépannage Réseau Piloté par AI Cet exemple démontre comment, en utilisant le serveur MCP de Cato, l'IA effectue des requêtes structurées et inter-domaines sur les métriques réseau et applicatives. Cela remplace la navigation manuelle dans de multiples tableaux de bord du CMA. Un administrateur signale que les utilisateurs du site de Londres rencontrent un accès lent à Microsoft 365. 1. En utilisant l'Origine de la connexion MCP, l'agent IA interroge : 1. Métriques des Opérations de Site 2. Santé du lien WAN 3. Statistiques de perte de paquets et de latence 4. Métriques de performance des applications 2. Il détecte : 1. Augmentation de la perte de paquets sur le lien WAN principal 2. SLA dégradé pour la classe de trafic M365 3. Il corrèle : 1. Dégradation de qualité du lien 2. Saturation de la bande passante pendant les heures de pointe 4. Il recommande : 1. Passage au lien secondaire 2. Ajustement de la priorité QoS 3. Investigation de la performance de l'ISP ### Pré-requis - Un client compatible MCP connecté à votre LLM. - Pour l'authentification de la clé API : une [clé API Cato](https://knowledge.catonetworks.com/docs/generating-api-keys-for-the-cato-api) valide. - Pour l'authentification OAuth : - Des informations d'identification de l'administrateur Cato valides. - Un client MCP qui prend en charge OAuth avec un identifiant client préenregistré. Configurez l'identifiant client spécifié ci-dessous; l'URL du serveur seule ne suffit pas. ## Connexion au Serveur MCP à Distance de Cato Après la connexion, votre client découvre les outils disponibles de Cato. Les nouveaux outils sont automatiquement exposés au fur et à mesure que le serveur est mis à jour. ### Connexion avec une clé API Utilisez une clé API Admin pour un travail interactif ou une clé API Service pour la production et l'automatisation. 1. Connectez votre client MCP à votre LLM. 2. Définissez l'URL du serveur MCP sur `https://api.catonetworks.com/api/v1/rest/mcp`. Ce point de terminaison sert à toutes les instances CMA. 3. Ajoutez l'en-tête personnalisé `x-api-key` et entrez votre clé API Cato comme valeur. 4. Enregistrez et activez la connexion. ### Connexion avec les informations d'identification d'administrateur Cato (OAuth) OAuth vous permet de vous authentifier dans votre navigateur avec vos informations d'identification d'administrateur Cato et de valider l'accès du client à Cato. Utilisez `https://api.catonetworks.com/mcp` pour les connexions OAuth dans toutes les régions, y compris l'UE, les États-Unis, l'Inde et le Japon. Cato utilise des clients OAuth publics préenregistrés. Configurez l'identifiant client selon votre client MCP: | Client MCP | ID Client | | --- | --- | | Claude Code | `mcp-claude` | | Cursor | `mcp-cursor` | | OpenAI / Codex | `mcp-openai` | #### Claude Code 1. Ouvrez un terminal et exécutez : ```bash claude mcp ajouter --transport http --client-id mcp-claude --callback-port 18124 cato-mcp https://api.catonetworks.com/mcp --portée utilisateur ``` 2. Dans Claude Code, exécutez `/mcp`, sélectionnez **cato-mcp** et sélectionnez **Authentifier**. 3. Complétez les étapes de connexion et de vérification du navigateur ci-dessous. #### Cursor 1. Ajoutez la configuration du serveur suivante à `~/.cursor/mcp.json`. Si le fichier contient déjà des serveurs, ajoutez `cato-mcp` sous l'objet `mcpServers` existant. ```json { "mcpServers": { "cato-mcp": { "url": "https://api.catonetworks.com/mcp", "auth": { "CLIENT_ID": "mcp-cursor" } } } } ``` 2. Accédez à **Paramètres du curseur > MCP** et sélectionnez **Authentifier** à côté de **cato-mcp**. 3. Complétez les étapes de connexion et de vérification du navigateur ci-dessous. #### OpenAI Codex et ChatGPT Pour le Codex, configurez la connexion en utilisant le terminal ou le fichier de configuration. L'application de bureau ChatGPT peut utiliser la même configuration MCP locale du Codex sur le même hôte. Le web ChatGPT nécessite une connexion distante distincte ; il ne lit pas votre fichier de configuration local. **Configuration du terminal** 1. Ouvrez un terminal et exécutez : ```bash codex mcp ajouter cato-oauth \  --url https://api.catonetworks.com/mcp \  --oauth-client-id mcp-openai ``` 2. Complétez la connexion Cato dans le navigateur lorsque demandé. Si la connexion ne démarre pas automatiquement, exécutez `codex mcp login cato-oauth`. 3. Rechargez votre client ou démarrez une nouvelle session, puis vérifiez la connexion comme décrit ci-dessous. **Configuration du fichier de configuration** 1. Ajoutez la configuration suivante alternativement à `~/.codex/config.toml`. Conservez toute configuration existante et utilisez un nom de serveur unique. ```plaintext [mcp_servers.cato-mcp] url = "https://api.catonetworks.com/mcp" oauth_resource = "https://api.catonetworks.com/mcp" [mcp_servers.cato-mcp.oauth] client_id = "mcp-openai" ``` 2. Enregistrez le fichier et exécutez : ```bash codex mcp connexion cato-mcp ``` 3. Complétez la connexion dans le navigateur et les étapes de vérification ci-dessous. L'exemple du terminal nomme la connexion `cato-oauth` ; l'exemple de fichier de configuration la nomme `cato-mcp`. Choisissez une méthode de configuration et utilisez son nom de connexion lorsque vous exécutez `codex mcp login`. #### **Bureau ChatGPT** 1. Configurez le serveur local en utilisant l'une des méthodes de configuration OpenAI ci-dessus. 2. Dans l'application de bureau ChatGPT sur le même hôte, ouvrez **Paramètres > Serveurs MCP** et redémarrez la connexion si nécessaire. 3. Si la connexion nécessite une authentification, sélectionnez **Authentifier** et complétez la connexion Cato dans le navigateur. 4. Démarrez une nouvelle session locale et vérifiez la connexion comme décrit ci-dessous. #### **Web ChatGPT** Le web ChatGPT utilise une connexion MCP distante séparée. Le support Cato pour cette connexion doit être disponible dans votre version avant que vous ne la configuriez. ##### Compléter la connexion et vérifier la connexion 1. Lorsque votre navigateur ouvre la page de connexion Cato, connectez-vous avec vos identifiants Admin Cato. 2. Examinez l'écran de consentement et approuvez l'accès demandé. 3. Retournez au client MCP et rechargez-le ou démarrez une nouvelle session. 4. Entrez l'invite suivante pour vérifier l'accès : `Utilisez les outils Cato MCP pour lister les comptes assignés que je peux accéder.` Si l'authentification échoue, vérifiez que l'étiquette `COPILOT_MCP_OAUTH` a été ajoutée à votre compte, que l'URL est `https://api.catonetworks.com/mcp`, et que le bon ID de client est configuré. ## ## Audit des appels d'outils Cato MCP Le serveur MCP à distance de Cato génère un événement pour chaque appel d'outil. Vous pouvez utiliser ces événements pour suivre la façon dont les clients MCP accèdent à votre compte et quels outils ils invoquent. Les détails de l'événement incluent : - L'outil MCP invoqué et le client MCP connecté. - La méthode d'authentification : clé API ou OAuth. - Pour l'authentification par clé API, le nom de la clé API. - Pour l'authentification OAuth, le nom de l'administrateur Cato et son adresse e-mail. - L'adresse IP source, le pays et le code pays. - L'agent utilisateur. **Pour examiner les événements d'appel d'outil Cato MCP :** 1. Dans le CMA, ouvrez la page **Événements**. 2. Filtrez par **Type Connectivité** et **Sous-Type CatoMCP**. 3. Développez un événement pour examiner les détails de l'appel d'outil et l'identité d'authentification. ## Limites Connues - Les clients MCP qui ne prennent en charge que les connexions MCP locales (STDIO) ne peuvent pas se connecter directement au point final MCP à Distance de Cato. Pour utiliser ces clients, vous devez déployer un proxy MCP léger qui relie la connexion STDIO locale au serveur MCP distant de Cato.