Trabajando con el Servidor de Origen de conexión MCP de Cato

Prev Next

"Resumen"

El Servidor MCP Remoto proporciona acceso a datos históricos dentro del período de retención de tu cuenta. Por ejemplo, una cuenta con tres meses de retención puede consultar tres meses de datos.

Puedes autenticarte con una clave API o iniciar sesión con las credenciales de Admin de Cato usando OAuth. El acceso a datos y acciones sigue los permisos de la clave API o del Administrador de Cato autenticado. Para obtener información sobre los permisos, consulta Gestión de Roles de Administrador Usando RBAC.

Puede revisar los eventos para las llamadas a herramientas MCP de Cato para identificar la herramienta invocada, el cliente MCP conectado y la clave API o el Administrador Cato usado para la autenticación. Para obtener más información, consulte Auditoría de Llamadas de Herramientas MCP de Cato.

Casos de uso ejemplo

Investigación de amenazas asistida por AI

Un Analista pregunta: Investiga este IP y resume los Eventos de Seguridad relacionados.

El Cliente MCP:

  1. Llama a la herramienta de eventos de seguridad

  2. Recupera datos estructurados relevantes

  3. Devuelve los resultados al LLM

  4. El LLM resume los hallazgos

Enriquecimiento automatizado de incidentes XOps

Cuando una historia de XOps es Generando, el agente AI obtiene: Flujos relacionados, Reputación del Objetivo y historial de Usuario. Luego, el agente responde con:

  • Un informe contextual

  • Acciones de mitigación sugeridas

Solución de problemas de red impulsada por AI

Este ejemplo demuestra cómo, Usando el Servidor MCP de Cato, el AI realiza consultas estructuradas, cross-domain en Redes y métricas de Aplicación. Esto reemplaza navegar manualmente múltiples Tablero en la Aplicación de Gestión de Cato.

Un administrador informa que los usuarios en el sitio de Londres están experimentando un acceso lento a Microsoft 365.

  1. Usando Origen de conexión MCP, el agente AI consulta:

    1. Métricas de operaciones del sitio

    2. Salud del enlace WAN

    3. Estadísticas de pérdida de paquetes y latencia

    4. Métricas de rendimiento de la aplicación

  2. Detectada:

    1. Aumento de la pérdida de paquetes en el enlace WAN primario

    2. SLA degradado para la clase de tráfico M365

  3. Correlaciona:

    1. Degradación de la calidad del enlace

    2. Saturación de ancho de banda durante las horas pico

  4. Recomienda:

    1. Fallo a través del enlace secundario

    2. Ajustando la prioridad de QoS

    3. Investigando el rendimiento del ISP

"Requisitos previos"

  • Un cliente compatible con MCP conectado a su LLM.

  • Para la autenticación de clave API: una Clave API de Cato válida.

  • Para la autenticación OAuth:    

    • Credenciales de Administrador Cato válidas.

    • Un cliente MCP que soporta OAuth con un ID de cliente pre-registrado. Configure el ID de cliente especificado a continuación; la URL del servidor por sí sola no es suficiente.

Conectando al servidor MCP remoto de Cato

Después de conectarse, su cliente descubre las herramientas disponibles de Cato. Nuevas herramientas se exponen automáticamente a medida que se actualiza el servidor.

Conexión con una Clave API

Utilice una clave API de Admin para el trabajo interactivo, o una clave API de Servicio para producción y automatización.

  1. Conecte su cliente MCP a su LLM.

  2. Establezca la dirección URL del servidor MCP a https://api.catonetworks.com/api/v1/rest/mcp. Este endpoint sirve a todas las instancias de CMA.

  3. Agregue el encabezado personalizado x-api-key e ingrese su Clave API de Cato como su valor.

  4. Guarde y active la conexión.

Conectar con Credenciales de Administrador de Cato (OAuth)

OAuth le permite autenticarse en su navegador con sus credenciales de administrador de Cato y aprobar el acceso del cliente a Cato.

Utilice https://api.catonetworks.com/mcp para conexiones de OAuth en todas las regiones, incluyendo UE, EE.UU., India y Japón.

Cato utiliza clientes OAuth públicos pre-registrados. Configure el ID de cliente según su cliente MCP:

Cliente MCP

Client ID

Código Claude

mcp-claude

Cursor

mcp-cursor

OpenAI / Codex

mcp-openai

Código Claude

  1. Abra un terminal y ejecute:

    claude mcp agregar --transporte http --cliente-id mcp-claude --puerto-callback 18124 cato-mcp https://api.catonetworks.com/mcp --alcance usuario
  2. En Claude Code, ejecute /mcp, seleccione cato-mcp y seleccione Autenticar.

  3. Complete los pasos de inicio de sesión y verificación del navegador a continuación.

