> ## Documentation Index
> Fetch the complete documentation index at: https://docs.realtalkstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Real Talk Studio to ChatGPT

> Add Real Talk Studio as a custom remote MCP app in ChatGPT (developer mode).

<Info>
  **Beta** — Real Talk Studio’s MCP integration is in beta. ChatGPT **developer mode** (custom remote MCP) is also in beta; UI labels, plan limits, and write-tool access may change. See OpenAI’s [ChatGPT developer mode](https://platform.openai.com/docs/guides/developer-mode) documentation for the latest details.
</Info>

Use this guide to connect Real Talk Studio’s conversation simulations to **ChatGPT** on the **web**. Once connected, you can ask ChatGPT to create roleplay simulations in natural language.

This is **not** the ChatGPT Apps Directory listing. Real Talk Studio is added as a **custom MCP app** in developer mode.

***

## What you'll need

* A **ChatGPT** account on a plan that supports **developer mode** — **Plus**, **Pro**, **Business**, **Enterprise**, or **Education**, on **chatgpt.com**. Custom MCP is configured on the **web app**, not in the mobile app.
* On **Business**, only **admins / owners** can enable developer mode (each person turns it on for themselves). On **Enterprise / Education**, a workspace admin may need to grant developer-mode access first (RBAC).
* Your **Real Talk Studio MCP server URL** (for example `https://www.realtalkstudio.com/api/mcp`). Do **not** use the apex host or `app.realtalkstudio.com` (Supabase).
* **OAuth** — ChatGPT can register itself automatically. Paste a Client ID and secret only if the connector asks for them.
* An **organization admin** Real Talk Studio login to complete the browser consent screen.

***

## Enable developer mode

1. Sign in to [ChatGPT](https://chatgpt.com) in a browser.
2. Open **Settings**.
3. Open **Security and login** (on some accounts this is **Apps** → **Advanced settings**).
4. Turn on **Developer mode**.

If you do not see the toggle, your plan or workspace policy does not allow custom MCP yet. Ask a workspace admin, or confirm you are on a supported paid plan.

***

## Add Real Talk Studio as a custom MCP app

1. Go to **[ChatGPT Plugins](https://chatgpt.com/plugins)** (or **Settings → Apps** / **Apps & Connectors**, depending on your UI).
2. Select the **+** / **Create** button. This only creates a developer-mode app after Developer mode is on.
3. Fill in:

| Field              | Value                                                                           |
| ------------------ | ------------------------------------------------------------------------------- |
| **Name**           | Real Talk Studio                                                                |
| **Description**    | Creates interactive roleplay simulations for workforce practice.                |
| **MCP server URL** | The URL from Real Talk Studio, including the `/api/mcp` path                    |
| **Authentication** | **OAuth** — enter the **Client ID** and **Client Secret** from Real Talk Studio |

4. Create / connect the app. ChatGPT discovers the tool catalog over **Streamable HTTP**.
5. Complete the **browser consent** flow: sign in as a Real Talk Studio **organization admin**, choose the organisation if prompted, and approve access.

If ChatGPT shows a **redirect URI** on the connector page and consent fails after login, send that exact URI to Real Talk Studio so it can be added to the OAuth client allowlist.

Created apps typically appear under **Drafts** (or **Enabled Apps**) with a **Dev** label.

***

## Use Real Talk Studio in a chat

1. Start a **new conversation** on ChatGPT web.
2. Open the **+** (Plus) menu, choose **Developer mode**, and **enable** the Real Talk Studio app for that conversation.
3. Ask ChatGPT to create a simulation, for example:

> "Create a roleplay simulation where a manager needs to give difficult feedback to a team member about consistent late delivery of work."

ChatGPT should invoke the Real Talk Studio tool and return a simulation link. **Approve** the tool request if ChatGPT asks for confirmation — create, archive, refine, and similar tools are treated as write actions.

You can also ask ChatGPT to **list**, **read**, or **archive** org simulations, **add** one to a studio, or pull a **usage report** (`get_org_report`). ChatGPT can **test** 1:1 and team scenarios (`test_simulation` — predicted example transcript + realism, not a live engine run). **Refine** (`refine_simulation` — propose then confirm with `expected_updated_at`) is 1:1 only and can change backstory, structure, avatar fields, the **learning objective**, and **skill good/poor examples** (the score rubric). Preview links need login and organization credits. Soft-archive hides a scenario from the org catalog but does not remove studio links or archive personas. Studios with domain restrictions return an iframe embed snippet instead of a bare learner URL.

If ChatGPT does not pick the tool, be explicit: *“Use the Real Talk Studio `create_simulation` tool to …”*

***

## Important notes

### Network and firewall

Remote MCP calls are made from **OpenAI’s infrastructure**, not from your laptop. Your Real Talk Studio MCP URL must be reachable from the public internet. If connections fail only from ChatGPT but work from your browser, review any WAF, geo, or IP allowlists alongside [Real Talk Studio firewall guidance](/it-admin/firewall-configuration).

### Transport

ChatGPT supports **Streamable HTTP** and SSE. Real Talk Studio’s MCP server uses **Streamable HTTP**, which is the URL you paste (ending in `/api/mcp`).

### Trust and approvals

Custom MCP apps can run arbitrary tools. Only connect to **Real Talk Studio URLs** your organisation issued, review each write-tool confirmation, and follow OpenAI’s guidance in [ChatGPT developer mode](https://platform.openai.com/docs/guides/developer-mode) (prompt injection, write-action risk, untrusted servers).

### OAuth

Real Talk Studio uses OAuth 2.1 (not an unauthenticated MCP URL). ChatGPT can register itself automatically; if it asks for a Client ID, paste the pre-registered credentials from your Real Talk Studio admin. Do not choose **No authentication**. Org admins can review and revoke access under **Organization → Integrations**.

***

## Troubleshooting

| Issue                               | What to try                                                                                                                                                         |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No Developer mode toggle            | Confirm Plus / Pro / Business / Enterprise / Education on **web**; on workspace plans, an **admin** may need to enable it (and on Business only admins can use it). |
| No **+** / **Create** button        | Developer mode is off, or you are on mobile. Turn it on under Settings, then use chatgpt.com.                                                                       |
| OAuth / consent fails               | Confirm Client ID and secret; complete consent as an **org admin**. If ChatGPT shows a redirect URI, send it to Real Talk Studio to allowlist.                      |
| Connection or timeout errors        | Ensure the MCP URL is `https://www.realtalkstudio.com/api/mcp` (not apex, not `app.`), TLS is valid, and OpenAI can reach the host.                                 |
| Tools never run                     | Enable **Developer mode** and the Real Talk Studio app in the conversation’s **+** menu. Use prompts that mention **roleplay**, **simulation**, or the tool name.   |
| Tools listed but greyed out         | Refresh the app from its details page so ChatGPT re-scans the catalog.                                                                                              |
| Connector drops after about an hour | Disconnect and reconnect so ChatGPT can refresh the OAuth token, then complete consent again.                                                                       |

***

## Further reading

* OpenAI: [ChatGPT developer mode](https://platform.openai.com/docs/guides/developer-mode)
* OpenAI Help: [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)
* OpenAI: [MCP authentication (OAuth 2.1)](https://developers.openai.com/apps-sdk/build/auth)

***

## Need help?

Contact the Real Talk Studio team at [realtalkstudio.com](https://realtalkstudio.com) for MCP URLs, authentication, and simulation setup. For ChatGPT-specific developer-mode behaviour, use [OpenAI Help](https://help.openai.com/).
