docs(reference): MCP section (built-in v5.1 server)#507
Conversation
Documents the v5.1 first-class built-in MCP server, covering: - Overview: protocol versions, the two profiles (operations + application), capability surface - Configuration: every knob under mcp.operations / mcp.application / mcp.session with Type/Default/Description in the established format - CLI: harper mcp bridge / print-config / doctor subcommands, UDS vs network connect modes, credential precedence including saved-JWT fallback from harper login - Tools and Resources: how operations-profile tools are generated from OPERATION_FUNCTION_MAP, why get_* is NOT a default-allowed glob, application-profile Resource walker rules including attribute_permissions narrowing and exportTypes.mcp gating, harper:// + https:// resources surface, listChanged notification semantics - Migration: stepwise migration from the deprecated HarperFast/mcp-server external addon to the built-in MCP server Wired into sidebarsReference.ts as a new top-level MCP category between HTTP and Security. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces comprehensive documentation for the new built-in Model Context Protocol (MCP) support in Harper (v5.1.0), covering its overview, configuration, CLI, tools and resources, and migration steps, along with sidebar updates. The review feedback provides minor but helpful suggestions to improve the documentation's clarity, grammar, and navigation, such as adding internal markdown links and refining phrasing.
🚀 Preview DeploymentYour preview deployment is ready! 🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-507 This preview will update automatically when you push new commits. |
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
🚀 Preview DeploymentYour preview deployment is ready! 🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-507 This preview will update automatically when you push new commits. |
1 participant
Summary
New MCP reference section covering the first-class built-in MCP server that landed in v5.1. Five docs under
reference/mcp/:mcp.operations,mcp.application,mcp.sessionin the established Type/Default/Description format. Documents the rationale for the narrower-than-expected default-allow list (explicit safe getters instead ofget_*glob).harper mcpsubcommands (bridge / print-config / doctor), UDS vs network connect modes, credential precedence including the saved-JWT fallback fromharper login. Paste-ready client config blocks for Claude Desktop, Cursor, Zed.operations, Resources walker withattribute_permissionsnarrowing andexportTypes.mcpgating forapplication), theharper://+https://resources surface, andnotifications/*/list_changedsemantics including the per-session re-resolution behavior.HarperFast/mcp-serverexternal addon to the built-in server.Wired into
sidebarsReference.tsas a new top-level MCP category between HTTP and Security.Where to look
reference/mcp/configuration.md— the parameter tables drive Type/Default values directly fromvalidation/configValidator.tsin harper. Worth a sanity check that defaults match.reference/mcp/tools-and-resources.md— theget_*rationale and the application-profile generation rules are the load-bearing content; please confirm the framing matches the implementation as merged in #856 + #888.sidebarsReference.ts— only adds a new category; doesn't reshuffle existing entries.Companion PR
This documents the work merged in HarperFast/harper#856 (server-side tools surface) and being reviewed in HarperFast/harper#888 (CLI + follow-ups). Best read alongside.
Test plan
npm run buildclean (376 documents processed).npm run format:writeclean.🤖 Generated with Claude Code