--- title: "Trabalhando com o Servidor MCP de Origem da Conexão Cato" slug: "working-with-the-cato-remote-mcp-server" updated: 2026-11-10T00:10:52Z published: 2026-11-10T00:10:52Z 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. # Trabalhando com o Servidor MCP de Origem da Conexão Cato ## Visão geral O Servidor de Origem da Conexão MCP fornece acesso aos dados históricos dentro do período de retenção da sua [conta](https://knowledge.catonetworks.com/docs/guide-to-cato-data-lake). Por exemplo, uma conta com três meses de retenção pode consultar três meses de dados. Você pode autenticar com uma chave API ou entrar com as credenciais de Administrador Cato usando OAuth. O acesso aos dados e ações segue as permissões da chave API ou do Administrador Cato autenticado. Para informações sobre permissões, consulte [Gerenciando Funções de Admin Usando RBAC](https://knowledge.catonetworks.com/docs/managing-admin-roles-using-rbac). Você pode revisar eventos de chamadas de ferramentas Cato MCP para identificar a ferramenta invocada, o cliente MCP conectado e a chave de API ou Administrador Cato usado para autenticação. Para mais informações, veja [Auditoria de Chamadas de Ferramentas Cato MCP](/v1/docs/working-with-the-cato-remote-mcp-server#auditing-cato-mcp-tool-calls). ### Exemplos de Casos de Uso #### Investigação de Ameaças Assistida por AI Um analista pergunta: Investigue este IP e resuma eventos de segurança relacionados. O cliente MCP: 1. Chama o ferramenta de Eventos de Segurança 2. Recupera dados estruturados relevantes 3. Retorna resultados para o LLM 4. O LLM resume os achados #### Enriquecimento Automático de Incidentes XOps Quando uma história XOps é gerada, o agente de IA recupera: Fluxos relacionados, reputação do alvo e histórico do usuário. O agente então responde com: - Um relatório contextual - Ações de mitigação sugeridas #### Soluções de Problemas de Rede Orientadas por AI Este exemplo demonstra como, usando o servidor MCP da Cato, a IA realiza consultas estruturadas e interdomínio em métricas de rede e aplicação. Isso substitui a navegação manual em vários painéis no CMA. Um administrador relata que usuários no site de Londres estão enfrentando acesso lento ao Microsoft 365. 1. Usando o MCP de Origem da Conexão, o agente de IA consulta: 1. Métricas de Operações de Site 2. Saúde do link WAN 3. Estatísticas de perda de pacotes e latência 4. Métricas de desempenho de aplicação 2. Ele detecta: 1. Aumento de perda de pacotes no link WAN primário 2. SLA degradado para a classe de tráfego M365 3. Ele correlaciona: 1. Degradação da qualidade do link 2. Saturação da largura de banda durante horas de pico 4. Ele recomenda: 1. Falha no link secundário 2. Ajustando prioridade de QoS 3. Investigando desempenho do ISP ### Requisitos - Um cliente compatível com MCP conectado ao seu LLM. - Para autenticação da chave API: uma [chave API Cato](https://knowledge.catonetworks.com/docs/generating-api-keys-for-the-cato-api) válida. - Para autenticação OAuth: - Credenciais válidas de Administrador Cato. - Um cliente MCP que suporta OAuth com um ID de cliente pré-registrado. Configure o ID de cliente especificado abaixo; o URL do servidor sozinho é insuficiente. ## Conectando ao Servidor MCP Remoto da Cato Após conectar-se, seu cliente descobre as ferramentas Cato disponíveis. Novas ferramentas são expostas automaticamente conforme o servidor é atualizado. ### Conectando com uma Chave API Use uma chave API de Administrador para trabalhos interativos, ou uma chave API de Serviço para produção e automação. 1. Conecte seu cliente MCP ao seu LLM. 2. Defina o URL do servidor MCP para `https://api.catonetworks.com/api/v1/rest/mcp`. Este endpoint atende a todas as instâncias do CMA. 3. Adicione o cabeçalho personalizado `x-api-key` e insira sua chave API Cato como valor. 4. Salve e ative a conexão. ### Conectando com Credenciais de Administrador Cato (OAuth) OAuth permite que você se autentique no seu navegador com suas credenciais de Administrador Cato e aprove o acesso do cliente ao Cato. Use `https://api.catonetworks.com/mcp` para conexões OAuth em todas as regiões, incluindo UE, EUA, Índia e Japão. Cato usa clientes OAuth públicos pré-registrados. Configure o ID de cliente de acordo com seu cliente MCP: | Cliente MCP | Client ID | | --- | --- | | Código Claude | `mcp-claude` | | Cursor | `mcp-cursor` | | OpenAI / Codex | `mcp-openai` | #### Código Claude 1. Abra um terminal e execute: ```bash claude mcp adicionar --transporte http --id do cliente mcp-claude --porta de retorno 18124 cato-mcp https://api.catonetworks.com/mcp --escopo usuário ``` 2. No Claude Code, execute `/mcp`, selecione **cato-mcp** e selecione **Autenticar**. 3. Complete o login no navegador e etapas de verificação abaixo. #### Cursor 1. Adicione a seguinte configuração de servidor a `~/.cursor/mcp.json`. Se o arquivo já contiver servidores, adicione `cato-mcp` no objeto existente `mcpServers`. ```json {  "servidoresMcp": {    "cato-mcp": {      "url": "https://api.catonetworks.com/mcp",      "auth": {        "ID_DO_CLIENTE": "mcp-cursor"      }    }  } } ``` 2. Vá para **Configurações de Cursor > MCP** e selecione **Autenticar** ao lado de **cato-mcp**. 3. Complete o login no navegador e etapas de verificação abaixo. #### OpenAI Codex e ChatGPT Para Codex, configurar a conexão usando o terminal ou o arquivo de configuração. O aplicativo de desktop ChatGPT pode usar a mesma configuração local MCP Codex no mesmo host. ChatGPT web requer uma conexão remota separada; ele não lê seu arquivo de configuração local. **Configuração do terminal** 1. Abra um terminal e execute: ```bash codex mcp adicionar cato-oauth \ --url https://api.catonetworks.com/mcp \ --oauth-client-id mcp-openai ``` 2. Complete o login no navegador Cato quando solicitado. Se o login não começar automaticamente, execute `codex mcp login cato-oauth`. 3. Recarregue seu cliente ou inicie uma nova sessão, depois verifique a conexão conforme descrito abaixo. **Configuração do arquivo de configuração** 1. Alternativamente, adicione a seguinte configuração a `~/.codex/config.toml`. Preserve qualquer configuração existente e use um nome de servidor único. ```plaintext [servidores_mcp.cato-mcp] url = "https://api.catonetworks.com/mcp" recurso_oauth = "https://api.catonetworks.com/mcp" [servidores_mcp.cato-mcp.oauth] id_do_cliente = "mcp-openai" ``` 2. Salvar o arquivo e execute: ```bash codex mcp login cato-mcp ``` 3. Complete as etapas de login e verificação no navegador abaixo. O exemplo de terminal nomeia a conexão `cato-oauth`; o exemplo de arquivo de configuração nomeia como `cato-mcp`. Escolha um método de configuração e use seu nome de conexão quando executar `codex mcp login`. #### **ChatGPT de desktop** 1. Configurar o servidor local usando um dos métodos de configuração OpenAI acima. 2. No aplicativo de desktop ChatGPT no mesmo host, abra **Configurações > Servidores MCP** e reinicie a conexão se necessário. 3. Se a conexão exigir login, selecione **Autenticar** e complete o login no navegador Cato. 4. Inicie uma nova sessão local e verifique a conexão conforme descrito abaixo. #### **ChatGPT web** ChatGPT web usa uma conexão MCP remota separada. O suporte Cato para esta conexão deve estar disponível em seu lançamento antes de configurá-la. ##### Completando o Login e Verificando a Conexão 1. Quando seu navegador abrir a página de login Cato, faça o login com suas credenciais de administrador Cato. 2. Revise a tela de consentimento e aprove o acesso solicitado. 3. Retorne ao cliente MCP e recarregue ou inicie uma nova sessão. 4. Insira o seguinte prompt para verificar o acesso: `Use as ferramentas MCP do Cato para listar as contas que posso acessar.` Se a autenticação falhar, verifique se a tag `COPILOT_MCP_OAUTH` foi adicionada à sua conta, se a URL é `https://api.catonetworks.com/mcp`, e se o ID do cliente correto está configurado. ## ## Auditoria de Chamadas de Ferramentas MCP da Cato O Servidor de MCP Remoto da Cato gera um evento para cada chamada de ferramenta. Você pode usar esses eventos para rastrear como os clientes MCP acessam sua conta e quais ferramentas eles invocam. Os detalhes do evento incluem: - A ferramenta MCP invocada e o cliente MCP conectado. - O método de autenticação: Chave API ou OAuth. - Para autenticação por chave API, o nome da chave API. - Para autenticação por OAuth, o nome do Administrador da Cato e o endereço de e-mail. - O endereço IP de origem, país e código do país. - O agente do usuário. **Para revisar eventos de chamadas de ferramentas MCP da Cato:** 1. Na CMA, abra a página **Eventos**. 2. Filtre por **Tipo de Conectividade** e **Sub-Tipo CatoMCP**. 3. Expanda um evento para revisar os detalhes da chamada da ferramenta e a identidade de autenticação. ## Limitação de Serviços Conhecidas - Clientes MCP que suportam apenas conexões MCP locais (STDIO) não podem se conectar diretamente ao ponto final MCP Remoto da Cato. Para usar esses clientes, você deve implantar um proxy MCP leve que conecte a conexão STDIO local ao servidor MCP remoto da Cato.