[DOCS] VS Code docs are outdated for session list spark icon, plan markdown comments, and `/mcp` management dialog

Resolved 💬 3 comments Opened Mar 6, 2026 by coygeek Closed Mar 7, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/vs-code

Section/Topic

VS Code workflow and MCP management guidance for new extension UI capabilities in v2.1.70.

Current Documentation

The page currently describes multi-conversation flow as:

Use Open in New Tab or Open in New Window from the Command Palette to start additional conversations.

It also currently states MCP setup/auth is terminal-first:

Configure them via CLI, then use them in both extension and CLI.
Some servers require authentication: run claude in the terminal, then type /mcp to authenticate.

What's Wrong or Missing?

A. Session list Spark icon behavior is missing

v2.1.70 adds an Activity Bar spark icon that lists all Claude Code sessions and opens sessions as full editors.

B. Plan markdown document view with comments is missing

v2.1.70 adds full markdown plan document view with comment support, but current docs only describe general plan review/editing.

C. MCP management dialog guidance is outdated

v2.1.70 adds a native MCP management dialog in the chat panel (/mcp) for enable/disable, reconnect, and OAuth flows, but docs still direct users to terminal-first management/authentication.

Suggested Improvement

Update the VS Code page with a dedicated section for v2.1.70 extension UX:

  1. Activity Bar spark icon session list and full-editor session opening behavior.
  2. Plan markdown document view and how comments are added.
  3. Native MCP management dialog workflow in chat panel (/mcp) including reconnect and OAuth flows, with terminal usage as optional fallback.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/vs-code | 13, 149-153, 305-315 | Multi-session guidance and MCP instructions do not cover new session list, plan markdown comments, or native MCP dialog workflows |
| https://code.claude.com/docs/en/interactive-mode | 125 | /mcp command is documented generically, but extension-specific chat-panel management flow is not linked from VS Code docs |

Total scope: 2 pages affected

Source: Release v2.1.70

  • [VSCode] Added spark icon in VS Code activity bar that lists all Claude Code sessions, with sessions opening as full editors
  • [VSCode] Added full markdown document view for plans in VS Code, with support for adding comments to provide feedback
  • [VSCode] Added native MCP server management dialog — use /mcp in the chat panel to enable/disable servers, reconnect, and manage OAuth authentication without switching to the terminal

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