Refine the MCP server content

Signed-off-by: popcorny <[email protected]>

Author: popcornylu

docs/5-data-diffing/mcp-server.md

@@ -2,14 +2,31 @@
 title: MCP Server
 ---
 
-Recce allows you to expose its tools to AI agents for integration. Here's how to use Claude Code to integrate with Recce.
+Recce exposes its tools to AI agents, enabling integration with tools like Claude Code. This allows you to interact with Recce analysis through natural language queries directly in your Claude Code sessions.
 
 
-## Method 1: MCP Server
+## Installation
 
-To use Recce in Claude Code, add an MCP server to your project. Claude Code will launch the MCP server when the session starts.
+1. Install Recce with the MCP extra dependency:
 
-1. Add Recce to your dbt project
+   ```shell
+   pip install 'recce[mcp]'
+   ```
+
+2. Verify the MCP server works by starting it in your dbt project:
+
+   ```shell
+   cd my-dbt-project/
+   recce mcp-server
+   ```
+
+   You should see the message: `Starting Recce MCP Server in stdio mode...` Stop the server with `Ctrl+C` once confirmed.
+
+## Method 1: MCP Server (stdio)
+
+Configure Recce as an MCP server with stdio transport. Claude Code will automatically launch the MCP server when you start a session.
+
+1. Configure the MCP server for your dbt project:
 
     ```shell
     claude mcp add --scope project recce -- recce mcp-server
@@ -29,28 +46,28 @@ To use Recce in Claude Code, add an MCP server to your project. Claude Code will
 
 ## Method 2: MCP Server (SSE)
 
-Alternatively, you can launch a standalone MCP server. Claude Code will connect to it using HTTP-SSE.
+Alternatively, launch a standalone MCP server that Claude Code connects to via HTTP-SSE. This requires running the server in a separate terminal.
 
-1. Add Recce to your dbt project
+1. Configure the MCP server for your dbt project:
 
     ```shell
     claude mcp add --transport sse --scope project recce http://localhost:8000/sse
     ```
 
-2. Launch the standalone MCP server with HTTP-SSE
+2. In a separate terminal, start the standalone MCP server:
 
     ```shell
     cd my-dbt-project/
     recce mcp-server --sse
     ```
 
-3. Run Claude Code
+3. In your original terminal, run Claude Code:
 
     ```shell
     claude
     ```
 
-4. Ask Claude Code about your changes
+4. Ask Claude Code about your changes:
 
     ```shell
     > Understand changes from Recce.