使用说明

Netskope NPA MCP服务器

一个全面的模型上下文协议（MCP）服务器，用于通过人工智能驱动的自动化管理Netskope专用访问（NPA）基础设施。

📚 完整的文件

该项目包括为便于导航而组织的大量文档：

👉 从完整文档开始 -概述和导航指南

快速访问链接

类别	描述	链接
🏗️ 建筑	服务器设计和模式	服务器架构
🛠️ 工具参考	完整的工具文档	出版商工具, 私人应用工具, 政策工具
🔄 工作流	常见的自动化模式	常见工作流
💼 真实案例	完整的用例	真实世界的例子

工具概览

MCP服务器提供 84专用工具 跨越10个类别：

类别	工具	主要用例
出版商	9个工具	基础设施部署和管理
私人应用程序	15个工具	应用程序生命周期和配置
本地经纪人	7个工具	网络连接和路由
策略管理	6工具	访问控制和安全规则
SCIM集成	5个工具	身份和用户管理
升级配置文件	7种工具	自动化维护计划
转向	3个工具	交通路线和关联
警报	2个工具	事件监控和通知
搜索	2个工具	资源发现和查询
验证	2个工具	配置合规性

实际使用示例

🏢 “为我们的新伦敦办事处建立完整的NPA基础设施”

AI回复：执行全面的部署工作流程

✅ 创建具有自动升级配置文件的发布者
✅ 为内部路由配置本地代理
✅ 设置核心业务应用程序（CRM、ERP、文件服务器）
✅ 使用SCIM组验证创建访问策略
✅ 支持对办公网络的监控和发现
✅ 为现场部署生成注册令牌

🚨 “紧急：安全事件-立即锁定人力资源/财务应用程序”

AI回复：应急安保响应工作流程

✅ 自动识别所有人力资源/财务应用程序
✅ 创建具有最高优先级的应急策略组
✅ 阻止除事件响应团队之外的所有用户访问
✅ 增强对安全事件的监控
✅ 事件跟踪标签应用程序

📊 “对我们的NPA环境进行全面的合规审计”

AI回复：自动合规性评估

✅ 审核所有发布者的版本合规性
✅ 识别没有访问策略的应用程序
✅ 验证策略中的SCIM组引用
✅ 生成合规性评分和补救计划
✅ 创建具有优先级的详细调查结果报告

快速开始

环境设置

export NETSKOPE_BASE_URL="https://your-tenant.goskope.com"
export NETSKOPE_TOKEN="your-api-token"

安装并运行
```
npm install
npm run build
npm start
```

通过MCP客户端连接

{
  "mcpServers": {
    "netskope-npa": {
      "command": "node",
      "args": ["/path/to/privateaccess-mcp/build/index.js"],
      "env": {
        "NETSKOPE_BASE_URL": "https://your-tenant.goskope.com",
        "NETSKOPE_TOKEN": "your-api-token"
      }
    }
  }
}

主要特点

🤖 AI原生设计

为LLM交互设计的工具，具有清晰的描述
自动参数验证和转换
用于故障排除的丰富错误上下文

🔄 工作流编排

工具自动相互协调
内置重试逻辑和错误恢复
尽可能进行交易操作

🛡️ 生产就绪

使用Zod模式进行全面的输入验证
费率限制和API配额管理
详细的日志记录和监控

🔗 集成模式

SCIM集成用于身份解析
资源发现的搜索工具
用于合规性检查的验证工具

安装选项

NPM包

npm install @johnneerdael/ns-private-access-mcp

本地开发

git clone https://github.com/johnneerdael/privateaccess-mcp.git
cd privateaccess-mcp
npm install
npm run build

通用JSON客户端配置

对于采用JSON映射的客户端（Cursor、Windsurf、自定义主机）：

{
  "mcpServers": {
    "netskope": {
      "url": "https://YOUR-MCP-HOST.example.com/mcp",
      "headers": {
        "X-Netskope-Tenant": "https://YOUR-TENANT.goskope.com",
        "Authorization": "Bearer YOUR_NETSKOPE_API_TOKEN"
      }
    }
  }
}

自足执行

更喜欢运行自己的实例？附带两个合成文件：

文件	目的	命令
`docker-compose.yml`	从GHCR运行预构建的多拱形图像。	`docker compose up -d`
`docker-compose.build.yml`	从当地资源中构建（用于发展）。	`docker compose -f docker-compose.build.yml up --build`

没有作曲的一句话：

# Prebuilt image from GHCR
docker run --rm -p 3000:3000 ghcr.io/johnneerdael/privateaccess-mcp:latest

# Build and run from a local checkout
docker build -t netskope-mcp:local .
docker run --rm -p 3000:3000 netskope-mcp:local

# Or just run the Node entry directly
npm run build && PORT=3000 node dist/cli-http.js

容器暴露 /mcp （可流式传输HTTP）和 /healthz （活力）。有用的环境变量：

Var	目的
`PORT` / `HOST`	绑定地址（默认 `0.0.0.0:3000`).
`PUBLIC_URL`	标准公共来源（例如。 `https://YOUR-MCP-HOST.example.com`).表面处理 `/healthz` 以及启动日志；保留用于未来的OAuth/众所周知的元数据。可以放心省略。
`CORS_ORIGIN`	逗号分隔的列表浏览器-基于MCP客户端（例如。 `https://claude.ai`).默认为 `*`。与CLI客户端（Claude Code、Codex、Cursor）或在本身不需要CORS的反向代理后面运行时无关。
`NETSKOPE_BASE_URL` / `NETSKOPE_API_TOKEN`	可选后备方案凭据，仅在客户端省略标头时使用。为单租户部署设置这两个选项；对于多租户自托管（建议用于共享自托管部署），将两者都保留为未设置状态。

建筑亮点

工具组成

工具旨在通过定义良好的接口协同工作：

// Example: Creating a private app with validation and tagging
1. validateName() -> Check app name compliance
2. searchPublishers() -> Find target publisher
3. createPrivateApp() -> Create the application  
4. createPrivateAppTags() -> Add organizational tags
5. updatePublisherAssociation() -> Associate with publishers

模式驱动验证

每个工具都使用Zod模式进行类型安全和验证：

const createAppSchema = z.object({
  app_name: z.string().min(1).max(64),
  host: z.string().url(),
  protocols: z.array(protocolSchema),
  clientless_access: z.boolean()
});

差错恢复

用于处理常见问题的内置模式：

从MCP对象中自动提取参数
使用指数回退重试逻辑
部分故障时性能良好

学分

约翰尼尔达尔 （Netskope专用访问产品经理）
米切尔泵 （荷兰首席Netskope解决方案工程师）

获取帮助

文件问题：在GitHub上打开一个问题
功能请求：创建功能请求问题
错误报告：使用错误报告模板
安全问题：参见安全.md

此MCP服务器将复杂的Netskope NPA管理转换为简单的AI驱动对话。