---
name: runner-setup
description: Connect Runner to the assistant or coding agent you are running in, over MCP with the person's own Runner sign-in, then confirm it with one read.
---

# Connect Runner

Runner is an AI growth team built from your code or your POS sales. Connected to an assistant, it reads the business numbers of the products the person chooses: visits and the Google searches that found them, ads, deals, revenue, posts, and what needs their attention. With Can draft on, it can also save drafts. Nothing posts until a person approves it in Runner.

## The server

- URL: https://app.runtheworld.ai/api/mcp
- Transport: Streamable HTTP
- Sign-in: OAuth 2.1 with PKCE. The client registers itself. There is no API key.

## 1. Find out where you are running

- A terminal session with the `claude` command (Claude Code sets `CLAUDECODE=1`): follow **Claude Code**.
- Claude on claude.ai or the desktop app: follow **Claude**. The person adds it, so give them the steps.
- ChatGPT: follow **ChatGPT**. The person adds it, so give them the steps.
- Any other MCP client: follow **Another client**.

## 2. Add Runner

### Claude Code

```bash
claude mcp add --transport http --scope user runner https://app.runtheworld.ai/api/mcp
claude mcp login runner
```

Skip the first command if `claude mcp list` already shows `runner`. The second opens the person's browser on Runner's sign-in and waits until they finish, so run it in the background: they sign in, tick the products this session may see, and press Allow access. If the tools do not appear in this session, ask them to type `/mcp`, choose runner and press Reconnect.

### Claude

1. Open Customize → Connectors, press + Add and choose Add custom connector.
2. Name it Runner, enter https://app.runtheworld.ai/api/mcp and press Continue. If Claude asks how to set up its OAuth client, choose Register automatically.
3. Press Connect, sign in to Runner, tick the products Claude may see and press Allow access.
4. In a chat, press +, open Connectors and switch Runner on.

On a Claude Team or Enterprise plan, an owner adds it first under Organization settings → Connectors.

### ChatGPT

1. On ChatGPT on the web, open chatgpt.com/plugins, press + and choose Add custom MCP server.
2. Name it Runner, enter https://app.runtheworld.ai/api/mcp as the Server URL and choose OAuth.
3. Accept ChatGPT's risk notice, choose Create as a plugin, then install it.
4. In a chat, type @ and pick Runner. The first time ChatGPT uses it, Runner's sign-in opens: tick the products ChatGPT may see and press Allow access.

### Another client

Add https://app.runtheworld.ai/api/mcp as a remote HTTP server that signs in with OAuth. The client needs Streamable HTTP, OAuth 2.1 with PKCE (S256) and dynamic client registration. The person signs in in their own browser.

## 3. Confirm with one read

Call `projects_list`. It takes no arguments and only reads. Show the person the product names it returns. If the client reports that Runner needs authentication, the sign-in has not finished: run `claude mcp login runner` again, or reconnect Runner in the client.

## Rules

- Never ask for, paste, print or store a token, password, cookie, authorization code or redirect URL. Sign-in happens in the person's browser.
- The person signs in and presses Allow access themselves. Never press it for them.
- Approve only what the sign-in asks for. Add no scopes to the client's config; which products to tick, and whether Can draft stays on, is the person's choice.
- During setup, call only `projects_list`. Call nothing that drafts, saves, schedules or changes data.

## More

- The guide for people: https://www.runtheworld.ai/guides/use-runner-in-claude-and-chatgpt
- To disconnect: in Runner, open Settings → MCP clients and press Revoke.