Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

docs(cua-driver): add integrations page and GitHub Copilot CLI MCP config (#1407)

Francesco Bonacci2304df1fc5e7
diff --git a/docs/content/docs/cua-driver/guide/getting-started/integrations.mdx b/docs/content/docs/cua-driver/guide/getting-started/integrations.mdx
new file mode 100644
index 0000000000..6b657edcde
--- /dev/null
+++ b/docs/content/docs/cua-driver/guide/getting-started/integrations.mdx
@@ -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"]
+ }
+ }
+}
+```
diff --git a/docs/content/docs/cua-driver/guide/getting-started/meta.json b/docs/content/docs/cua-driver/guide/getting-started/meta.json
index 1ca74ebad1..a67de13bf9 100644
--- a/docs/content/docs/cua-driver/guide/getting-started/meta.json
+++ b/docs/content/docs/cua-driver/guide/getting-started/meta.json
@@ -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"]
}
diff --git a/libs/cua-driver/scripts/install.sh b/libs/cua-driver/scripts/install.sh
index 1b8ba9b12b..bc1210fa48 100755
--- a/libs/cua-driver/scripts/install.sh
+++ b/libs/cua-driver/scripts/install.sh
@@ -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