tzachbon/srulik-toolkit / plugins/mcporter-plugin/skills/mcporter-setup
mcporter-setup
VerifiedMove the MCP servers configured in Claude Code, Codex, Cursor and other editors into one mcporter home config, check each one answers, then disable the native copies with backups and an undo receipt. Use when the user asks to set up mcporter, consolidate or migrate MCP servers, or stop using native MCP tools.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.7 KB |
| references/claude-code.md | markdown | 1.9 KB |
| references/codex.md | markdown | 1002 B |
references/claude-code.md
View on GitHub# Claude Code mapping for mcporter-setup
What `scripts/setup.js` reads and writes for Claude Code. All paths move under
`CLAUDE_CONFIG_DIR` when it is set (`<dir>/settings.json`, `<dir>/.claude.json`).
## Where servers are read
Each file is imported on its own, in mcporter 0.17's order, so a different
definition in another file is seen:
- the project's `.claude/settings.local.json`, `.claude/settings.json`, `.claude/mcp.json`;
- the same three files in `~/.claude/`;
- `~/.claude.json` (user scope, plus one block per project for local scope);
- the project's `.mcp.json` (mcporter's own claude-code import skips it).
## How a migrated copy is switched off
Claude Code keeps every entry; these switches stop it from loading. They are
the same ones `/mcp disable` writes.
| Copy | Switch |
| --- | --- |
| User scope (`~/.claude.json` top level, `~/.claude/*.json`) | `deniedMcpServers: [{serverName}]` in `~/.claude/settings.json` |
| Project `.mcp.json` | `disabledMcpjsonServers` in the project's `.claude/settings.local.json` |
| Local scope (this project's block in `~/.claude.json`) | `disabledMcpServers` in that block |
| Project `.claude/*.json` | `manual` |
## Limits
- The user denylist is by name, so it would also block a same-name server with
another definition. Two different Claude Code definitions of one name,
including the same name in more than one block of `~/.claude.json`, are not
switched off at all and go to `manual`.
- A user-scope deny also hides another project's same-name project server,
which setup does not inspect.
- Native tools appear as `mcp__<server>__<tool>`, with every character outside
`[A-Za-z0-9_-]` replaced by `_`. When two mcporter names share that key, or
the tool part holds another `__`, the redirect hook leaves the call alone.
- Hook output follows Claude Code's PreToolUse contract: warn mode returns
only `additionalContext`, block mode returns `permissionDecision: "deny"`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |