[docs] Update documentation for features from 2026-05-16#1352
Open
danielmeppiel wants to merge 1 commit into
Open
[docs] Update documentation for features from 2026-05-16#1352danielmeppiel wants to merge 1 commit into
danielmeppiel wants to merge 1 commit into
Conversation
danielmeppiel
added
automation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the troubleshooting catalog to document recent MCP install and registry behavior changes.
Changes:
- Clarifies greenfield fail-closed behavior for MCP install.
- Adds troubleshooting guidance for MCP registry server-not-found errors and v0.1 registry migration.
Show a summary per file
| File | Description |
|---|---|
docs/src/content/docs/troubleshooting/common-errors.md |
Updates common error guidance for harness detection and MCP registry lookup failures. |
Copilot's findings
Comments suppressed due to low confidence (1)
docs/src/content/docs/troubleshooting/common-errors.md:150
- The Copilot harness marker example is inaccurate: target detection recognizes
.github/copilot-instructions.mdas the Copilot signal, not a.github/copilot/directory. Leaving the wrong marker here can lead users to create a directory that does not resolve theNo harness detectederror.
Cause: the project has no harness markers (`.github/copilot/`, `.claude/`, `.cursor/`, ...) and no `targets:` block in `apm.yml`. APM fails closed rather than defaulting to copilot. This applies to both `apm compile` and `apm install --mcp` (MCP install now uses the same fail-closed behavior as `apm install` for any other dependency type).
- Files reviewed: 1/1 changed files
- Comments generated: 2
| Fix: pass `--target <harness>` on the command, or declare `targets:` in `apm.yml`. Run `apm targets` to list supported harnesses. | ||
|
|
||
| See also: [../reference/cli/targets/](../reference/cli/targets/), [../reference/targets-matrix/](../reference/targets-matrix/) | ||
| See also: [../reference/cli/targets/](../reference/cli/targets/), [../reference/targets-matrix/](../reference/targets-matrix/), [../../consumer/install-mcp-servers/](../../consumer/install-mcp-servers/) |
| ``` | ||
|
|
||
| Cause: the project has no harness markers (`.github/copilot/`, `.claude/`, `.cursor/`, ...) and no `targets:` block in `apm.yml`. APM no longer defaults to copilot. | ||
| Cause: the project has no harness markers (`.github/copilot/`, `.claude/`, `.cursor/`, ...) and no `targets:` block in `apm.yml`. APM fails closed rather than defaulting to copilot. This applies to both `apm compile` and `apm install --mcp` (MCP install now uses the same fail-closed behavior as `apm install` for any other dependency type). |
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
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.
Documentation Updates - 2026-05-16
This PR updates the documentation based on features merged in the last 24 hours.
Features Documented
ServerNotFoundErrorwith v0.1 hint for self-hosted registries (from fix(registry): migrate SimpleRegistryClient to MCP Registry v0.1 spec (#1210) #1337)apm install --mcpnow fails closed on greenfield projects, matchingapm installbehavior (from fix: respect targets: whitelist for all runtimes during MCP install #1336)Changes Made
docs/src/content/docs/troubleshooting/common-errors.md:[x] No harness detectedentry to clarify thatapm install --mcpnow fails closed with the sameNoHarnessErrorasapm install(PR fix: respect targets: whitelist for all runtimes during MCP install #1336 parity fix)Server '<name>' not found in registry <url>entry documenting the typedServerNotFoundErrorwith actionable v0.1 migration guidance for self-hosted registry operators (PR fix(registry): migrate SimpleRegistryClient to MCP Registry v0.1 spec (#1210) #1337)Merged PRs Referenced
/v0/paths; newServerNotFoundErrorcarries a one-sentence v0.1 hinttargets:whitelist for all runtimes during MCP install -- greenfield projects now fail closed withNoHarnessErrorinstead of silently writing to~/.copilot/mcp-config.jsonNotes
PRs #1337 and #1336 already updated their primary docs (
reference/cli/mcp.md,consumer/install-mcp-servers.md,reference/targets-matrix.md). This PR fills the remaining gap in the troubleshooting catalog so operators encountering the new error messages can find them with a quick page search.Note
🔒 Integrity filter blocked 1 item
The following item was blocked because it doesn't meet the GitHub integrity level.
search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".To allow these resources, lower
min-integrityin your GitHub frontmatter: