mcp-gateway-auth
v1.2.6
Published
CLI for MCP Gateway authentication on SSH/headless servers using OAuth 2.0 Device Flow
Maintainers
Readme
mcp-gateway-auth
CLI for MCP Gateway authentication on SSH/headless servers.
Uses OAuth 2.0 Device Authorization Grant (RFC 8628) - no local browser required.
Installation
npm install -g mcp-gateway-authQuick Start
mcp-auth login- Open the displayed URL on any device
- Enter the code shown in terminal
- All MCP services are automatically configured
Commands
mcp-auth login Authenticate via Device Flow
mcp-auth reconnect Refresh token (no browser needed)
mcp-auth status Show authentication status
mcp-auth token Print access token (for scripts)
mcp-auth logout Remove credentials
mcp-auth help Show help
mcp-auth --version Show versionWhat It Does
After mcp-auth login, your .mcp.json is configured with:
| Service | Description | |---------|-------------| | chrome | Chrome DevTools Protocol | | playwright | Cross-browser automation | | firefox | Firefox DevTools | | selenium | Selenium WebDriver | | http | HTTP client | | state | Browser state management | | proxy | Proxy rotation | | captcha | CAPTCHA solving | | screenshot | URL screenshots |
Verify Connection
claude mcp listAll services should show as connected.
Token Refresh
Tokens are valid for 1 year. Refresh without re-authenticating:
mcp-auth reconnectEnvironment Variables
| Variable | Default |
|----------|---------|
| MCP_GATEWAY_URL | https://mcp.server.oanor.com |
Files
| Path | Description |
|------|-------------|
| ~/.mcp-gateway/credentials.json | Stored credentials |
| ./.mcp.json | MCP server configuration |
Requirements
- Node.js 18+
Links
License
MIT
