Connecting the AI Assistant (MCP) to the Platform¶

Overview¶

The AI assistant allows to use popular AI chats — Claude, ChatGPT, and others — to work with platform data directly in conversation. For example, you can ask about courses, assignments, or students without leaving the chat.

The platform provides an AI assistant via a remote MCP (Model Context Protocol) server. Once connected, AI clients such as Claude, Claude Code, ChatGPT, and Codex can work with platform data directly in the chat.

MCP server URL: https://mcp.prosvita.net/

ℹ️ The connection is established via OAuth login. When connecting a client, a browser window opens asking you to sign in to your platform account and grant access permission. No API keys or tokens need to be copied manually.

⚠️ An active platform account is required. The AI assistant will only see data that your account has access to. For example, a teacher sees their own classes, not the classes of the entire school, etc.

How to Integrate the AI Assistants on the Platform¶

The platform provides an AI assistant via a remote MCP (Model Context Protocol) server. Once connected, AI clients such as Claude, Claude Code, ChatGPT, and Codex can work with platform data directly in the chat.

MCP server URL: https://mcp.prosvita.net/

ℹ️ The connection is established via OAuth login. When connecting a client, a browser window opens asking you to sign in to your platform account and grant access permission. No API keys or tokens need to be copied manually.

⚠️ An active platform account is required. The AI assistant will only see data that your account has access to. For example, a teacher sees their own classes, not the classes of the entire school.

Claude (Web & Desktop App)¶

Custom connectors are available on Claude Pro, Max, Team, and Enterprise plans.

Under the Free Plan, only one connector can be added.

Open Claude.ai in your browser or the Claude Desktop app.
Sign in to your Claude account. Claude may ask you to verify your phone number via a one-time code.
Go to the menu on the left: Customize → Connectors.
Click "+" → "Add custom connector".
A configuration form will open.
Enter a connector name. For example, "Prosvita MCP". Paste the MCP server URL:
```
https://mcp.prosvita.net/
```
Click "Add", then "Connect".
A browser window will open on the platform login page.

If you already have an active browser session where you are logged in to your platform account, this step will be skipped and you will be redirected directly to the consent screen in Step 10.
Sign in to your platform account.
A consent screen will appear listing the permissions the AI assistant will have access to.
Click "Allow".
After granting consent, you will be automatically redirected to the Claude chat window with the connector already activated.

⚠️ On Team and Enterprise plans, the organisation owner must first add the connector under Organization Settings → Connectors before members can use it.

Claude Code¶

Claude Code is an AI assistant by Anthropic that runs directly in your terminal (command line on your computer). Claude Code is a paid developer tool.

What is a terminal (command line)?¶

A terminal is an application where you enter text commands instead of clicking with a mouse. It typically appears as a dark (or light) window with a blinking cursor. You simply type a command and press Enter.

How to open a terminal?¶

Operating System	How to Open
Windows	Press `Win + R`, type `cmd` or `powershell`, then click OK
macOS	Press `Cmd + Space`, type `Terminal`, then press Enter

Connecting Claude Code to the Platform¶

The steps below only need to be completed once (the --scope user flag makes the Prosvita server available across all your projects). After that, Claude Code will remember it permanently.

Open the terminal (as described above).

Copy the command below exactly as shown. Do not change any characters:

claude mcp add --transport http prosvita https://mcp.prosvita.net/ --scope user

Paste it into the terminal (Ctrl+V on Windows, Cmd+V on macOS) and press Enter.
The following message should appear in the terminal:
```
Added MCP server "prosvita"
```
If this message appears, the server has been added successfully. Proceed to the next steps.

If you see an error message instead (any red text or messages containing words such as error, not found, etc.), Claude Code is either not installed or installed incorrectly. Reinstall Claude Code.

Launch (or restart) Claude Code. After startup, Claude Code displays the main screen:

╭─────────────────────────────────────────╮
│  Claude Code  v2.x.x                    │
│  Welcome back!                          │
│                                         │
│  Sonnet 4.x · API Usage                 │
│  /your/project/path                     │
│                                         │
│  Tips for getting started:              │
│  > Run /mcp to check connections        │
│  > Use claude to help with files...     │
╰─────────────────────────────────────────╯
>

The blinking cursor after > is the command input field.

