# Claude Desktop MCP Setup Guide

## Quick Setup

### Step 1: Locate Claude Desktop Configuration

Find your Claude Desktop configuration file:

**Windows**: 
```
%APPDATA%\Claude\claude_desktop_config.json
```
Full path: `C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json`

**macOS**: 
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
Full path: `/Users/[YourUsername]/Library/Application Support/Claude/claude_desktop_config.json`

### Step 2: Add MCP Server Configuration

Add or modify your `claude_desktop_config.json` file:

```json
{
  "mcpServers": {
    "coordination-system": {
      "command": "node",
      "args": ["`12345`"]
    }
  }
}
```

**Important**: Use absolute paths and ensure Node.js is in your PATH.

### Step 3: Start the MCP Server

Before using Claude Desktop, start the MCP server:

```bash
cd D:\Lupo\Source\AI\CladueCOO\mcp-coordination-system
npm run start:mcp
```

The server will run in stdio mode for Claude Desktop integration.

### Step 4: Restart Claude Desktop

1. Completely close Claude Desktop
2. Restart Claude Desktop
3. The MCP tools should now be available

## Verification

In Claude Desktop, you should be able to use MCP functions like:
- `bootstrap` - Initialize an AI instance
- `get_projects` - List all projects
- `create_task` - Create new tasks
- `send_message` - Send messages between instances

## Troubleshooting

### MCP Server Not Detected

1. **Check Node.js Installation**:
   ```bash
   node --version
   npm --version
   ```

2. **Verify File Paths**:
   - Ensure the path to `mcp-server.js` is correct and absolute
   - Use forward slashes or double backslashes in Windows paths

3. **Check Configuration File Syntax**:
   - Ensure valid JSON format
   - No trailing commas
   - Proper quote usage

4. **Check MCP Server Startup**:
   ```bash
   # Test the MCP server manually
   node "D:\Lupo\Source\AI\CladueCOO\mcp-coordination-system\src\mcp-server.js"
   ```

### Common Configuration Errors

**Incorrect Path Format**:
```json
// ❌ Wrong - relative path
"args": ["src/mcp-server.js"]

// ❌ Wrong - single backslashes
"args": ["D:\Lupo\Source\AI\CladueCOO\mcp-coordination-system\src\mcp-server.js"]

// ✅ Correct - absolute path with double backslashes
"args": ["D:\\Lupo\\Source\\AI\\CladueCOO\\mcp-coordination-system\\src\\mcp-server.js"]
```

**Invalid JSON**:
```json
// ❌ Wrong - trailing comma
{
  "mcpServers": {
    "coordination-system": {
      "command": "node",
      "args": ["D:\\Lupo\\Source\\AI\\CladueCOO\\mcp-coordination-system\\src\\mcp-server.js"],
    }
  }
}

// ✅ Correct - no trailing comma
{
  "mcpServers": {
    "coordination-system": {
      "command": "node",
      "args": ["D:\\Lupo\\Source\\AI\\CladueCOO\\mcp-coordination-system\\src\\mcp-server.js"]
    }
  }
}
```

### Alternative: Full Path to Node

If Node.js is not in PATH, use full path:

```json
{
  "mcpServers": {
    "coordination-system": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["D:\\Lupo\\Source\\AI\\CladueCOO\\mcp-coordination-system\\src\\mcp-server.js"]
    }
  }
}
```

## Testing the Setup

Once configured and Claude Desktop is restarted, try these commands in Claude Desktop:

1. **Test Bootstrap**:
   "Use the bootstrap tool to initialize me as a COO"

2. **Test Project Listing**:
   "Use the get_projects tool to show me all projects"

3. **Test Task Creation**:
   "Use the create_task tool to create a test task"

## Multiple MCP Servers

You can configure multiple MCP servers:

```json
{
  "mcpServers": {
    "coordination-system": {
      "command": "node",
      "args": ["D:\\Lupo\\Source\\AI\\CladueCOO\\mcp-coordination-system\\src\\mcp-server.js"]
    },
    "other-mcp-server": {
      "command": "node",
      "args": ["path/to/other/server.js"]
    }
  }
}
```

## Security Notes

- The MCP server runs with your user permissions
- All data is stored locally in the `data/` directory
- No network connections are made by the stdio MCP server
- For HTTPS access, use the separate HTTPS server

---

**Created by**: claude-code-MCP-ProtocolExpert-2025-08-23-1600  
**Updated**: 2025-09-08 by Phoenix  
**Version**: 1.1.0

## Current Mac Configuration (as of 2025-09-08)

The following configuration is currently active on the Mac system, connecting to the live .171 instance:

```json
{
  "mcpServers": {
    "coordination-system-proxy": {
      "command": "node",
      "args": ["/Users/lupo/source/CladueCOO/mcp-coordination-system/mcp-proxy-client.js"],
      "env": {
        "SSE_SERVER_URL": "https://192.168.0.171:3444/mcp",
        "USE_HTTP": "false",
        "DEBUG": "false"
      }
    },
    "coordination-system-DOCKER-proxy": {
      "command": "node",
      "args": ["/Users/lupo/source/CladueCOO/mcp-coordination-system/mcp-proxy-client.js"],
      "env": {
        "SSE_SERVER_URL": "https://192.168.0.171:3445/mcp",
        "USE_HTTP": "false",
        "DEBUG": "false"
      }
    }
  }
}
```

### To Add New Human-Adjacent-Coordination Proxy:

For connecting to the new repository's SSE proxy, add this configuration:

```json
{
  "mcpServers": {
    "human-adjacent-live": {
      "command": "node",
      "args": ["/Users/lupo/source/Human-Adjacent-Coordination/src/mcp-proxy-client.js"],
      "env": {
        "SSE_SERVER_URL": "https://192.168.0.171:3444/mcp",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    },
    "human-adjacent-local": {
      "command": "node",
      "args": ["/Users/lupo/source/Human-Adjacent-Coordination/src/mcp-proxy-client.js"],
      "env": {
        "SSE_SERVER_URL": "https://localhost:3444/mcp",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}
```

### Claude Code MCP Configuration

To copy MCP configuration from Claude Desktop to Claude Code:

```bash
# Use the MCP tool available in Claude Code
# Command: 
claude mcp add-from-claude-desktop
```