[docs] Update documentation for --validate-actor flag in mcp-server command

[github-actions]

Documentation Updates - 2026-02-12

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

Features Documented

• --validate-actor flag for mcp-server command (from Add support for GITHUB_ACTOR and GITHUB_REPOSITORY environment variables with --validate-actor flag in mcp-server command #15084)
• GITHUB_ACTOR environment variable support for actor identification
• GITHUB_REPOSITORY environment variable support for repository context
• Permission requirements for logs and audit tools (write+ access)
• Runtime permission checking via GitHub API with 1-hour caching
• Error messages for missing actors and insufficient permissions

Changes Made

• Updated docs/src/content/docs/setup/mcp-server.md:

  • Added new "Actor Validation" section under Configuration Options
  • Documented --validate-actor flag behavior and requirements
  • Included environment variable usage (GITHUB_ACTOR, GITHUB_REPOSITORY)
  • Added permission requirements and error message examples
  • Explained caching strategy and API endpoints used

• Updated docs/src/content/docs/setup/cli.md:

  • Added --validate-actor to mcp-server command options
  • Documented actor validation behavior
  • Added brief explanation of permission checking and caching

Merged PRs Referenced

• Add support for GITHUB_ACTOR and GITHUB_REPOSITORY environment variables with --validate-actor flag in mcp-server command #15084 - Add support for GITHUB_ACTOR and GITHUB_REPOSITORY environment variables with --validate-actor flag in mcp-server command

Notes

The documentation follows reference style as this is a CLI command option. The content provides:

• Clear technical descriptions of the flag and its behavior
• Environment variable requirements
• Permission checking details
• Error message examples for troubleshooting
• Caching strategy information

All changes maintain consistency with existing documentation style and structure.

AI generated by Daily Documentation Updater

• expires on Feb 13, 2026, 3:11 PM UTC