Claude Desktop

Give Claude Desktop the ability to create cloud sandboxes, run code, deploy applications, and expose services to the internet.

Setup

Option A: One-Line Setup

If you haven't installed Conway yet, the setup script handles everything -- installs the terminal, creates a wallet, provisions an API key, and configures Claude Desktop automatically:

curl -fsSL https://conway.tech/terminal.sh | sh

The setup script detects Claude Desktop and writes the MCP configuration for you. Just restart Claude Desktop after it finishes.

Option B: Manual Setup

If you already have an API key from app.conway.tech:

1. Locate the Config File

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

2. Add Conway

Edit the config file and add the Conway MCP server:

{
  "mcpServers": {
    "conway": {
      "command": "conway-terminal",
      "env": {
        "CONWAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

If you installed via npx instead of globally:

{
  "mcpServers": {
    "conway": {
      "command": "npx",
      "args": ["conway-terminal"],
      "env": {
        "CONWAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop

Quit and reopen Claude Desktop to load the new configuration.

Verify Integration

Ask Claude to list your sandboxes:

"Can you list my cloud sandboxes?"

Claude should use the sandbox_list tool and show your sandboxes.

Example Workflows

Deploy and Test

"Create a sandbox, copy my project files, install dependencies, and run the tests"

Run Code

"Create a sandbox and run a Python script that calculates the first 100 prime numbers"

Interactive Session

"Start a Python REPL in my sandbox and help me debug this code"

Web Development

"Create a sandbox, install Node.js, set up a simple Express server, and expose port 3000 so I can access it"

Tips

• PTY sessions: For interactive work, ask Claude to create a PTY session
• Port forwarding: Claude can expose ports and give you public URLs
• Cleanup: Ask Claude to delete sandboxes when you're done to save resources

Troubleshooting

MCP Not Appearing

1. Check the config file path is correct for your OS
2. Verify JSON syntax is valid
3. Ensure conway-terminal is in your PATH: which conway-terminal
4. Restart Claude Desktop completely

Connection Issues

• Check your internet connection
• Verify the API key is valid (~/.conway/config.json or the one you set manually)
• Try a different region

Permission Errors

On macOS/Linux, ensure the binary is executable:

chmod +x $(which conway-terminal)