-
Notifications
You must be signed in to change notification settings - Fork 125
Closed
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Description
Several HVE-Core agents reference MCP (Model Context Protocol) tools for Azure DevOps, GitHub, Context7, and Microsoft Docs integration. However, none of the 7 installation method docs mention MCP configuration, leaving users without guidance on how to enable these features.
Problem
- Agents like
ado-prd-to-wit,github-issue-manager,task-researcher, andtask-plannerreference MCP tools - Users installing via any method (Extension, Peer Clone, Codespaces, etc.) have no documentation on MCP setup
- The existing
.vscode/README.mdhas good MCP auth docs but isn't discoverable from installation guides - Users don't know they should configure either GitHub OR ADO based on their repo hosting (not both)
Proposed Solution
-
Create
docs/getting-started/mcp-configuration.md- Central guide with:- Overview of MCP as optional enhancement (not required)
- Table of agents and their MCP dependencies
- Complete mcp.json template with all 4 curated servers (github, ado, context7, microsoft-docs)
- Guidance: configure GitHub OR ADO based on repo hosting
- Note: other Git/work item systems not documented
-
Update each installation method doc with brief MCP section linking to central guide
-
Update
hve-core-installer.agent.mdto add "Checkpoint 4: MCP Configuration Guidance" after the gitignore checkpoint, ensuring all users see post-installation MCP guidance
Curated MCP Servers
| Server | Type | Purpose |
|---|---|---|
| github | http | GitHub repos/issues |
| ado | stdio | Azure DevOps work items/pipelines |
| context7 | stdio | Library/SDK documentation |
| microsoft-docs | http | Microsoft Learn docs |
Affected Files
New:
docs/getting-started/mcp-configuration.md
Updates needed:
.github/agents/hve-core-installer.agent.md(add Checkpoint 4)docs/getting-started/methods/extension.mddocs/getting-started/methods/codespaces.mddocs/getting-started/methods/peer-clone.mddocs/getting-started/methods/submodule.mddocs/getting-started/methods/git-ignored.mddocs/getting-started/methods/mounted.mddocs/getting-started/methods/multi-root.mddocs/contributing/custom-agents.md
Key Decisions
- MCP is optional, not imposed
- Template only in central guide (not duplicated in method docs)
- Users configure GitHub OR ADO, not both
- Other Git/work item platforms not documented
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request