Travailler avec le Serveur MCP d'Origine de la connexion de Cato

Prev Next

Aperçu

Le serveur MCP distant fournit un accès aux données historiques pendant la période de rétention 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.

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.

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 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 :

    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.

    {
     "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 :

    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.

    [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 :

    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.