@anthropic/scout-mcp-server

MCP (Model Context Protocol) server that enables Claude Code to integrate with Scout for bug tracking and test case management.

Features

- List and view bugs from Scout with full context (console errors, network errors, screenshots)
- Update bug status directly from Claude Code after fixing issues
- Create test cases for new features or bug regression tests
- Access project information including codebase paths for navigation

Quick Setup

$3

Create a .mcp.json file in your project's root directory:

``json
{
"mcpServers": {
"scout": {
"command": "npx",
"args": ["-y", "@anthropic/scout-mcp-server"],
"env": {
"SCOUT_API_URL": "http://localhost:4002"
}
}
}
}
`

$3

Run Claude Code from your project directory:

`bash
cd your-project
claude
`

Claude Code will detect the .mcp.json and prompt you to approve the Scout MCP server.

Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| SCOUT_API_URL | URL of the Scout API server | http://localhost:4002 |

Optional: Set Git Repository in Scout

For each project in Scout, you can configure the Git Repository in Project Settings:
1. Go to Projects → Select a project
2. Click the gear icon (⚙️) in the header
3. Enter your repository URL (e.g., github.com/myorg/myapp)
4. Optionally set the default branch (e.g., main, develop)
5. Save settings

This allows Claude Code to verify it's working in the correct repository before making changes.

Available Tools

$3

List all projects in Scout with their IDs, names, target URLs, and repository info.

$3

Get detailed information about a specific project including test suites.

Parameters:
- projectId (required): The project ID

$3

List bugs with optional filtering.

Parameters:
- projectId (optional): Filter by project
- status (optional): Filter by status (NEW, CONFIRMED, IN_PROGRESS, BLOCKED, RESOLVED, WONT_FIX, DUPLICATE)
- severity (optional): Filter by severity (BLOCKER, CRITICAL, MAJOR, MINOR, TRIVIAL)

$3

Get full bug details including debugging context.

Parameters:
- bugId (required): The bug ID

Returns:
- Title, description, severity, status
- Console errors captured at bug time
- Network errors captured at bug time
- Page URL where bug occurred
- Screenshot URL (if available)
- Related test case and step
- Session recording info

$3

Update a bug's status or assignment.

Parameters:
- bugId (required): The bug ID
- status (optional): New status
- assignedDevId (optional): Developer ID to assign

$3

List test cases with optional filtering.

Parameters:
- projectId (optional): Filter by project
- suiteId (optional): Filter by test suite

$3

Create a new test case.

Parameters:
- suiteId (required): Test suite ID
- code (required): Test case code (e.g., "TC-042")
- title (required): Test case title
- expectedResult (required): Expected outcome
- description (optional): Detailed description
- preconditions (optional): Prerequisites
- priority (optional): CRITICAL, HIGH, MEDIUM, LOW
- section (optional): Category for grouping
- steps (optional): Array of test steps

$3

List test suites for a project.

Parameters:
- projectId (required): The project ID

$3

Create a new test suite.

Parameters:
- projectId (required): The project ID
- name (required): Suite name
- version (optional): Version identifier

Usage Examples

$3

`
User: "Debug the login bug in Scout"

Claude Code:
1. scout_list_bugs(status="NEW") → finds login-related bug
2. scout_get_bug(bugId="...") → gets console errors, network failures
3. Reads codebase files based on error stack traces
4. Identifies and fixes the issue
5. scout_update_bug(bugId="...", status="RESOLVED")
`

$3

`
User: "Add test cases for the new user registration feature"

Claude Code:
1. scout_list_projects() → finds project
2. scout_list_test_suites(projectId="...") → finds appropriate suite
3. scout_create_test_case(...) → creates test cases for:
- Valid registration
- Invalid email format
- Password requirements
- Duplicate email handling
`

Development

`bash


Run in development mode

pnpm dev

Build for production

pnpm build

Start production server

pnpm start
`

Troubleshooting

$3

Ensure the Scout API server is running on the configured port:
`bash
cd apps/api
pnpm dev
`

$3

1. Verify the MCP server is built: pnpm build`
2. Check the path in claude_desktop_config.json is correct
3. Restart Claude Code after config changes