Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
128 changes: 128 additions & 0 deletions docs/content/docs/cua-driver/guide/getting-started/integrations.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,128 @@
---
title: Integrations
description: Connect cua-driver to your AI coding agent
---

import { Callout } from 'fumadocs-ui/components/callout';

`cua-driver mcp` is a stdio MCP server. Any agent that supports MCP can use it — no extra setup beyond adding it to the agent's MCP config.

<Callout type="warn">
Grant Accessibility and Screen Recording permissions to cua-driver before connecting any agent.
Run `cua-driver check_permissions` to verify.
</Callout>

## Claude Code

```bash
claude mcp add --transport stdio cua-driver -- cua-driver mcp
```

Verify:

```bash
claude mcp list
# cua-driver: cua-driver mcp (stdio) - ✓ Connected
```

## GitHub Copilot CLI

Add to `~/.copilot/mcp-config.json`:

```json
{
"mcpServers": {
"cua-driver": {
"type": "local",
"command": "cua-driver",
"args": ["mcp"],
"tools": ["*"]
}
}
}
```

Or interactively inside `gh copilot` chat:

```
/mcp add
```

Fill in: name=`cua-driver`, type=STDIO, command=`cua-driver`, args=`mcp`. Press **Ctrl+S** to save.

## Codex (OpenAI)

```bash
codex mcp add cua-driver -- cua-driver mcp
```

## Cursor

Generate the config snippet and paste it into `~/.cursor/mcp.json`:

```bash
cua-driver mcp-config --client cursor
```

## Gemini CLI

Add to `~/.gemini/settings.json`:

```json
{
"mcp": {
"servers": {
"cua-driver": {
"type": "stdio",
"command": "cua-driver",
"args": ["mcp"]
}
}
}
}
```

Tools appear prefixed as `mcp_cua-driver_*`.

## OpenCode

```bash
cua-driver mcp-config --client opencode
```

Paste the output into your `opencode.json`.

## Hermes (NousResearch)

```bash
cua-driver mcp-config --client hermes
```

Paste the output into `~/.hermes/config.yaml`.

## OpenClaw

```bash
cua-driver mcp-config --client openclaw
```

## Other clients

For any client that accepts the standard `mcpServers` shape:

```bash
cua-driver mcp-config
```

Output:

```json
{
"mcpServers": {
"cua-driver": {
"command": "cua-driver",
"args": ["mcp"]
}
}
}
```
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,5 @@
"description": "Get up and running with Cua Driver",
"icon": "Rocket",
"defaultOpen": true,
"pages": ["introduction", "installation", "quickstart", "swift-integration", "comparison", "faq"]
"pages": ["introduction", "installation", "quickstart", "integrations", "swift-integration", "comparison", "faq"]
}
13 changes: 13 additions & 0 deletions libs/cua-driver/scripts/install.sh
Original file line number Diff line number Diff line change
Expand Up @@ -306,6 +306,19 @@ Next steps:
• OpenClaw:
cua-driver mcp-config --client openclaw

• GitHub Copilot CLI (paste into ~/.copilot/mcp-config.json):
{
"mcpServers": {
"cua-driver": {
"type": "local",
"command": "$BIN_LINK",
"args": ["mcp"],
"tools": ["*"]
}
}
}
Or inside gh copilot chat: /mcp add → type=STDIO, command=$BIN_LINK, args=mcp

• Cursor / OpenCode / Hermes (no add CLI — paste config):
cua-driver mcp-config --client cursor # JSON for ~/.cursor/mcp.json
cua-driver mcp-config --client opencode # JSON for opencode.json
Expand Down
Loading