Skip to content

fix(docs): MCP tools are not slash commands#23

Open
hsuanchenlin wants to merge 1 commit intoluongnv89:mainfrom
hsuanchenlin:fix/mcp-tool-slash-command-clarification
Open

fix(docs): MCP tools are not slash commands#23
hsuanchenlin wants to merge 1 commit intoluongnv89:mainfrom
hsuanchenlin:fix/mcp-tool-slash-command-clarification

Conversation

@hsuanchenlin
Copy link
Copy Markdown

@hsuanchenlin hsuanchenlin commented Mar 30, 2026

Summary

  • MCP tools (e.g., mcp__github__list_pull_requests) are internal tools called by Claude, not user-facing slash commands
  • The documentation incorrectly shows /mcp__github__list_prs as a command users can type — this produces an Unknown skill error
  • Updated all 6 affected files to use natural language examples instead (e.g., "list my open pull requests")

Files Changed

  • 01-slash-commands/README.md — Clarified MCP prompts vs tools distinction
  • 05-mcp/README.md — Fixed "Use MCP tools" section and workflow example
  • INDEX.md — Fixed usage description
  • LEARNING-ROADMAP.md — Fixed exercise instruction
  • QUICK_REFERENCE.md — Fixed quick start example
  • claude_concepts_guide.md — Fixed table entry and workflow example

Test plan

  • Searched for all occurrences of mcp__github__list_prs and fixed each one
  • Verified the corrected instructions match actual Claude Code behavior
  • Review rendered markdown for formatting

🤖 Generated with Claude Code

MCP tools (like mcp__github__list_pull_requests) are internal tools
called by Claude, not user-facing slash commands. Updated all
documentation to show natural language usage instead of the incorrect
/mcp__github__list_prs syntax.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant