Tier 3: Server Configuration

Configure the Ralph MCP server.

Claude Desktop Config

Location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Basic Config

{
  "mcpServers": {
    "ralph-workflow": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

With Environment Variables

{
  "mcpServers": {
    "ralph-workflow": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "RALPH_TASK_FILE": "/path/to/tasks.json",
        "RALPH_MAX_ATTEMPTS": "5"
      }
    }
  }
}

Multiple MCP Servers

{
  "mcpServers": {
    "ralph-workflow": {
      "command": "node",
      "args": ["/path/to/ralph/dist/index.js"]
    },
    "filesystem": {
      "command": "mcp-server-filesystem",
      "args": ["/allowed/path"]
    }
  }
}

Troubleshooting

Server Not Showing

Check config JSON syntax
Verify file paths exist
Restart Claude Desktop

Permission Errors

Ensure the command is executable:

chmod +x /path/to/dist/index.js

Next Steps

← Back to Tutorials