# Feedback Pipeline MCP Server

An MCP (Model Context Protocol) server that bridges Notion custom agents with Claude Code for automated bug reproduction and fix building.

## Overview

This server allows a Notion custom agent to:
1. **Reproduce bugs** - Uses Playwright browser automation to reproduce reported bugs and capture screenshots
2. **Build fixes** - Uses Claude Code to implement fixes, run tests, and verify with Playwright

## Setup

1. Install dependencies:
   ```bash
   npm install
   ```

2. Create a `.env` file with your Notion API token:
   ```
   NOTION_API_TOKEN=your_token_here
   ```

3. Start the server:
   ```bash
   node server.js
   ```

4. Expose via ngrok (for Notion to connect):
   ```bash
   ngrok http 3001
   ```

## Architecture

```
Notion Custom Agent
        │
        ▼ (via ngrok)
   MCP Server (port 3001)
        │
        ▼
   Claude Code CLI
        │
        ▼
   Playwright MCP
        │
        ▼
   Notion Dev Server (port 3030)
```

## MCP Tools

### `reproduce_bug`
Reproduce a bug using Playwright browser automation.

**Parameters:**
- `bug_description` (required): Description of the bug
- `reproduction_steps` (optional): Steps to reproduce
- `callback_agent_id` (required): Agent ID for callback
- `callback_thread_id` (required): Thread ID for callback
- `callback_page_id` (required): Page ID for comment notification

### `build_fix`
Build a fix or feature using Claude Code.

**Parameters:**
- `description` (required): What to build or fix
- `plan` (optional): Implementation plan
- `verify_with_playwright` (optional): Whether to verify with Playwright (default: true)
- `callback_agent_id` (required): Agent ID for callback
- `callback_thread_id` (required): Thread ID for callback
- `callback_page_id` (required): Page ID for comment notification

### `get_task_status`
Check the status of a running or completed task.

**Parameters:**
- `task_id` (required): The task ID to check

### `ping`
Test connectivity - returns "pong".

## Endpoints

- `GET /` - SSE endpoint for MCP connection
- `POST /` - MCP message handler
- `GET /health` - Health check
- `GET /tasks` - List all tasks
- `GET /tasks/:taskId` - Get task details
- `GET /demos` - List demo recordings
- `GET /demos/:taskId/` - Live progress page with screenshots

## Callbacks

When a task completes, the server:
1. Posts results to the agent thread via Notion Agents SDK API
2. Adds a comment to the task page with demo URL and summary

## Configuration

The server expects:
- Notion dev server running on port 3030
- Playwright MCP configured in the Claude Code environment
- `NOTION_API_TOKEN` environment variable for callbacks