Skip to content

[docs] Add permission handling guidance to MCP documentation#19

Closed
github-actions[bot] wants to merge 1 commit intomainfrom
docs/mcp-permission-handling-2026-02-19-58f32e59ed3b5f6f
Closed

[docs] Add permission handling guidance to MCP documentation#19
github-actions[bot] wants to merge 1 commit intomainfrom
docs/mcp-permission-handling-2026-02-19-58f32e59ed3b5f6f

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Documentation Updates - 2026-02-19

This PR updates the MCP documentation to address a critical gap: users configuring MCP servers need to understand the deny-by-default permission model introduced in PR #18.

Features Documented

Changes Made

  • doc/mcp/overview.md:

    • Added prominent warning at top about deny-by-default permissions with link to Permission Handling section
    • Added new "Permission Handling" section with:
      • Overview of deny-by-default model for MCP tools
      • approve-all usage example
      • Custom permission handler example
      • Link to full API reference
    • Updated all code examples to include :on-permission-request copilot/approve-all
  • doc/mcp/debugging.md:

    • Updated code examples to include :on-permission-request copilot/approve-all
  • CHANGELOG.md:

    • Added entry documenting MCP documentation improvements

Merged PRs Referenced

Validation

The documentation follows the style guide:

  • ✅ Code-first examples with working Clojure code
  • ✅ Uses standard aliases (copilot, h)
  • ✅ Direct tone with imperative mood
  • ✅ Progressive disclosure (approve-all first, then custom handlers)
  • ✅ All code examples are valid and parseable

Notes

This documentation change is critical for users setting up MCP servers, as they will encounter permission denials without guidance on the new deny-by-default model. All MCP examples now demonstrate the recommended pattern.

AI generated by Daily Documentation Updater

  • expires on Feb 20, 2026, 12:52 PM UTC

- Add prominent warning at top of MCP overview about deny-by-default permissions
- Add new 'Permission Handling' section with approve-all and custom handler examples
- Update all MCP code examples to include :on-permission-request copilot/approve-all
- Updated both doc/mcp/overview.md and doc/mcp/debugging.md
- Updated CHANGELOG.md with documentation improvements

This addresses documentation gap where MCP examples would fail due to
permission denials without guidance on the deny-by-default model
introduced in PR #18.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Feb 19, 2026
@github-actions github-actions Bot enabled auto-merge February 19, 2026 12:52
@github-actions
Copy link
Copy Markdown
Contributor Author

This pull request was automatically closed because it expired on 2026-02-20T12:52:45.308Z.

Closed by Workflow

@github-actions github-actions Bot closed this Feb 20, 2026
auto-merge was automatically disabled February 20, 2026 13:44

Pull request was closed

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