Agent-Skills.md

Agent Skills: MCP Setup

Use when setting up MCP servers for the first time or verifying MCP configuration. Ensures token-efficient and context-graph MCP servers are properly installed and configured with API keys.

UncategorizedID: ingpoc/SKILLS/mcp-setup

Repository

ingpoc/SKILLS
ingpoc
6

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ingpoc/SKILLS/tree/HEAD/mcp-setup

Skill Files

Browse the full folder contents for mcp-setup.

Download Skill

Loading file tree…

mcp-setup/SKILL.md

Skill Metadata

Name
mcp-setup
Description
"Use when setting up MCP servers for the first time or verifying MCP configuration. Runtime-aware: writes Claude .mcp.json or Codex .codex/config.toml, referencing central mcp-servers only (no per-project cloning)."

MCP Setup

Configure required MCP servers with a single global server codebase and project-local config.

Required MCP Servers

| Server | Purpose | API Key | |--------|---------|---------| | token-efficient | CSV/log processing, sandbox execution (98% token savings) | None | | context-graph | Semantic decision trace search | Voyage AI |

Design Rules

  • Do not clone MCP servers into each project.
  • Use one central server root (default: $HOME/Documents/remote-claude/mcp-servers).
  • Write runtime-specific config in project:
    • Claude: .mcp.json
    • Codex: .codex/config.toml
  • Keep state local to project (e.g., context-graph project_dir -> <project>/.traces).
  • Never write raw secrets into project config; use env placeholders.

Quick setup

cd /path/to/project
bash ~/.claude/skills/mcp-setup/scripts/setup-all.sh

Verification

bash ~/.claude/skills/mcp-setup/scripts/verify-setup.sh

Optional environment

  • MCP_SERVERS_ROOT (default: $HOME/Documents/remote-claude/mcp-servers)
  • MCP_RUNTIME (codex or claude; auto-detected if unset)

Scripts

| Script | Purpose | |--------|---------| | scripts/setup-all.sh | Runtime-aware setup without cloning | | scripts/verify-setup.sh | Verify config and server paths | | scripts/install-token-efficient.sh | Legacy helper (optional) |