Set up your client
- Claude
- ChatGPT
- Claude Code
- Codex
- Other clients
Add
https://mcp.run.cloud/mcp as a custom connector in Claude or Claude
Desktop. Step by step: Use run.cloud in Claude.Sign in, organization and billing
The first time your client connects, a run.cloud page opens. Sign in or create an account, choose the organization to bill, and approve. Simulators your agent starts are billed to that organization at the normal rate, $0.02 per active simulator minute. See pricing. The connection reaches simulators, uploaded apps and simulator builds in that one organization. It cannot see your API keys, secrets, billing settings or other organizations you belong to.What your agent can do
Your agent picks the tools itself. You do not call them by name.- Sessions: start, list, keep alive, tag and stop iOS simulators and Android emulators.
- Apps and URLs: upload, install, launch and reload apps, and open web pages or deep links.
- Seeing the screen: screenshots, on-screen elements with their labels, and device logs.
- Interacting: taps, swipes, scrolls, gestures, typing, keys, hardware buttons and rotation.
- Recordings and media: record the screen and feed video or audio into the camera and microphone.
- Xcode builds: build a project for the iOS Simulator, read the build log and install the result.
Limits
Sessions started through MCP close after 5 minutes without activity and after 30 minutes at most. An organization can have at most 3 running at once while an agent is starting them. Organization-wide limits are on the Limits page. Xcode builds through MCP are simulator-only and unsigned. Use the CLI for signed builds.Troubleshooting
Sign-in keeps coming back. The MCP server does not accept API keys. If your client config sends a run.cloud API key (rc_live_...) as an
Authorization header or bearer token, the client keeps sending it after you
sign in, and every tool call fails. Remove the key from the config, for
example bearer_token_env_var or http_headers in Codex’s config.toml,
then sign in again.
Disconnect
- Claude: remove run.cloud under Customize, then Connectors.
- ChatGPT: disconnect run.cloud in the connected apps settings.
- Claude Code:
claude mcp logout run-cloud, thenclaude mcp remove run-cloud. - Codex:
codex mcp logout run-cloud, thencodex mcp remove run-cloud.
remove alone only deletes the local configuration.
Your run.cloud account, apps and builds are not deleted.