proxyman-mcp-setup — Claude Code skill: setup and install
This skill connects a coding agent to Proxyman MCP through a local stdio bridge. Use it to locate the bridge or troubleshoot missing tools.
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup -a claude-codeWhat proxyman-mcp-setup does
The skill checks for a Proxyman installation, helps start the app, and guides you to enable MCP Server in Settings > MCP. It then looks for the mcp-server executable on macOS, Windows, or Linux and identifies the agent configuration. The agent launches the bridge over stdio, and the bridge forwards calls to the running app.
Proxyman must be running and MCP Server enabled for verification to work. Don’t set the port or token yourself; the app regenerates them. If the handshake file is missing or stale, the instructions call for restarting Proxyman and enabling MCP again. On Linux AppImage builds, starting the app copies the bridge into its config directory.
Keep other MCP server settings intact and change only the proxyman entry. The skill also recommends leaving sensitive-data redaction on before sending content to the agent. Turn it off only when the user explicitly requests raw data.
What it helps with
- check whether Proxyman is installed
- locate the MCP bridge executable
- enable MCP Server in Proxyman
- troubleshoot an agent that cannot discover MCP tools
Example prompts for the agent
- Set up Claude Code to use Proxyman MCP, then check whether the tools are available.
- Find the
mcp-serverexecutable for this system and configureproxymanwithout changing other MCP entries. - Troubleshoot the Proxyman MCP handshake; check that the app is running and MCP is enabled.
How to install proxyman-mcp-setup
1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup -a claude-code2Manually: put the files in place
~/.claude/skills/proxyman-mcp-setup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/proxyman-mcp-setup/
1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup -a codex2Manually: put the files in place
.agents/skills/proxyman-mcp-setup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup -a cursor2Manually: put the files in place
.cursor/skills/proxyman-mcp-setup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ProxymanApp/proxyman-SKILL.md proxyman-mcp-setup2Manually: put the files in place
.github/skills/proxyman-mcp-setup/SKILL.md1Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup -a gemini-cli2Platform CLI
gemini skills install https://github.com/ProxymanApp/proxyman-SKILL.md --path skills/proxyman-mcp-setupManually: put the files in place
.devin/skills/proxyman-mcp-setup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about proxyman-mcp-setup
How do I install proxyman-mcp-setup in Claude Code?
Run npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup -a claude-code. The skill is placed at ~/.claude/skills/proxyman-mcp-setup/SKILL.md.
What does proxyman-mcp-setup do?
It helps connect an agent to Proxyman MCP using a local stdio bridge. The skill checks the app, MCP setting, bridge location, and agent configuration.
What must be ready before testing the Proxyman MCP connection?
Proxyman needs to be installed and running, with MCP Server enabled under Settings > MCP. The app regenerates the port and token, so don’t hardcode them.
