--- title: "Trabajando con el Servidor de Origen de conexión MCP de Cato" slug: "working-with-the-cato-remote-mcp-server" updated: 2026-11-10T00:11:40Z published: 2026-11-10T00:11:40Z 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. # Trabajando con el Servidor de Origen de conexión MCP de Cato ## "Resumen" El Servidor MCP Remoto proporciona acceso a datos históricos dentro del [período de retención](https://knowledge.catonetworks.com/docs/guide-to-cato-data-lake) 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](https://knowledge.catonetworks.com/docs/managing-admin-roles-using-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](/v1/docs/working-with-the-cato-remote-mcp-server#auditing-cato-mcp-tool-calls). ### 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](https://knowledge.catonetworks.com/docs/generating-api-keys-for-the-cato-api) 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: ```bash 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. ```json { "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: ```bash 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. ```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. Guarde el archivo y ejecute: ```bash 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.