MCP Editor
Inspect, edit, test, and refresh a selected MCP server.
Overview
| Property | Value |
|---|---|
| Key | editor_mcp |
| Category | Editor |
The MCP Editor lets you inspect, configure, test, and refresh a Model Context Protocol server attached to your workspace. It displays the server's connection status, configuration, discovered tools, and current test or save errors. Use the MCP Server List widget to add or remove servers; the editor is the primary interface for managing an individual server's configuration.
Features
- Server info header shows the server name, a color-coded connection status badge (Connected / Error / Disconnected), and the transport type (e.g. HTTP, SSE).
- Server form lets you edit the name, description, transport, URL, custom headers, timeout, retries, enabled state, and stored command, arguments, and environment values. Command, arguments, environment values, and retries are preserved but are not used by the current URL transport runtime.
- Test connection button sends a test request to the server with the current form values and displays the result inline.
- Refresh tools button triggers a server-side refresh that re-discovers all tools exposed by the MCP server and updates the local tool list.
- Reset form button reverts the form fields back to the last-saved server configuration.
- Save button persists the updated server settings and refreshes tools when the server is enabled and has a URL. Testing is a separate action.
- Clear selection button deselects the current server.
- Tools list enumerates every tool discovered from the server, showing each tool's name and description.
- Error panel displays errors from save or tool-refresh operations.
- Server selector in the header bar switches between MCP servers in the workspace. When paired via a color link, it syncs with the MCP List widget.
Usage
- Add the widget to a workspace from the widget picker.
- Select an MCP server from the header dropdown, or add one from the MCP Server List widget.
- Review the connection status and transport at the top.
- Edit the server configuration as needed.
- Click Test connection to verify the server is reachable with the current settings.
- Click Refresh tools to re-discover the tools the server exposes.
- Click Save to persist changes and refresh tools. Run Test connection separately when you need to verify connectivity.
Header Actions
The header toolbar provides five action buttons (left to right):
| Button | Icon | Action |
|---|---|---|
| Refresh tools | Rotate | Re-discovers tools from the server |
| Test connection | Play | Sends a test request with current form values |
| Reset form | Undo | Reverts form to last-saved values |
| Save server | Save | Persists config and refreshes tools for an enabled server with a URL |
| Clear selection | X | Deselects the server |
This widget supports the pairColor mechanism. Assign the same color to an MCP Editor and an MCP Server List widget so that selecting a server in the list automatically opens it in the editor.
Configuration
The selected server is stored in widget params as mcpServerId and synced through the pair-color store when linked. Form edits update the collaborative Yjs draft immediately; click Save to persist that draft as the saved server configuration.