Netskope NPA MCP Server

This MCP server provides an interface to Netskope's Network Private Access (NPA) API, allowing you to manage publishers, upgrade profiles, access policies, and publisher steering.

Installation Options

Option 1: NPX Installation (Recommended)

npx @johnneerdael/netskope-npa

Option 2: Manual Installation

npm install @johnneerdael/netskope-npa

MacOS/Linux Setup in Claude/Cline

{ "mcpServers": { "netskope-npa": { "command": "npx", "args": [ "-y", "@johnneerdael/netskope-npa", ] "env": { "NETSKOPE_API_TOKEN": "YOUR_API_KEY_HERE", "NETSKOPE_API_BASE": "https://your-netskope-instance.goskope.com" } } } }

WSL Setup in Claude/Cline

Install WSL if not already installed:

# Run in PowerShell as Administrator
wsl --install

Install NVM in WSL:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.nvm/nvm.sh

Install Node.js using NVM:

nvm install v23.6.1
nvm use v23.6.1

Configure MCP in your Claude project:

{
	"mcpServers": {
		"netskope-npa": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && NETSKOPE_API_BASE=https://your-netskope-instance.goskope.com NETSKOPE_API_TOKEN=your-api-token $NVM_BIN/npx -y @johnneerdael/netskope-npa"
			]
		}
	}
}

Note: Replace your-wsl-username and your-windows-username with your actual usernames.

Understanding WSL Paths

WSL path: /home/your-wsl-username
Windows path mapped in WSL: /mnt/c/Users/your-windows-username

Environment Setup

Create .env file:

NETSKOPE_API_BASE=https://your-netskope-instance.goskope.com
NETSKOPE_API_TOKEN=your-api-token

Usage

import { NetskopeNpaClient } from '@your-org/netskope-npa-mcp';

const client = new NetskopeNpaClient(
  process.env.NETSKOPE_API_BASE!,
  process.env.NETSKOPE_API_TOKEN!
);

// List all publishers
const publishers = await client.listPublishers({
  fields: 'publisher_id,name,status'
});

// Create a new publisher
const newPublisher = await client.createPublisher({
  name: 'npa_publisher_1',
  lbrokerconnect: false,
  publisher_upgrade_profiles_id: 1
});

Development

Building

npm run build

Testing

npm test

Running in Development Mode

# Using NPX
npx ts-node src/index.ts

# Or using the built version
npm run build && node dist/index.js

License

MIT

Troubleshooting

WSL Path Issues

If you encounter path mapping issues:

Check your WSL installation: wsl -l -v
Verify path mappings: wsl pwd
Ensure NVM is properly sourced: source ~/.nvm/nvm.sh

Common Issues

EACCES error: Run with proper permissions
sudo chown -R $USER:$USER ~/.npm
Path not found: Verify WSL paths
ls /mnt/c/Users/your-windows-username/Scripts
Node version mismatch: Use correct NVM version
nvm use v23.6.1