docs(reference): MCP section (built-in v5.1 server)#507
Open
kylebernhardy wants to merge 5 commits into
Open
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. |
11 tasks
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. |
4 tasks
kriszyp
added a commit
that referenced
this pull request
Jun 11, 2026
The release-notes and reference doc plugins are separate; relative .md links between them resolve incorrectly. Removing until PR #507 (MCP reference section) merges and can be linked with an absolute path. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
kriszyp
added a commit
that referenced
this pull request
Jun 13, 2026
* docs(v5.1): release notes, deployment tracking ops, deploy_component updates - Add 5.1.md release notes covering: models/AI, @embed directive, MCP server, deployment tracking, HNSW int8 quantization, and replication improvements - Update deploy_component docs: urlPath, install_allow_scripts params, deployment_id response - Document new deployment operations: list_deployments, get_deployment, get_deployment_payload, delete_deployment_payload - Document hdb_deployment record schema (fields, phases, peer_results) Note: models/AI detail, MCP reference, and HNSW quantization have separate PRs (#523, #507/#516, #508) — this PR adds the release notes overview and the deployment tracking operations which had no coverage. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * style: run prettier on changed files Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: remove cross-plugin MCP link that breaks Docusaurus build The release-notes and reference doc plugins are separate; relative .md links between them resolve incorrectly. Removing until PR #507 (MCP reference section) merges and can be linked with an absolute path. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs(5.1): expand release notes — middleware/routing, caching, LOCAL_ONLY, HARPER_CONFIG, RocksDB, migrateOnStart, upgrade improvements --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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