Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cequenceai/mcp-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Cequence MCP CLI
A command-line tool by Cequence Security for easily setting up Cequence MCP (Model Context Protocol) servers with AI clients like Cursor IDE, Claude AI, and Windsurf IDE.
Features
- 🚀 One-command setup for Cursor IDE, Claude AI, and Windsurf IDE
- 🔐 Support for API key authentication
- 🛠️ Cross-platform support (macOS, Windows, Linux)
- ✨ Automatic configuration file management
- 📝 Clear setup instructions and feedback
- 🔒 Powered by Cequence's API security platform
Installation
You can run the CLI directly using npx without installing it globally:
npx @cequenceai/mcp-cli@latest --help
Or install it globally:
npm install -g @cequenceai/mcp-cli
Usage
Setup with Cursor IDE
npx @cequenceai/mcp-cli@latest cursor --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway"
With API key authentication:
npx @cequenceai/mcp-cli@latest cursor --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway" --api-key "your-api-key"
Setup with Claude AI
npx @cequenceai/mcp-cli@latest claude --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway"
With API key authentication:
npx @cequenceai/mcp-cli@latest claude --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway" --api-key "your-api-key"
Setup with Windsurf IDE
npx @cequenceai/mcp-cli@latest windsurf --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway"
With API key authentication:
npx @cequenceai/mcp-cli@latest windsurf --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway" --api-key "your-api-key"
List configured servers
npx @cequenceai/mcp-cli@latest list
Command Options
Common Options
--url, -u
: Required - Cequence MCP server URL--name, -n
: Server name (defaults to "Cequence MCP Gateway")--api-key, -k
: API key for authentication (optional)
Examples
Basic setup for Cursor:
npx cequence-mcp-cli@latest cursor -u "https://api.example.com/mcp" -n "Example API via Cequence"
Setup with authentication:
npx cequence-mcp-cli@latest cursor -u "https://api.example.com/mcp" -n "Example API via Cequence" -k "sk-1234567890"
Setup for Claude AI:
npx cequence-mcp-cli@latest claude -u "https://api.example.com/mcp" -n "Example API via Cequence"
Setup for Windsurf IDE:
npx cequence-mcp-cli@latest windsurf -u "https://api.example.com/mcp" -n "Example API via Cequence"
Configuration Locations
The CLI automatically detects your platform and configures the appropriate files:
Cursor IDE
- All platforms:
~/.cursor/mcp.json
Claude AI
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Linux:
~/.config/claude/claude_desktop_config.json
Windsurf IDE
- All platforms:
~/.windsurf/mcp.json
Post-Setup Steps
After configuring Cursor IDE:
- Restart Cursor IDE
- Open the command palette (Cmd/Ctrl + Shift + P)
- Look for MCP-related commands
- Your Cequence-secured APIs are now available as MCP tools
After configuring Claude AI:
- Restart Claude AI application
- The Cequence MCP server should be available in your conversation
- Start using your secured APIs through Claude's interface
After configuring Windsurf IDE:
- Restart Windsurf IDE
- Open the command palette (Cmd/Ctrl + Shift + P)
- Look for MCP-related commands
- Your Cequence-secured APIs are now available as MCP tools
About Cequence Security
Cequence Security protects APIs from attacks, abuse, and data theft. This CLI tool enables you to easily connect your Cequence-secured APIs to AI development environments, providing secure and monitored access to your API resources.
Troubleshooting
Common Issues
- Permission errors: Make sure you have write permissions to the configuration directories
- Invalid URL: Ensure your Cequence MCP server URL is accessible and uses HTTP/HTTPS
- Configuration not applied: Try restarting the AI client application
Getting Help
npx @cequenceai/mcp-cli@latest --help
npx @cequenceai/mcp-cli@latest cursor --help
npx @cequenceai/mcp-cli@latest claude --help
npx @cequenceai/mcp-cli@latest windsurf --help
Development
To contribute to this CLI tool:
- Clone the repository
- Install dependencies:
npm install
- Build:
npm run build
- Test locally:
npm run dev
License
MIT License - see LICENSE file for details.
Support
For support with Cequence products or this CLI tool, please visit Cequence Security Support or open an issue in this repository.