Connect
Clickwork is an MCP server. Point your AI client at it with an API key and it can start machines and drive them.
MCP server
Replace YOUR_CLICKWORK_KEY with an API key. Create an account to get one.
Run in a terminal. Add --scope user to use it in every project.
claude mcp add --transport http clickwork https://clickwork.ai/mcp \ --header "Authorization: Bearer YOUR_CLICKWORK_KEY"
Customize › Connectors › Add custom connector. It works in Claude Code on the web too: turn it on for the session. On Team and Enterprise plans an Owner adds it under Organization settings › Connectors, and everyone shares the key. If the dialog has no Request headers section, your account cannot send a Clickwork key yet.
Name Clickwork Remote MCP server URL https://clickwork.ai/mcp Authentication No sign-in Request headers authorization · Bearer YOUR_CLICKWORK_KEY · Required
Add to ~/.codex/config.toml.
[mcp_servers.clickwork]
url = "https://clickwork.ai/mcp"
http_headers = { "Authorization" = "Bearer YOUR_CLICKWORK_KEY" }
Add to ~/.cursor/mcp.json, or .cursor/mcp.json in a project.
{
"mcpServers": {
"clickwork": {
"url": "https://clickwork.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_CLICKWORK_KEY" }
}
}
}
Add to .vscode/mcp.json. VS Code asks for the key once and keeps it.
{
"inputs": [
{
"type": "promptString",
"id": "clickwork-key",
"description": "Clickwork API key",
"password": true
}
],
"servers": {
"clickwork": {
"type": "http",
"url": "https://clickwork.ai/mcp",
"headers": { "Authorization": "Bearer ${input:clickwork-key}" }
}
}
}
Run in a terminal. Add -s user to use it in every project.
gemini mcp add --transport http clickwork https://clickwork.ai/mcp \ --header "Authorization: Bearer YOUR_CLICKWORK_KEY"
Any MCP client that speaks Streamable HTTP and sends a bearer token.
{
"mcpServers": {
"clickwork": {
"type": "http",
"url": "https://clickwork.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_CLICKWORK_KEY" }
}
}
}
REST API
The same actions over plain HTTP, with the same API key.
curl -X POST https://clickwork.ai/api/v1/instances \
-H "Authorization: Bearer YOUR_CLICKWORK_KEY" -H "Content-Type: application/json" \
-d '{"os": "linux", "ttl_minutes": 60}'
curl https://clickwork.ai/api/v1/instances/in_…/screenshot \
-H "Authorization: Bearer YOUR_CLICKWORK_KEY" -o screen.png
curl -X POST https://clickwork.ai/api/v1/instances/in_…/input \
-H "Authorization: Bearer YOUR_CLICKWORK_KEY" -H "Content-Type: application/json" \
-d '{"actions": [{"type": "click", "x": 640, "y": 400}, {"type": "type", "text": "hello\n"}]}'