Feedback Pipeline MCP Server

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:

   npm install
   

2. Create a .env file with your Notion API token:

   NOTION_API_TOKEN=your_token_here
   

3. Start the server:

   node server.js
   

4. Expose via ngrok (for Notion to connect):

   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