Skip to content

[docs] Update MCP client documentation for global scope and missing runtimes#796

Draft
danielmeppiel wants to merge 2 commits intomainfrom
docs/global-mcp-scope-2026-04-21-5f98649b6988e2e8
Draft

[docs] Update MCP client documentation for global scope and missing runtimes#796
danielmeppiel wants to merge 2 commits intomainfrom
docs/global-mcp-scope-2026-04-21-5f98649b6988e2e8

Conversation

@danielmeppiel
Copy link
Copy Markdown
Collaborator

Documentation Updates - 2026-04-21

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

Changes Made

  • Updated docs/src/content/docs/integrations/ide-tool-integration.md:
    • Added Cursor (.cursor/mcp.json) and OpenCode (opencode.json) as workspace-only MCP runtimes to the Client Configuration table (both were missing)
    • Added a "Global (-g)" column to the Client Configuration table clarifying which runtimes support apm install --global for MCP deployment
    • Added an explanatory paragraph noting why workspace-only runtimes are skipped at user scope
    • Expanded the Supported Package Types table to include Cursor and OpenCode columns

Merged PRs Referenced

Notes

The behavioral changes from #638 were already reflected in:

  • CHANGELOG.md (Unreleased section)
  • docs/src/content/docs/reference/cli-commands.md:98
  • docs/src/content/docs/guides/dependencies.md:336

This PR fills the remaining gap in ide-tool-integration.md where the MCP client table was incomplete (missing Cursor, OpenCode) and lacked the global scope indicator column.

Generated by Daily Documentation Updater ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295
  • expires on Apr 23, 2026, 3:53 AM UTC

… column

Update the MCP Client Configuration and Supported Package Types tables
in ide-tool-integration.md to:

- Add Cursor (.cursor/mcp.json) and OpenCode (opencode.json) as
  workspace-only MCP runtimes (missing from both tables)
- Add a 'Global (-g)' column indicating which runtimes support
  apm install --global for MCP server deployment
  (Copilot CLI and Codex CLI: Yes; VS Code, Cursor, OpenCode: No)
- Add an explanatory note clarifying why workspace-only runtimes
  are skipped at user scope

Reflects behavior introduced in #638 where MCP global scope filtering
was made explicit via supports_user_scope on each adapter.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@danielmeppiel danielmeppiel added automation documentation Improvements or additions to documentation labels Apr 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant