--- title: "与 Cato 远程 MCP 服务器协作" slug: "working-with-the-cato-remote-mcp-server" updated: 2026-11-10T00:14:45Z published: 2026-11-10T00:14:45Z 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. # 与 Cato 远程 MCP 服务器协作 ## 概览 远程 MCP 服务器提供对账户[保留期](https://knowledge.catonetworks.com/docs/guide-to-cato-data-lake)内历史数据的访问权限。例如,拥有三个月保留期的账户可以查询三个月的数据。 您可以使用 API 密钥进行身份认证或通过 OAuth 使用 Cato 管理员凭证登录。数据和操作的访问权限遵循 API 密钥或认证的 Cato 管理员的权限。有关权限的信息,请参阅[使用 RBAC 管理管理员角色](https://knowledge.catonetworks.com/docs/managing-admin-roles-using-rbac)。 您可以审核 Cato MCP 工具调用的事件,以识别调用的工具、已连接的 MCP 客户端以及用于认证的 API 密钥或 Cato 管理员。有关更多信息,请参阅 [审计 Cato MCP 工具调用](/v1/docs/working-with-the-cato-remote-mcp-server#auditing-cato-mcp-tool-calls)。 ### 示例用例 #### AI辅助威胁调查 分析师询问:调查此 IP 并总结相关安全事件。 MCP 客户端: 1. 调用安全事件工具 2. 检索相关的结构化数据 3. 将结果返回给LLM 4. LLM总结发现 #### 自动化XOps事件丰富 当生成 XOps 故事时,AI 代理检索:相关流量、目标声誉和用户历史。然后代理回应: - 上下文报告 - 建议的缓解措施 #### AI驱动的网络故障排除 此示例演示如何使用 Cato MCP 服务器,AI 执行跨网络和应用程序指标的结构化、跨域查询。这取代了手动导航 CMA 中的多个仪表板。 管理员报告称,伦敦站点的用户访问Microsoft 365速度缓慢。 1. 使用远程 MCP,AI 代理查询: 1. 站点运营指标 2. WAN链路健康 3. 丢包率和延迟统计 4. 应用程序性能指标 2. 它检测到: 1. 主要WAN链路丢包率增加 2. M365流量类的SLA性能下降 3. 它关联: 1. 链路质量下降 2. 高峰时段带宽饱和 4. 它推荐: 1. 切换到次要链路 2. 调整QoS优先级 3. 调查ISP性能 ### Prerequisites - 与您的LLM连接的MCP兼容客户端。 - 用于API密钥认证:有效的[Cato API密钥](https://knowledge.catonetworks.com/docs/generating-api-keys-for-the-cato-api)。 - 用于OAuth认证: - 有效的Cato管理员凭据。 - 支持OAuth的MCP客户端和已注册的客户端ID。配置下面指定的客户端ID,仅服务器网址是不够的。 ## 连接到Cato远程MCP服务器 连接后,您的客户端会发现可用的Cato工具。随着服务器更新,新工具会自动暴露。 ### 使用API密钥进行连接 使用管理员API密钥进行互动工作,或使用服务API密钥进行生产和自动化。 1. 将您的MCP客户端连接到您的LLM。 2. 设置MCP服务器网址为`https://api.catonetworks.com/api/v1/rest/mcp`。此端点为所有CMA实例服务。 3. 添加自定义头部`x-api-key`并输入您的Cato API密钥作为其值。 4. 保存并激活连接。 ### 使用Cato管理员凭据进行连接(OAuth) OAuth允许您在浏览器中使用您的Cato管理员凭据进行认证,并批准客户端访问Cato。 在所有区域的OAuth连接中使用`https://api.catonetworks.com/mcp`,包括欧盟、美国、印度和日本。 Cato使用已注册的公共OAuth客户端。根据您的MCP客户端配置客户端ID: | MCP 客户端 | 客户端ID | | --- | --- | | Claude 代码 | `mcp-claude` | | Cursor | `mcp-cursor` | | OpenAI / Codex | `mcp-openai` | #### Claude 代码 1. 打开终端并运行: ```bash claude mcp 添加 --传输 http --client-id mcp-claude --callback-port 18124 cato-mcp https://api.catonetworks.com/mcp --范围 用户 ``` 2. 在Claude代码中,运行`/mcp`,选择**cato-mcp**,然后选择**认证**。 3. 完成下面的浏览器登录和验证步骤。 #### Cursor 1. 将以下服务器配置添加到`~/.cursor/mcp.json`。如果文件已经包含服务器,请在现有的`mcpServers`对象下添加`cato-mcp`。 ```json { "mcpServers": { "cato-mcp": { "网址": "https://api.catonetworks.com/mcp", "auth": { "CLIENT_ID": "mcp-cursor" } } } } ``` 2. 进入**Cursor 设置 > MCP**并在**cato-mcp**旁选择**认证**。 3. 完成下面的浏览器登录和验证步骤。 #### OpenAI Codex和ChatGPT 对于Codex,请使用终端或配置文件来配置连接。 ChatGPT桌面应用程序可以在同一主机上使用相同的本地Codex MCP配置。 ChatGPT网页需要单独的远程连接;它不读取您的本地配置文件。 **终端设置** 1. 打开终端并运行: ```bash codex mcp 添加 cato-oauth \ --url https://api.catonetworks.com/mcp \ --oauth-client-id mcp-openai ``` 2. 在提示时完成Cato浏览器登录。如果登录没有自动启动,请运行`codex mcp login cato-oauth`。 3. 重新加载您的客户端或启动一个新会话,然后验证连接,如下所述。 **配置文件设置** 1. 或者,将以下配置添加到`~/.codex/config.toml`。保留任何现有配置并使用唯一的服务器名称。 ```plaintext [mcp_servers.cato-mcp] 网址 = "https://api.catonetworks.com/mcp" oauth_resource = "https://api.catonetworks.com/mcp" [mcp_servers.cato-mcp.oauth] client_id = "mcp-openai" ``` 2. 保存文件并运行: ```bash codex mcp 登录 cato-mcp ``` 3. 完成浏览器登录并执行验证步骤,如下所述。 终端示例将连接命名为`cato-oauth`;配置文件示例将其命名为`cato-mcp`。选择一种设置方法,并在运行`codex mcp login`时使用其连接名称。 #### **ChatGPT桌面** 1. 使用上述之一的OpenAI设置方法配置本地服务器。 2. 在相同主机上的ChatGPT桌面应用中,打开**设置 > MCP服务器**,并在需要时重新启动连接。 3. 如果连接需要登录,请选择**认证**并完成Cato浏览器登录。 4. 启动一个新的本地会话并验证连接,如下所述。 #### **ChatGPT网页** ChatGPT网络使用单独的远程MCP连接。在配置之前,您的版本中必须具备此连接的Cato支持。 ##### 完成登录并验证连接 1. 当浏览器打开Cato登录页面时,请使用您的Cato管理员凭据登录。 2. 查看同意屏幕,并批准所请求的访问权限。 3. 返回MCP客户端并重新加载或启动一个新会话。 4. 输入以下提示以验证访问权限: `使用Cato MCP工具列出我可以访问的账户。` 如果认证失败,请确认 `COPILOT_MCP_OAUTH` 标签已添加到您的账户,网址为 `https://api.catonetworks.com/mcp`,并且已配置正确的客户端ID。 ## ## 审计 Cato MCP 工具调用 Cato 远程 MCP 服务器为每个工具调用生成一个事件。您可以使用这些事件来跟踪 MCP 客户端如何访问您的账户以及调用了哪些工具。 事件详情包括: - 调用的 MCP 工具和连接的 MCP 客户端。 - 认证方法:API 密钥或 OAuth。 - 对于 API 密钥认证,API 密钥名称。 - 对于 OAuth 认证,Cato 管理员的名称和电子邮件地址。 - 源 IP 地址、国家和国家代码。 - 用户代理。 **要审查 Cato MCP 工具调用事件:** 1. 在 CMA 中,打开**事件**页面。 2. 按**类型连接性**和**子类型 CatoMCP**筛选。 3. 展开事件以审查工具调用详情和认证身份。 ## 已知局限性 - 仅支持本地MCP连接(STDIO)的MCP客户端无法直接连接到Cato远程MCP端点。使用这些客户端时,必须部署一个轻量级MCP代理,以桥接本地STDIO连接到远程Cato MCP服务器。