Skip to content

tzachbon/srulik-toolkit / plugins/mcporter-plugin/skills/mcporter-setup

mcporter-setup

Verified

Move 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.

FileKindSize
SKILL.mdskill md4.7 KB
references/claude-code.mdmarkdown1.9 KB
references/codex.mdmarkdown1002 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"`.
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: 470kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall