Back to Kilocode

MCP Servers Sub-Tab Parity

packages/kilo-vscode/docs/agent-behaviour/mcp-server-creation.md

7.2.402.9 KB
Original Source

MCP Servers Sub-Tab Parity

Priority: P2

The legacy MCP Servers sub-tab (842 lines) had full server lifecycle management. The new sub-tab supports viewing, removing, and toggling servers with live connection status.

Side-by-Side Comparison

FeatureLegacyNew
View server listName + source badge + status dotName + command/URL
Add serverVia edit config file buttonsNot available
Remove serverDelete button + confirmationRemove button + confirmation
Edit server configVia edit config file buttonsNot available
Connection statusColored dot (green/yellow/red)Live status display
Enable/disable toggleToggleSwitch per serverConnect/disconnect toggle
Restart/refreshPer-server refresh buttonNot available
Refresh all"Refresh All MCP Servers" buttonNot available
Edit Global MCP configButton to open fileNot available
Edit Project MCP configButton to open fileNot available
Network timeoutPer-server dropdown (15s–60min)Not available
Server source badgeShows "global" / "project"Not displayed
Empty stateN/A"No MCP servers configured. Edit the opencode config file..."

Expandable Server Detail (Legacy Only)

When a server was connected and enabled, expanding it showed 5 tabs:

TabContent
ToolsList of MCP tools with tool count
ResourcesList of resources + resource templates with count
InstructionsServer-provided instruction text (if present)
LogsError/log entries sorted by timestamp with count
AuthOAuth debug info: auth status, token expiration, scopes, refresh info

The new extension has none of this expandable detail.

Remaining Work

Important (P2)

  • Add MCP Server dialog: Form to define a new server with name, transport type (stdio/SSE), command+args or URL, environment variables. Write to CLI config via updateConfig()
  • Edit MCP Server: Allow modifying existing server configurations
  • Restart/refresh button: Per-server and "refresh all" buttons. Requires CLI endpoint to restart MCP servers
  • Edit config file buttons: Quick links to open global/project MCP config in the editor

Nice to Have (P3)

  • Expandable server detail: Show tools, resources, instructions, and logs per server when expanded. Requires CLI to expose per-server tool/resource/log data
  • Network timeout per server: If CLI supports per-server timeout config, expose it
  • Server source badge: Display whether server comes from global or project config
  • OAuth/Auth tab: Display auth status for OAuth-based MCP servers (depends on CLI support)

Notes

The mcp-and-mcp-hub.md doc in non-agent-features/ tracks MCP configuration as a broader feature. This doc focuses specifically on the MCP Servers sub-tab within the Agent Behaviour settings tab. The Marketplace covers MCP server discovery and installation from a registry.