Document "GitLab: Show MCP Dashboard" command in user documentation

Summary

The GitLab: Show MCP Dashboard command was introduced in v6.55.0 (pre-release, 2025-11-06) but is not documented in the official GitLab documentation at https://docs.gitlab.com/user/gitlab_duo/model_context_protocol/mcp_clients/

Current Documentation Gap

The MCP clients documentation currently covers:

  • ✅ GitLab MCP: Open User Settings (JSON) command
  • ✅ GitLab MCP: Open Workspace Settings (JSON) command
  • ✅ Configuration format and examples
  • ✅ Troubleshooting MCP servers
  • ❌ Missing: GitLab: Show MCP Dashboard command

What Needs Documentation

Command Details

  • Command ID: gl.webview.root.mcp.show
  • Title: "Show MCP Dashboard"
  • Category: GitLab
  • Access: Command Palette (Ctrl+Shift+P → "GitLab: Show MCP Dashboard")
  • Type: Editor-area webview (opens as a tab)
  • Availability: VSCode extension v6.55.0+

Functionality to Document

  1. Purpose: Visual interface to view and manage configured MCP servers

  2. What it displays:

    • List of configured MCP servers (from user + workspace configs)
    • Server connection status (Connected, Authenticating, Failed, etc.)
    • Server configuration details
    • Available tools from each server
    • Connection logs and error messages

  3. User workflows:

    • View all configured MCP servers at a glance
    • Monitor server connection health
    • Access configuration files quickly
    • Debug MCP server issues

Suggested Documentation Location

Add a new section to doc/user/gitlab_duo/model_context_protocol/mcp_clients.md:

## View MCP server status

To view the status of your configured MCP servers:

1. In VS Code, open the Command Palette by pressing:
   - On macOS: <kbd>Command</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>
   - On Windows or Linux: <kbd>Control</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>
1. Run the command `GitLab: Show MCP Dashboard`.

The MCP Dashboard opens in a new editor tab and displays:

- All configured MCP servers from user and workspace configurations
- Connection status for each server
- Available tools and resources
- Connection logs and error messages

Use this dashboard to:
- Verify your MCP servers are connected
- Troubleshoot connection issues
- View which tools are available to GitLab Duo

Technical Details

Code References

  • Command registration: desktop.package.json (lines 361-364)
  • Webview ID: root/mcp (defined in src/common/constants.ts)
  • Setup handler: src/common/webview/setup_webviews.ts
  • Language Server plugin: src/node/main.ts (lines 330-340)

Related Commits

Acceptance Criteria

  • Documentation added to doc/user/gitlab_duo/model_context_protocol/mcp_clients.md
  • Screenshots/GIFs showing the MCP Dashboard UI
  • Cross-references to related commands (Open User Settings, Open Workspace Settings)
  • Troubleshooting section for common dashboard issues
  • Version compatibility note (requires v6.55.0+)

Labels

documentation ~"Category:GitLab Duo" typefeature ~"MCP"

Related Issues/MRs