Connect Claude Code

Add PMM Sherpa to Claude Code via CLI or config file.

Claude Code is a first-class MCP client. Both the CLI and the IDE extensions share the same config.

One-line install#

claude mcp add --transport http pmm-sherpa https://pmmsherpa.com/api/mcp

That writes the entry into ~/.claude.json for you.

Manual config#

If you prefer to edit the file by hand, open ~/.claude.json (user-global) or .mcp.json (project-local) and add:

{
  "mcpServers": {
    "pmm-sherpa": {
      "type": "http",
      "url": "https://pmmsherpa.com/api/mcp"
    }
  }
}

Verify#

Inside Claude Code, run:

/mcp

You should see pmm-sherpa listed. The first tool call triggers a browser OAuth flow. Subsequent sessions reuse the cached token.

The MCP connector exposes the four tools. The skill is what makes Claude Code auto-fire Sherpa on PMM keywords, route to the correct tool, and enforce Layer 4 voice in every response.

git clone https://github.com/boommark/pmmsherpa-mcp.git ~/.pmm-sherpa
mkdir -p ~/.claude/skills
ln -s ~/.pmm-sherpa/skills/claude-code ~/.claude/skills/pmm-sherpa

The skill is now available across every project. Updates land instantly when you git pull in ~/.pmm-sherpa.

Per-project install#

mkdir -p .claude/skills
git clone https://github.com/boommark/pmmsherpa-mcp.git /tmp/pmm-sherpa-repo
cp -r /tmp/pmm-sherpa-repo/skills/claude-code .claude/skills/pmm-sherpa
rm -rf /tmp/pmm-sherpa-repo

Verify#

In a new Claude Code session, prompt:

> See pmmsherpa.com. Help me create a battlecard against its top competitor.

You should see Skill(pmm-sherpa) load, followed by a Calling PMM Sherpa… tool call (mcp__pmm-sherpa__ask_sherpa or draft_artifact). Response in Layer 4 voice.

<img src="/pmmsherpa_mcp_claudecode.png" alt="PMM Sherpa skill auto-triggering in Claude Code" />

Auth#

Browser OAuth, handled automatically on first use. No tokens to paste.

Troubleshooting#

  • pmm-sherpa not in /mcp: confirm the JSON above is valid (commas, braces). Restart Claude Code after editing.
  • OAuth window does not open: make sure pop-ups are allowed for pmmsherpa.com and re-run any tool call.
  • 401 / token expired: run claude mcp remove pmm-sherpa then re-add. Tokens refresh automatically thereafter.
  • Want staging: replace the URL with https://staging.pmmsherpa.com/api/mcp. Staging requires a separate login.

Next steps#

Back to top

PreviousConnect Claude.aiNext Connect ChatGPT