luna/oh-my-opencode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs(mcp): clarify plugin-injected MCPs do not appear in opencode mcp list (#3469)

Browse Source 
oh-my-openagent injects MCP servers (websearch, context7, grep_app) at
runtime via the OpenCode plugin API. The `opencode mcp list` command reads
only OpenCode's static config and therefore reports no servers even though
the plugin MCPs are active — this is expected, not a bug.

Add a "Native vs plugin-injected MCPs" subsection to docs/reference/features.md
that explains the three-tier architecture, shows the visibility table, and
points users to `bunx oh-my-openagent doctor --verbose` for runtime
inspection. Add brief inline notes in README.md at both MCP bullet points.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
ZeyuFu
2026-05-16 06:51:10 -04:00
parent fbc5768f9a
commit c5067d1e87
2 changed files with 37 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference/features.md
+35
View File
@@ -909,6 +909,41 @@ The plugin uses a three-tier MCP architecture:
2. Claude Code `.mcp.json` loader with `${VAR}` expansion
3. Skill-embedded MCP servers declared in `SKILL.md` frontmatter
### Native vs plugin-injected MCPs
oh-my-openagent injects MCP servers at **runtime** through the OpenCode plugin API. This is fundamentally different from MCP servers you configure directly in `opencode.json`.
Because `opencode mcp list` reads OpenCode's static configuration only, it **cannot see** MCPs that the plugin injects at runtime. This is expected behavior, not a bug:
```
# These are plugin-injected — they will NOT appear here
$ opencode mcp list
No MCP servers configured
```
To inspect which MCP servers oh-my-openagent is actually providing, run the doctor command:
```bash
bunx oh-my-openagent doctor --verbose
```
The three tiers of MCP servers and where they come from:
| Tier | Source | Visible in `opencode mcp list`? |
| ---- | ------ | ------------------------------- |
| 1 — Built-in | Injected at runtime by oh-my-openagent (`websearch`, `context7`, `grep_app`) | No |
| 2 — Claude Code `.mcp.json` | Loaded from `.mcp.json` files and merged in by oh-my-openagent at runtime | No |
| 3 — Skill-embedded | Declared in `SKILL.md` frontmatter, spun up on demand per session | No |
| — Native OpenCode | Configured directly in `opencode.json` under the `mcp` key, without the plugin | Yes |
**Disabling built-in MCPs**: Use `disabled_mcps` in your plugin config:
```jsonc
{
"disabled_mcps": ["websearch", "grep_app"]
}
```
### Built-in MCPs
| MCP | Description |