Skip to content

docs(driver): update Claude MCP setup examples - #2067

Merged
f-trycua merged 2 commits into
trycua:mainfrom
injaneity:docs/update-claude-mcp-examples
Jul 26, 2026
Merged

docs(driver): update Claude MCP setup examples#2067
f-trycua merged 2 commits into
trycua:mainfrom
injaneity:docs/update-claude-mcp-examples

Conversation

@injaneity

@injaneity injaneity commented Jun 29, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Update Claude Code MCP setup examples to match current cua-driver mcp-config --client claude output.
  • Remove stale generated --claude-code-computer-use-compat examples from the getting-started docs.

Testing

  • git diff --check

Summary by CodeRabbit

  • Documentation
    • Updated Claude Code setup instructions for connecting an agent.
    • Simplified the registration command and removed the older compatibility-mode option.
    • Clarified the generated command and how to use the cua-computer-use entry with vision-based screenshot capture.

@vercel

vercel Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

@injaneity is attempting to deploy a commit to the Cua Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai

coderabbitai Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f62d8c11-c381-4060-b088-510cd6aad3c2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Two documentation files remove the --claude-code-computer-use-compat flag from claude mcp add-json registration commands for cua-driver mcp. The how-to guide also adds --scope user, updates surrounding text, and removes compat-mode explanations.

Claude Code MCP Registration Docs

Layer / File(s) Summary
Remove compat flag from registration commands
docs/content/docs/how-to-guides/driver/connect-your-agent.mdx, docs/content/docs/tutorials/drive-your-first-app.mdx
--claude-code-computer-use-compat removed from args in both claude mcp add-json snippets; how-to guide adds --scope user, rewrites surrounding callout and explanation text.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • trycua/cua#1680: Switched the CLI registration command to claude mcp add-json format, directly preceding these doc updates.
  • trycua/cua#1681: Introduced cua-driver mcp-config --client claude emitting the same add-json-based registration flow updated here.
  • trycua/cua#1679: Previously updated Claude Code MCP registration instructions involving the compat-mode flag now being removed.

Poem

🐇 Hop, hop, the flag has gone away,
No --compat flag to clutter the day.
Just mcp add-json, clean and bright,
With --scope user set just right.
The docs are tidy, the rabbit's pleased! 🌿

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the documentation changes to Claude MCP setup examples for the driver.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/content/docs/how-to-guides/driver/connect-your-agent.mdx`:
- Around line 52-55: Update the adjacent callout in connect-your-agent.mdx to
remove the outdated “MCP compatibility mode for Claude Code” claim. The new
plain ["mcp"] command in the surrounding text means the callout should be
rewritten to match the current “same driver tools for every client” messaging
and avoid referencing the deprecated compat surface. Keep the change local to
the callout block near the get_window_state guidance so the wording is
consistent with the updated CLI reference and the symbols around the Claude
Code/MCP setup text.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b6e219cf-9dff-4d2d-9b22-18d77c7220a2

📥 Commits

Reviewing files that changed from the base of the PR and between 7468487 and 1623dd7.

📒 Files selected for processing (2)
  • docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
  • docs/content/docs/tutorials/drive-your-first-app.mdx

Comment thread docs/content/docs/how-to-guides/driver/connect-your-agent.mdx Outdated
@injaneity
injaneity force-pushed the docs/update-claude-mcp-examples branch from 1623dd7 to f149827 Compare June 29, 2026 03:03
@injaneity injaneity added the documentation Improvements or additions to documentation label Jun 29, 2026
@f-trycua

f-trycua commented Jul 1, 2026

Copy link
Copy Markdown
Collaborator

Thanks! Half of this already landed via #2077connect-your-agent.mdx on main already emits the correct claude mcp add-json --scope user … without the dead --claude-code-computer-use-compat flag, so that file now conflicts.

But the drive-your-first-app.mdx change is still valuable: main (line ~90) still carries the stale --claude-code-computer-use-compat flag that #2077 missed. Could you rebase and keep just the drive-your-first-app.mdx fix? The commands themselves are all correct for 0.7.0.

@injaneity
injaneity force-pushed the docs/update-claude-mcp-examples branch from f149827 to 0ee6035 Compare July 2, 2026 01:35

@f-trycua f-trycua left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed at updated head e4e660e. The documented Claude MCP registration command matches the current CLI, and all required link and metadata checks pass.

@f-trycua
f-trycua merged commit d463e69 into trycua:main Jul 26, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants