Skip to content

Commit d935fb8

Browse files
committed
Update doc per review
Signed-off-by: popcorny <[email protected]>
1 parent f6a3c52 commit d935fb8

File tree

1 file changed

+25
-9
lines changed

1 file changed

+25
-9
lines changed

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

Lines changed: 25 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,14 @@ Install Recce with the MCP extra dependency:
1313
pip install 'recce[mcp]'
1414
```
1515

16-
## Method 1: MCP Server (stdio)
16+
## Method 1: MCP Server (Stdio)
1717

1818
Configure Recce as an MCP server with stdio transport. Claude Code will automatically launch the MCP server when you start a session.
1919

2020
1. Configure the MCP server for your dbt project:
2121

2222
```shell
23+
cd my-dbt-project/
2324
claude mcp add --scope project recce -- recce mcp-server
2425
```
2526

@@ -29,10 +30,14 @@ Configure Recce as an MCP server with stdio transport. Claude Code will automati
2930
claude
3031
```
3132

32-
In the claude interact use the slash command `/mcp` to see if the recce mcp is connected
33-
33+
Verify the connection by running the `/mcp` command in Claude Code:
34+
3435
```
35-
❯ 1. recce ✔ connected · Enter to view details
36+
> /mcp
37+
╭────────────────────────────────────────────────────────────╮
38+
│ Manage MCP servers │
39+
│ │
40+
│ ❯ 1. recce ✔ connected · Enter to view details │
3641
```
3742

3843
3. Ask Claude Code about your changes
@@ -45,25 +50,36 @@ Configure Recce as an MCP server with stdio transport. Claude Code will automati
4550

4651
Alternatively, launch a standalone MCP server that Claude Code connects to via HTTP-SSE. This requires running the server in a separate terminal.
4752

48-
1. Configure the MCP server for your dbt project:
53+
1. Start the standalone MCP server:
4954

5055
```shell
51-
claude mcp add --transport sse --scope project recce http://localhost:8000/sse
56+
cd my-dbt-project/
57+
recce mcp-server --sse
5258
```
5359

54-
2. In a separate terminal, start the standalone MCP server:
60+
2. In a **separate** terminal, configure the MCP server for your dbt project:
5561

5662
```shell
5763
cd my-dbt-project/
58-
recce mcp-server --sse
64+
claude mcp add --transport sse --scope project recce http://localhost:8000/sse
5965
```
6066

61-
3. In your original terminal, run Claude Code:
67+
3. run Claude Code:
6268

6369
```shell
6470
claude
6571
```
6672

73+
Verify the connection by running the `/mcp` command in Claude Code:
74+
75+
```
76+
> /mcp
77+
╭────────────────────────────────────────────────────────────╮
78+
│ Manage MCP servers │
79+
│ │
80+
│ ❯ 1. recce ✔ connected · Enter to view details │
81+
```
82+
6783
4. Ask Claude Code about your changes:
6884

6985
```shell

0 commit comments

Comments
 (0)