Simplify MCP Server documentation

Focus on practical usage with Claude Code integration.
Remove technical details (protocol specs, tool lists, security notes).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: 2 people

content/en/usage/mcp-server.md

@@ -3,175 +3,69 @@ title: MCP Server - AI Agent Integration
 weight: 26
 ---
 
-Lem includes an MCP (Model Context Protocol) server that allows AI agents like Claude Code to interact with the editor. Through this server, AI tools can read and edit buffers, execute commands, and access resources.
+Lem includes an MCP (Model Context Protocol) server that allows AI agents like Claude Code to interact with the editor. Through this server, AI can read and edit your buffers directly within Lem.
 
-## Overview
+## Using with Claude Code
 
-The MCP server exposes Lem's functionality via HTTP endpoints using the JSON-RPC protocol. This enables:
+### 1. Start the MCP Server
 
-- **Buffer operations**: Create, read, edit, and delete buffers
-- **Text editing**: Insert, replace, and delete text at specific positions
-- **Command execution**: Run any Lem command programmatically
-- **Resource access**: Read files and buffer contents
-
-## Getting Started
-
-### Starting the Server
-
-Start the MCP server in Lem:
+In Lem, run:
 
 ```
 M-x mcp-server-start
 ```
 
-You'll be prompted for hostname and port. Press Enter to use defaults:
-- **Hostname**: 127.0.0.1
-- **Port**: 7890
+Press Enter twice to use the default settings (localhost:7890).
 
-### Registering with Claude Code
+### 2. Register with Claude Code
 
-After starting the server, register it with Claude Code:
+In your terminal:
 
 ```bash
 claude mcp add --transport http lem http://localhost:7890/mcp
 ```
 
-Verify the connection:
+### 3. Start Using
 
-```bash
-claude mcp list
-```
+Now when you use Claude Code, it can directly edit files open in Lem. For example:
 
-### Testing the Connection
+- "Edit the function in my current buffer"
+- "Add error handling to this code"
+- "Refactor this file"
 
-You can test the server with curl:
-
-```bash
-curl -X POST http://localhost:7890/mcp \
-  -H "Content-Type: application/json" \
-  -H "Mcp-Protocol-Version: 2024-11-05" \
-  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
-```
+Claude Code will use Lem's buffers instead of reading/writing files directly.
 
 ## Server Commands
 
 | Command | Description |
 |---------|-------------|
-| `mcp-server-start` | Start the MCP server |
-| `mcp-server-stop` | Stop the running server |
-| `mcp-server-status` | Show server URL and active sessions |
-| `mcp-server-restart` | Restart with new configuration |
-| `mcp-server-toggle-logging` | Toggle debug logging to `*mcp-log*` buffer |
-
-## Available Tools
-
-### Buffer Operations
-
-| Tool | Description |
-|------|-------------|
-| `buffer_list` | Get list of all buffers |
-| `buffer_get_content` | Get buffer content (with optional line range) |
-| `buffer_create` | Create new buffer with optional initial content |
-| `buffer_delete` | Delete a buffer |
-| `buffer_info` | Get buffer info (name, filename, line count, cursor) |
-
-### Editing Operations
-
-| Tool | Description |
-|------|-------------|
-| `buffer_insert` | Insert text at position (line, column) |
-| `buffer_replace` | Replace text in region |
-| `buffer_delete_region` | Delete text in region |
-| `buffer_set_content` | Replace entire buffer content |
-| `buffer_save` | Save buffer to file |
-
-### Command Operations
-
-| Tool | Description |
-|------|-------------|
-| `command_list` | List available commands (with optional prefix filter) |
-| `command_execute` | Execute a command with arguments |
-| `command_info` | Get command information |
-| `eval_expression` | Evaluate Lisp expression |
-
-## Use Cases
-
-### AI-Assisted Coding with Claude Code
-
-Once connected, Claude Code can directly edit your code in Lem:
-
-1. Start Lem and the MCP server
-2. Register the server with Claude Code
-3. Ask Claude to edit files - it will use Lem's buffers directly
-
-### Remote Editor Control
+| `mcp-server-start` | Start the server |
+| `mcp-server-stop` | Stop the server |
+| `mcp-server-status` | Show server status |
+| `mcp-server-restart` | Restart the server |
 
-The MCP server enables remote control of Lem for:
-- Automation scripts
-- IDE integrations
-- Custom tooling
+## Troubleshooting
 
-### Collaborative Editing
-
-Multiple AI agents or tools can connect to the same Lem instance, enabling collaborative workflows.
-
-## Configuration
-
-### Custom Port
-
-Start the server on a different port:
-
-```
-M-x mcp-server-start
-Hostname: 127.0.0.1
-Port: 8080
-```
-
-### Listen on All Interfaces
-
-To allow remote connections (use with caution):
+### Check Server Status
 
 ```
-M-x mcp-server-start
-Hostname: 0.0.0.0
-Port: 7890
+M-x mcp-server-status
 ```
 
-### Debugging
+This shows the server URL and number of connected sessions.
 
-Enable logging to see MCP requests and responses:
+### Enable Debug Logging
 
 ```
 M-x mcp-server-toggle-logging
 ```
 
-View logs in the `*mcp-log*` buffer.
-
-## Protocol Details
-
-The server implements **MCP 2024-11-05** specification:
-
-- **Transport**: HTTP with JSON-RPC 2.0
-- **Server Name**: lem-mcp-server
-- **Server Version**: 0.1.0
-
-### Supported Methods
+View logs in the `*mcp-log*` buffer with `C-x b *mcp-log*`.
 
-**Lifecycle**:
-- `initialize` / `notifications/initialized`
-- `shutdown` / `exit`
-- `ping`
+### Verify Claude Code Connection
 
-**Tools**:
-- `tools/list`
-- `tools/call`
-
-**Resources**:
-- `resources/list`
-- `resources/read`
-
-## Security Considerations
+```bash
+claude mcp list
+```
 
-- By default, the server only listens on localhost (127.0.0.1)
-- No authentication is required - ensure your firewall is configured appropriately
-- Avoid exposing the server to untrusted networks
+The `lem` server should appear in the list.