# Cloud iOS Simulator for Claude Code

> Keep Claude Code on Linux, over SSH, or in a cloud session while AgentCloud supplies managed iOS builds and a disposable hosted Simulator through project-scoped OAuth MCP.

AgentCloud accepts build-ready iOS source or a Simulator-compatible `.app`, then exposes focused tools for building, launching, observing, acting, reading logs, and retaining the evidence. Claude Code does not receive a Mac desktop, Xcode interface, or raw worker shell.

- Canonical page: [https://agentcloud.so/claude-code-ios-simulator.html](https://agentcloud.so/claude-code-ios-simulator.html)
- Start free: [https://app.agentcloud.so/signup?plan=free](https://app.agentcloud.so/signup?plan=free)
- Compare pricing: [https://agentcloud.so/pricing.html](https://agentcloud.so/pricing.html)

## Connect Claude Code

```sh
claude mcp add --transport http --scope project agentcloud https://api.agentcloud.so/mcp
```

Open `/mcp` inside Claude Code and complete the browser authorization. Project scope writes the server configuration to `.mcp.json`, so the repository can carry the connection definition while each user approves access to AgentCloud.

## Example request

> Build the current branch for iPhone Simulator, launch the app, verify the onboarding flow, and show me the retained screenshots and logs.

Claude Code can use AgentCloud tools such as `ios.create_source_upload`, `ios.build`, `ios.create`, `ios.install`, `ios.observe`, `ios.act`, `ios.logs`, and `ios.destroy`.

## Local computer use versus AgentCloud

Claude Code Desktop can drive the local iOS Simulator on a supported Mac. AgentCloud is for Claude Code running away from that Mac: Linux, SSH, containers, CI, and cloud sessions with network access to the remote MCP endpoint.

## Technical boundaries

- Source uploads must include a build-ready Xcode workspace or project and required dependencies.
- App uploads must be Simulator-compatible `.app` bundles; device-signed `.ipa` files are not supported.
- AgentCloud provides focused build and Simulator tools through remote OAuth MCP, not a Mac, Xcode UI, or general-purpose remote computer.
- The Free plan includes 2 total iOS Simulator hours and 1 source build total without a card.