# MCP Quick Start Guide

Quick setup for ShopDB MCP (Model Context Protocol) servers.

## What is MCP?

MCP extends Claude Code with external tool access. ShopDB uses 5 MCP servers:

| Server | Purpose |
|--------|---------|
| **gortex** | Code intelligence and project management |
| **mysql** | Database access and queries |
| **browser** | Web automation and testing |
| **vm** | VM automation and deployment |
| **coordinator** | Multi-agent coordination |

## Quick Setup

### 1. Run Automated Setup

```powershell
cd flask-shopdb
.\.claude\quick-start-mcp.ps1
```

This installs all required packages and verifies connectivity.

### 2. Configure GitHub Token

```bash
# Create token at: https://github.com/settings/tokens/new
# Scopes needed: repo, read:org

# Set environment variable (Windows)
setx GITHUB_PERSONAL_ACCESS_TOKEN "ghp_YOUR_TOKEN_HERE"

# Or add to shell profile (Git Bash)
echo 'export GITHUB_PERSONAL_ACCESS_TOKEN="ghp_YOUR_TOKEN_HERE"' >> ~/.bashrc
```

### 3. Verify Setup

```powershell
.\.claude\test-mcp-servers.ps1
```

Expected: All servers respond OK.

### 4. Restart Claude Code

Close and reopen Claude Code to load MCP servers.

## Troubleshooting

**Problem**: GitHub authorization error  
**Fix**: Set `GITHUB_PERSONAL_ACCESS_TOKEN` environment variable and restart

**Problem**: MySQL connection fails  
**Fix**: Start MySQL with `docker-compose up -d db` or `start-dev.cmd`

**Problem**: VM connection fails  
**Fix**: Check VM is running and SSH is enabled (see `setup-vm-ssh.md`)

**Problem**: Coordinator not connecting  
**Fix**: Verify coordinator server is running and network is accessible

## More Documentation

- `INDEX-MCP-DOCS.md` - Complete documentation index
- `MCP-INTEGRATION-GUIDE.md` - Detailed integration patterns and workflows
- `MCP-COORDINATOR-CONNECTION-GUIDE.md` - Multi-agent coordination setup
- `MCP-COORDINATOR-EVALUATION.md` - Coordinator capabilities and evaluation