Check the connection by entering the command /mcp and pressing Enter.
Claude Code will detect that the server requires authorization and open a browser window.
```
MCP Servers:
prosvita  ⚠  Needs authorization
→ Opening browser for authentication...

>
```
ℹ️ If you have previously authenticated on the platform, the browser may open directly to the consent screen where you can grant permissions for platform actions.
After Claude Code opens the browser, the platform login page will appear.
Sign in to your platform account.
A consent screen will be displayed showing the permissions the AI assistant will receive.
Click "Allow".
Run /mcp from Step 7 again. The prosvita server should now appear as connected with a list of available tools.
```
MCP Servers:
prosvita  ✓  connected (12 tools)
```

ℹ️ Run claude mcp list to verify that the server is registered, or use /mcp within the session to check the current connection status.

ChatGPT¶

Custom MCP connectors work in Developer Mode, available on ChatGPT Plus, Pro, Business, Enterprise, and Edu accounts in the web version.

ℹ️ The connection is configured through the ChatGPT website. The mobile app is not supported.

Open ChatGPT.com and sign in to your account.
Click your name in the bottom-left corner of the page and open Settings.
Go to Settings → Apps → Advanced Settings and enable Developer Mode.
Return to the Apps menu and click Create App.
Enter a name (for example, Prosvita AI) and a short description.
In the Server URL field, enter:
```
https://mcp.prosvita.net/
```
For Authentication, select OAuth and click Create.
Enable the Reference memories and chats toggle.
Click "Sign in via Prosvita AI".
A consent screen will appear listing the permissions the AI assistant will have access to (if you are already logged in to the platform).
Grant access permission using your platform account by clicking "Allow" in the browser window.
After granting permission, you will be automatically redirected to the ChatGPT chat window with a notification that the AI assistant is connected. These settings can also be used later to disconnect the assistant, rename it, and manage its configuration.

Codex CLI¶

Codex connects to remote servers via its configuration file.

Open ~/.codex/config.toml and add the server. The experimental_use_rmcp_client setting enables the OAuth flow for remote HTTP servers.
```
experimental_use_rmcp_client = true

[mcp_servers.prosvita]
url = "https://mcp.prosvita.net/"
```
Save the file and start Codex.
On first use, Codex opens a browser window for authorization — log in with your platform account and click Authorize.
Codex now lists the prosvita tools and can use them during a session.

ℹ️ You can also register the server interactively with codex mcp add, then confirm it with codex mcp list.

Troubleshooting¶

"Authorization required" or repeated login prompts — your session may have expired. Reconnect the server and complete the browser sign-in again.
The client cannot reach the server — make sure https://mcp.prosvita.net/ is reachable from your network and is not blocked by a firewall, VPN, or proxy.
Tools are missing or limited — the AI Assistant only sees what your platform account is allowed to access. Check your role and permissions on the platform.

Use Cases¶

After connecting the connector through one of the AI assistants described above, the chat window will display a list of available MCP tools and the actions that can be performed according to the user's permissions on the platform.

Let's take the Gamification module as an example.

Example 1:

Type the following request in the AI assistant chat:

"Provide me with a list of all active quests on the platform."

The AI assistant will verify that the Prosvita MCP connector is connected and will return a list of active quests from the Gamification module.

Example 2:

Enter the following request:

"Find the quest 'Your Personality'."

The AI assistant will retrieve and display information about the quest directly from the platform through the connector.

The AI assistant will then ask what action should be performed with the retrieved information. Depending on the permissions granted to the user's role on the platform, the following actions may be available:

Quests:
- Create, update, and delete quests
- Assign and remove tasks from quests
- Search for quests and retrieve quests by ID

Events:
- Create, update, and delete events
- Retrieve events by type
- Manage event types

Objects and Packages:
- Search and autocomplete game objects
- Create object packages for quests and events

Other:
- Synchronize RPC methods
- Manage packages

As a result, the Prosvita MCP connector enables users to manage platform gamification directly from an AI chat without accessing the administration panel.

Practical Benefits:

Speed - instead of navigating through multiple interface screens, you can simply type "create a quest with the following conditions," and the quest will be created;
Convenience - search, editing, and review of quests, events, and objects can all be performed in a single place;
AI Assistance - the AI assistant can suggest reward balancing, generate quest descriptions, and recommend completion requirements;
Bulk Operations - you can ask the assistant to update multiple quests at once or analyze the entire gamification structure.