Merge pull request #51 from DataRecce/feature/drc-1993-doc-ai-summary

feat: doc for ai summary and MCP Server

Author: popcornylu

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

@@ -0,0 +1,87 @@
+---
+title: MCP Server
+---
+
+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.
+
+
+## Installation
+
+Install Recce with the MCP extra dependency:
+
+```shell
+pip install 'recce[mcp]'
+```
+
+## 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
+    cd my-dbt-project/
+    claude mcp add --scope project recce -- recce mcp-server
+    ```
+
+2. Run Claude Code
+
+    ```shell
+    claude
+    ```
+
+    Verify the connection by running the `/mcp` command in Claude Code:
+
+    ```
+    > /mcp
+    ╭────────────────────────────────────────────────────────────╮
+    │ Manage MCP servers                                         │
+    │                                                            │
+    │ ❯ 1. recce            ✔ connected · Enter to view details  │
+    ```
+
+3. Ask Claude Code about your changes
+
+    ```shell
+    > Understand changes from Recce.
+    ```
+
+## Method 2: MCP Server (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. Start the standalone MCP server:
+
+    ```shell
+    cd my-dbt-project/
+    recce mcp-server --sse
+    ```
+
+2. In a **separate** terminal, configure the MCP server for your dbt project:
+
+    ```shell
+    cd my-dbt-project/
+    claude mcp add --transport sse --scope project recce http://localhost:8000/sse
+    ```
+
+3. run Claude Code:
+
+    ```shell
+    claude
+    ```
+
+    Verify the connection by running the `/mcp` command in Claude Code:
+
+    ```
+    > /mcp
+    ╭────────────────────────────────────────────────────────────╮
+    │ Manage MCP servers                                         │
+    │                                                            │
+    │ ❯ 1. recce            ✔ connected · Enter to view details  │
+    ```    
+
+4. Ask Claude Code about your changes:
+
+    ```shell
+    > Understand changes from Recce.
+    ```

docs/7-cicd/pr_mr_summary.md

@@ -0,0 +1,46 @@
+---
+title: PR/MR Summary
+---
+Recce provides summary of each PR for you to understand the change and the impact. Recce Summary uses a template-based format, while AI Summary is dynamically generated by AI agents for more intelligent analysis.
+
+
+## Recce Summary
+Recce allows to generate a summary for a PR based on the updated metadata and the run result of the checklist and post the summary on your PR/MR comment
+
+Recce Summary uses a template-based format and includes: lineage graph, check results, and launch URL.
+
+### How to generate
+
+1. **Trigger via CI Automation**: Summary is automatically generated when Recce runs in your CI workflow.
+
+2. **Trigger via Recce Cloud**: In the Recce Cloud PR/MR session list, click **Execute Recce Summary** to manually generate the analysis.
+
+    > Note: This action is only available after the session metadata has been updated.
+
+## AI Summary
+
+AI Summary leverages state-of-the-art AI agents to understand your changes by analyzing your PR information and updated metadata. It proactively thinks and decides what to validate by data diffing in your data warehouse, then provides comprehensive insights to help you make informed decisions.
+
+**Features**
+
+- Automatically identify what to validate
+- Explore changes through data diffing in Recce
+- Generate actionable insights to guide your merge decision
+
+### How to generate
+
+
+
+1. **Trigger via Recce Cloud**: In the Recce Cloud PR/MR session list, click **Execute Recce AI Summary** to generate the analysis.
+
+2. **Trigger via GitHub PR Comment (GitHub only)**: In your GitHub PR page, comment `/recce` to trigger the AI Summary generation. The Recce bot will respond with status updates.
+
+    ![AI Summary slash command example](../assets/images/7-cicd/ai-summary-slash-command.png){: .shadow}
+
+    Progress Indicators:
+
+    - 👀 : Request received
+    - 🚀 : Summary is generating
+    - 👍 : Summary is generated
+
+3. **Trigger via CI Automation (Coming Soon)**: AI Summary will be automatically triggered when you update PR metadata through CI.

docs/assets/images/7-cicd/ai-summary-slash-command.png

@@ -70,6 +70,7 @@ nav:
           - 5-data-diffing/topK-diff.md
           - 5-data-diffing/histogram-diff.md
           - 5-data-diffing/query.md
+          - 5-data-diffing/mcp-server.md
       - Collaborate Validation:
           - 6-collaboration/invitation.md
           - 6-collaboration/checklist.md
@@ -91,9 +92,9 @@ nav:
               - 7-cicd/gitlab/setup-ci.md
               - 7-cicd/gitlab/setup-cd.md
               - 7-cicd/gitlab/gitlab-pat-guide.md
-
+          - 7-cicd/pr_mr_summary.md
           #- 7-cicd/recce-debug.md # content outdated
-          - 7-cicd/scenario-dev.md
+          - 7-cicd/scenario-dev.md          
           - 7-cicd/scenario-pr-review.md
           - 7-cicd/best-practices-prep-env.md
           #- 7-cicd/recce-summary.md content outdated