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

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