Skip to content

docs: add Autohand Code MCP setup #471

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
igorcosta wants to merge 2 commits into from
+9 −0
Closed

docs: add Autohand Code MCP setup #471

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c2f5413
docs: add Autohand Code MCP setup
igorcosta Jul 10, 2026
08860cf
docs: note Autohand Code setup in changelog
igorcosta Jul 10, 2026
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
1 change: 1 addition & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@

### Added

- Added Autohand Code MCP client setup documentation ([#471](https://github.com/getsentry/XcodeBuildMCP/pull/471) by [@igorcosta](https://github.com/igorcosta)).
- Added `extraArgs` as a first-class session-default value. Repo config or runtime defaults can now carry common `xcodebuild` flags (for example `-skipPackagePluginValidation` or `-disableAutomaticPackageResolution`) so they don't need repeating on every build or test call. Per-call `extraArgs` replace matching configured flags or build settings and append after non-matching defaults, while an explicit empty array (`extraArgs: []`) clears the defaults for a single call. The session management tools show, set, sync, and clear `extraArgs` alongside the other defaults.

## [2.6.2]
Expand Down
8 changes: 8 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,14 @@ xcodebuildmcp --help

Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page [MCP Clients](https://xcodebuildmcp.com/docs/clients). Most clients can also run the MCP server on demand via `npx -y xcodebuildmcp@latest mcp` without a global install.

For Autohand Code, add the server from the command line:

```bash
autohand mcp add xcodebuildmcp npx -y xcodebuildmcp@latest mcp
```

Add `--scope project` after `add` to keep the server configuration in the current project. See [Autohand Code](https://github.com/autohandai/code-cli/) for current installation and CLI details.

## Requirements

@sentry sentry Bot Jul 11, 2026

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.

Bug: The README.md documents an invalid --scope project flag for the autohand mcp add command, which will cause the setup instructions to fail.
Severity: MEDIUM

Suggested Fix

Verify the correct command and flags for adding a project-scoped MCP server with the autohand CLI. Update the README.md to reflect the correct syntax, which may involve using a different flag like --transport http or a different command structure entirely. Remove the reference to the unsupported --scope project flag.

Prompt for AI Agent 
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: README.md#L42

Potential issue: The documentation in `README.md` instructs users to add a `--scope
project` flag to the `autohand mcp add` command to keep server configuration within the
current project. However, this flag appears to be invalid according to the `autohand`
CLI's documentation. Users following these instructions will encounter a command-line
error, preventing them from successfully setting up the tool as described. This makes
the provided setup instructions incorrect and unusable.

Did we get this right? 👍 / 👎 to inform future reviews.


- macOS 14.5 or later
Expand Down