MCP (Model Context Protocol) lets you connect Sana Learn directly to an AI assistant like Claude and ChatGPT. It can help you query the content you have in Sana and pull learning data and insights, all from within your existing chat client.

Your connected AI client can also make changes for you. It can create a course from scratch or from one you already have, edit its content, and update its settings. It can assign and unassign people to courses and sessions, create groups and smart groups, enroll users in a program, schedule sessions, and create certificates and issue them.

Enabling MCP in Sana Learn

Before you start

You'll need:

Organization admin access in Sana: MCP is enabled at the org level, so you'll need an admin to complete step 1.
An MCP-compatible AI client installed.

Step 1: Enable MCP

As an Organization admin, go to Settings > MCP in Sana Learn.

Toggle on Enable MCP.
Under Allowed scopes, choose which permissions connected tools can use.
By default both are enabled:
1. Read insights (insights:read): lets connected tools read insights data, such as completions and learner progress
2. Read content (content:read): lets connected tools view courses and their contents
Uncheck any scope you'd like to restrict.

💡 Changes take effect immediately, so double check your scopes before saving.

Step 2: Copy your Server URL

On the same MCP settings page, find the Server URL box under 'Connect'

Copy this URL, you'll need it in the next step.
It will look something like: https://[your platform url].sana.ai/mcp

Step 3: Connect with your AI assistant

Connect with ChatGPT

Navigate to Plugins and click the Add menu dropdown. Click Create MCP App
Give the new plugin a Name and add the URL from the Organization Admin page. Make sure to check the “I understand and want to continue” checkbox.
Sign in with Sana Learn and accept all scopes you want to allow.

Connect with Claude Desktop

Open Settings > Connectors and Your connectors and click Add
Add the URL from the Organization Admin page and give your MCP a name. Click Continue
Make sure Sign in now and Register automatically is selected then click Add.
Follow the login instructions and you are done.

Connect with Codex

Adding Sana Learn MCP to codex should be a single command

codex mcp add sana --url <Your server URL>

For more information about how to work with MCPs in Codex please read their documentation

Connect Claude Code

 claude mcp add --transport http sana <Your server URL>

For more information about how to work with MCPs in Claude Code please read their documentation

Connect Copilot

We support Copilot, please read Microsofts documentation on how to add an MCP server to Copilot.

How scopes and permissions work?

Everything an external client does runs as you. If you cannot do something in Sana Learn yourself, you cannot do it through a client either. On top of that, your organization and you can narrow what a client is allowed to do.

Every tool call passes three checks, in this order:

Your role in Sana Learn. Your role decides what you can see and change. A client never gets more than your role gives you.
What your organization allows. When an administrator enables MCP, they choose which scopes clients can ask for. An organization can, for example, allow reading but not writing.
What you approved when you connected. When you authenticate your client against Sana Learn, you choose which of those scopes to grant. If you do not want the AI assistant to write anything, turn write access off here.

Setup Guide: Sana Learn MCP