CuaConfiguration
The server is configured using environment variables (can be set in the Claude Desktop config):
| Variable | Description | Default |
|---|---|---|
CUA_MODEL_NAME | Model string (e.g., "anthropic/claude-sonnet-4-20250514", "openai/computer-use-preview", "huggingface-local/ByteDance-Seed/UI-TARS-1.5-7B", "omniparser+litellm/gpt-4o", "omniparser+ollama_chat/gemma3") | anthropic/claude-sonnet-4-20250514 |
ANTHROPIC_API_KEY | Your Anthropic API key (required for Anthropic models) | None |
CUA_MAX_IMAGES | Maximum number of images to keep in context | 3 |
CUA_USE_HOST_COMPUTER_SERVER | Target your local desktop instead of a VM. Set to "true" to use your host system. Warning: AI models may perform risky actions. | false |
Model Configuration
The CUA_MODEL_NAME environment variable supports various model providers through LiteLLM integration:
Supported Providers
- Anthropic:
anthropic/claude-sonnet-4-20250514, - OpenAI:
openai/computer-use-preview,openai/gpt-4o - Local Models:
huggingface-local/ByteDance-Seed/UI-TARS-1.5-7B - Omni + LiteLLM:
omniparser+litellm/gpt-4o,omniparser+litellm/claude-3-haiku - Ollama:
omniparser+ollama_chat/gemma3
Example Configurations
Claude Desktop Configuration:
{
"mcpServers": {
"cua-agent": {
"command": "/bin/bash",
"args": ["~/.cua/start_mcp_server.sh"],
"env": {
"CUA_MODEL_NAME": "anthropic/claude-sonnet-4-20250514",
"ANTHROPIC_API_KEY": "your-anthropic-api-key-here",
"CUA_MAX_IMAGES": "5",
"CUA_USE_HOST_COMPUTER_SERVER": "false"
}
}
}
}Local Model Configuration:
{
"mcpServers": {
"cua-agent": {
"command": "/bin/bash",
"args": ["~/.cua/start_mcp_server.sh"],
"env": {
"CUA_MODEL_NAME": "huggingface-local/ByteDance-Seed/UI-TARS-1.5-7B",
"CUA_MAX_IMAGES": "3"
}
}
}
}Session Management Configuration
The MCP server automatically manages sessions with the following defaults:
- Max Concurrent Sessions: 10
- Session Timeout: 10 minutes of inactivity
- Computer Pool Size: 5 instances
- Automatic Cleanup: Enabled
These settings are optimized for typical usage and don't require configuration for most users.
Was this page helpful?