Overview
Yoodli MCP Server connects Yoodli to an AI tool through the Model Context Protocol (MCP). From a chat, the tool can find roleplays, create a practice roleplay, and return a link. The person still practices inside Yoodli. The card is marked Early access, and an organization admin enables it before anyone can connect. The same server serves Claude, ChatGPT, Gemini Enterprise, and Copilot Studio.
Three roles take part. A Yoodli organization admin enables MCP. Yoodli is then added in the AI tool, by the tool's admin or by each person, depending on the tool and its plan. Each person then signs in to Yoodli and selects Authorize.
A tool connects in one of two ways. Some tools register themselves (dynamic client registration): you paste the server URL and leave the OAuth client ID empty. Other tools ask for an OAuth client ID and an OAuth client secret, which come from an MCP client that a Yoodli organization admin creates.
The tool acts as the person who selected Authorize, using that person's Yoodli account.
What it looks like when it's done
Here's the finished setup for an organization that connects an AI tool. Each setup article shows it for that tool.
In Yoodli
On the Integrations page, the Yoodli MCP Server card shows its switch Enabled, and a content space is selected for organization roleplays created through MCP.
In the AI tool
Yoodli is added with the server URL. A tool that asks for an OAuth client ID and an OAuth client secret uses the values from an MCP client created in Yoodli.
The result
A person selected Authorize on the Yoodli consent page.
The person asks for a roleplay. The tool creates it in Yoodli and returns a practice link, and the person practices inside Yoodli.
Setting it up
Each AI tool has its own setup article. Each one has the same Yoodli steps (turn on MCP, create an MCP client when the tool needs one, and authorize), plus that tool's own steps and troubleshooting.
Which AI tools register themselves, and which need an MCP client?
Claude and ChatGPT can register themselves, Gemini Enterprise always needs an MCP client, and Copilot Studio needs one only when Dynamic discovery fails.
Claude (MCP - Set up for Claude): select Register automatically. With Use your own OAuth client, create an MCP client.
ChatGPT (MCP - Set up for ChatGPT): select OAuth and leave the client ID empty. To paste a client ID, create an MCP client.
Gemini Enterprise (MCP - Set up for Gemini Enterprise): create an MCP client first.
Copilot Studio (MCP - Set up for Copilot Studio): try Dynamic discovery first. If that fails, create an MCP client for Manual OAuth.
Using Yoodli from your AI tool
Use these to know what the AI tool can do in Yoodli once it's connected, and where its roleplays go.
What can the AI tool do in Yoodli once it's connected?
It can list roleplays, report create access, list goals, create a roleplay with a practice link, and open the Yoodli builder, acting as the person who selected Authorize. The tool uses that person's Yoodli account.
List the roleplays assigned to this person, and this person's personal roleplays (list_user_roleplays).
Report personal create access and organization create access (check_builder_access).
List goals for the selected roleplay type (list_roleplay_resources).
Create a roleplay from the chat and return a practice link (create_contextual_roleplay).
Open the Yoodli builder when the person asks for it (launch_builder).
Where does a roleplay created through MCP go?
An organization roleplay goes to the content space selected on the Yoodli MCP Server card. A personal roleplay stays with the person who creates it.
The goals offered for an organization roleplay come from that space, the organization's global space, and Yoodli's default goals.
An organization roleplay starts with no groups, so it appears in no one's roleplay list, including its creator's, until an admin assigns it. To assign it, in the admin view, select that content space under Content and open Roleplays. Select None in the roleplay's Available to column, select the groups (or Select all), then select Done.
A space admin can create an organization roleplay only when the content space on the card is a space that this admin manages. When that check fails, the person can still create a personal roleplay.
Troubleshooting
I created an organization roleplay, but no one can find it
Assign it to groups. An organization roleplay created through MCP starts with no groups. See Where does a roleplay created through MCP go?
Still stuck? Email [email protected] with the AI tool you're connecting, the error or page it shows, and your Yoodli organization name.