Cursor

  1. Agregue la siguiente configuración del servidor a ~/.cursor/mcp.json. Si el archivo ya contiene servidores, agregue cato-mcp bajo el objeto mcpServers existente.

    {
     "mcpServers": {
     "cato-mcp": {
     "url": "https://api.catonetworks.com/mcp",
     "auth": {
     "CLIENT_ID": "mcp-cursor"
     }
     }
     }
    }
  2. Vaya a Configuración del Cursor > MCP y seleccione Autenticar junto a cato-mcp.

  3. Complete los pasos de inicio de sesión y verificación del navegador a continuación.

OpenAI Codex y ChatGPT

Para Codex, configure la conexión utilizando el terminal o el archivo de configuración. La aplicación de escritorio de ChatGPT puede usar la misma configuración local de MCP Codex en el mismo host. El ChatGPT web requiere una conexión remota separada; no lee su archivo de configuración local.

Configuración del terminal

  1. Abra un terminal y ejecute:

    codex mcp agregar cato-oauth \
      --url https://api.catonetworks.com/mcp \
      --oauth-client-id mcp-openai
  2. Complete el inicio de sesión del navegador de Cato cuando se le solicite. Si el inicio de sesión no comienza automáticamente, ejecute codex mcp login cato-oauth.

  3. Recargue su cliente o inicie una nueva sesión, luego verifique la conexión como se describe a continuación.

Configuración del archivo de configuración

  1. Alternativamente, agregue la siguiente configuración a ~/.codex/config.toml. Conserve cualquier configuración existente y use un nombre de servidor único.

    [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. Guarde el archivo y ejecute:

    codex mcp inicio de sesión cato-mcp
  3. Complete los pasos de inicio de sesión y verificación del navegador a continuación.

El ejemplo del terminal nombra la conexión cato-oauth; el ejemplo del archivo de configuración lo nombra cato-mcp. Elija un método de configuración y use su nombre de conexión cuando ejecute codex mcp login.

Escritorio de ChatGPT

  1. Configure el servidor local utilizando uno de los métodos de configuración OpenAI mencionados arriba.

  2. En la aplicación de escritorio de ChatGPT en el mismo host, abra Configuración > Servidores MCP y reinicie la conexión si es necesario.

  3. Si la conexión requiere inicio de sesión, seleccione Autenticar y complete el inicio de sesión del navegador de Cato.

  4. Inicie una nueva sesión local y verifique la conexión como se describe a continuación.

Web de ChatGPT

El ChatGPT web utiliza una conexión MCP remota separada. El soporte de Cato para esta conexión debe estar disponible en su versión antes de configurarla.

Completar Inicio de Sesión y Verificar la Conexión
  1. Cuando su navegador abra la página de inicio de sesión de Cato, inicie sesión con sus credenciales de Administrador de Cato.

  2. Revise la pantalla de consentimiento y apruebe el acceso solicitado.

  3. Regrese al cliente MCP y recárguelo o inicie una nueva sesión.

  4. Ingrese la siguiente solicitud para verificar el acceso:

    Utilice las herramientas de Cato MCP para listar las cuentas a las que puedo acceder.

Si la autenticación falla, verifique que la etiqueta COPILOT_MCP_OAUTH se haya agregado a su cuenta, que la URL sea https://api.catonetworks.com/mcp, y que el ID del cliente esté configurado correctamente.

Auditando llamadas de la herramienta MCP de Cato

El servidor remoto de MCP de Cato genera un evento por cada llamada de herramienta. Puede usar estos eventos para seguir cómo los clientes de MCP acceden a su cuenta y qué herramientas invocan.

Los detalles del evento incluyen:

  • La herramienta MCP invocada y el cliente MCP conectado.

  • El método de autenticación: Clave API o OAuth.

  • Para la autenticación con clave API, el nombre de la clave API.

  • Para la autenticación OAuth, el nombre y la dirección de correo electrónico del administrador de Cato.

  • La dirección IP de origen, el país y el código del país.

  • El agente de usuario.

Para revisar los eventos de llamadas de herramientas MCP de Cato:

  1. En el CMA, abra la página de Eventos.

  2. Filtre por Tipo de Conectividad y Subtipo CatoMCP.

  3. Expanda un evento para revisar los detalles de la llamada de la herramienta y la identidad de autenticación.

Limitaciones Conocidas

  • Los clientes MCP que solo soportan conexiones MCP locales (STDIO) no pueden conectarse directamente al punto final de MCP remoto de Cato. Para usar estos clientes, debes desplegar un proxy MCP ligero que conecte la conexión STDIO local con el servidor MCP remoto de Cato.