# Cortex MCP · Utilise Cortex depuis Claude, ChatGPT ou Gemini

> Connecte Cortex à ton assistant IA en 30 secondes : examens blancs, faiblesses et plan de révision depuis Claude, ChatGPT, Gemini, Cursor ou VS Code. Sans clé API.

Page web : https://cortexexam.com/mcp-fr · English version : https://cortexexam.com/mcp.md · Mis à jour le 16 novembre 2026

Connecte Cortex une fois. Ensuite, demande un examen blanc, tes faiblesses ou un plan de révision avec tes mots : ton assistant le fait dans ton compte Cortex, sur tes cours et tes annales.

## Serveur

- **Adresse** : `https://app.cortexexam.com/mcp`
- **Transport** : Streamable HTTP
- **Authentification** : OAuth 2.1 avec le compte Cortex de l’utilisateur (enregistrement dynamique du client, découverte depuis `https://app.cortexexam.com/.well-known/oauth-protected-resource/mcp`). Ni clé API, ni en-tête.
- **Fiche du serveur** : [https://cortexexam.com/.well-known/mcp/server-card.json](https://cortexexam.com/.well-known/mcp/server-card.json)

## Pour les assistants IA : installer Cortex pour l’utilisateur

```text
Installe pour moi le serveur MCP de Cortex.
1. Lis le guide officiel : https://cortexexam.com/mcp-fr.md
2. Ajoute le serveur MCP distant https://app.cortexexam.com/mcp à l’appli dans laquelle tu tournes, sous le nom « cortex », avec la méthode que le guide donne pour cette appli (Streamable HTTP, OAuth, sans clé API).
3. Si tu ne peux pas modifier tes propres réglages, donne-moi plutôt les étapes exactes pour cette appli.
4. Quand le navigateur s’ouvre, je me connecte avec mon compte Cortex.
5. Vérifie ensuite que ça marche : appelle get_account_status et list_courses, et dis-moi ce que tu vois.
Ne confirme jamais un outil payant à ma place : annonce-moi son coût et attends mon accord.
```

## Demande avec tes mots

Ton assistant choisit le bon outil Cortex. Quelques demandes d’étudiants :

- « Génère-moi un examen blanc de CS-233, au format des annales. » → `generate_mock_exam` (crédits)
- « Quelles sont mes faiblesses ? » → `get_weak_points` (gratuit)
- « Ajoute ce PDF à mon cours de CS-233. » → `add_course_source` (gratuit)
- « Qu’est-ce que je dois réviser d’ici vendredi ? » → `get_study_plan` (gratuit)
- « Pose-moi une question type examen sur les noyaux, puis corrige ma réponse. » → `generate_drill`, `check_answer` (crédits)
- « Où est la preuve du théorème spectral dans les slides ? » → `search_course_materials` (gratuit)
- « Combien de crédits il me reste ? » → `get_account_status` (gratuit)
- « Crée un cours MATH-111 et ajoute les annales de l’an dernier. » → `create_course`, `add_course_source`, `prepare_course` (crédits)

## Connecté en 30 secondes

La même adresse marche partout. Choisis ton assistant.

Les menus sont cités en anglais, comme dans la documentation officielle de chaque appli ; si ton appli est en français, ils portent leur traduction.

### Claude

*Où* : claude.ai, Claude Desktop et les applis mobiles Claude. Toutes les offres, gratuite comprise (un seul connecteur personnalisé sur l’offre gratuite).

1. Sur **claude.ai** ou dans **Claude Desktop**, ouvre **Customize → Connectors**.
2. Clique sur **+ Add**, puis sur **Add custom connector**.
3. Nomme-le **Cortex** et colle l’adresse du serveur :

   ```
   https://app.cortexexam.com/mcp
   ```

4. Choisis **Sign in now**, laisse le reste tel quel, puis clique sur **Add**.
5. Connecte-toi avec ton compte Cortex et autorise l’accès.
6. Dans une conversation, vérifie que Cortex est activé dans le menu des outils, puis demande.

Team ou Enterprise : un propriétaire l’ajoute une fois dans **Organization settings → Connectors → Add → Custom → Web**, puis chaque membre clique sur **Connect**. Sur ton téléphone : ajoute-le une fois sur le web, puis utilise-le depuis l’appli Claude.

### ChatGPT

*Où* : ChatGPT sur le web (chatgpt.com). Business, Enterprise et Edu : un administrateur doit parfois autoriser les serveurs MCP personnalisés. Plus et Pro : OpenAI peut limiter les serveurs personnalisés aux outils de lecture.

1. Ouvre **Plugins**, clique sur **+**, puis sur **Add custom MCP server**. Sur une offre personnelle, si l’option n’apparaît pas, active d’abord le **Developer mode** dans **Settings → Security and login**.
2. Nomme-le **Cortex**. Sous **Connection**, colle l’adresse du serveur :

   ```
   https://app.cortexexam.com/mcp
   ```

3. Choisis l’authentification **OAuth**, coche **I understand and want to continue**, puis clique sur **Create**.
4. Connecte-toi avec ton compte Cortex quand ChatGPT le demande.
5. Dans une conversation, tape **@** et choisis Cortex.

ChatGPT demande ton accord avant chaque action d’écriture, et Cortex annonce le coût de chaque génération avant de la lancer. Si ton offre n’autorise que la lecture, tu as quand même ton plan, tes faiblesses, tes résultats et la recherche ; génère dans l’app.

### Gemini

*Où* : Gemini CLI, avec n’importe quel compte Google. Dans l’appli Gemini, les serveurs MCP personnalisés dépendent de ton offre ou de ton espace de travail ; là où ils sont proposés, colle la même adresse.

1. Ajoute Cortex pour ton utilisateur :

   ```sh
   gemini mcp add --transport http --scope user cortex https://app.cortexexam.com/mcp
   ```

2. Lance **gemini** et connecte-toi :

   ```
   /mcp auth cortex
   ```

3. Une fenêtre de navigateur s’ouvre : connecte-toi avec ton compte Cortex.

Ou dans `~/.gemini/settings.json` :

```json
{
  "mcpServers": {
    "cortex": {
      "httpUrl": "https://app.cortexexam.com/mcp"
    }
  }
}
```

Gemini CLI utilise `httpUrl` pour les serveurs Streamable HTTP ; `url` désignerait un serveur SSE.

### Claude Code

*Où* : Claude Code, dans le terminal, l’appli de bureau ou ton IDE.

1. Ajoute Cortex pour tous tes projets :

   ```sh
   claude mcp add --transport http --scope user cortex https://app.cortexexam.com/mcp
   ```

2. Dans Claude Code, lance `/mcp`, choisis **cortex**, puis **Authenticate** :

   ```
   /mcp
   ```

3. Connecte-toi avec ton compte Cortex dans le navigateur.

Sans `--scope user`, Cortex n’est ajouté qu’au projet en cours. Claude Code affiche le coût d’un outil payant dans une fenêtre de confirmation avant de lancer quoi que ce soit.

### Cursor

*Où* : Cursor, application de bureau.

En un clic : [Ajouter à Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cortex&config=eyJ1cmwiOiJodHRwczovL2FwcC5jb3J0ZXhleGFtLmNvbS9tY3AifQ==)

1. Clique sur **Ajouter à Cursor** et confirme dans Cursor.
2. Quand Cursor se connecte, connecte-toi avec ton compte Cortex. Si la page ne s’ouvre pas, utilise le bouton de connexion à côté de Cortex dans les réglages MCP de Cursor.

Ou à la main, dans `~/.cursor/mcp.json` :

```json
{
  "mcpServers": {
    "cortex": {
      "url": "https://app.cortexexam.com/mcp"
    }
  }
}
```

### VS Code

*Où* : VS Code avec GitHub Copilot Chat, en mode agent.

En un clic : [Ajouter à VS Code](vscode:mcp/install?%7B%22name%22%3A%22cortex%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.cortexexam.com%2Fmcp%22%7D)

1. Clique sur **Ajouter à VS Code**, vérifie, puis installe. Ou lance **MCP: Add Server** depuis la palette de commandes, choisis **HTTP** et colle l’adresse.
2. À la première utilisation, VS Code ouvre une fenêtre de navigateur : connecte-toi avec ton compte Cortex.
3. Dans Copilot Chat, passe en mode agent et demande.

Ou dans `.mcp.json`, à la racine d’un projet :

```json
{
  "mcpServers": {
    "cortex": {
      "type": "http",
      "url": "https://app.cortexexam.com/mcp"
    }
  }
}
```

### Codex

*Où* : Codex CLI et l’extension Codex pour IDE.

1. Dans un terminal :

   ```sh
   codex mcp add cortex --url https://app.cortexexam.com/mcp
   ```

2. Connecte-toi :

   ```sh
   codex mcp login cortex
   ```

3. Dans l’extension : roue dentée → **MCP servers** → **Add server**, choisis **Streamable HTTP**, colle l’adresse, enregistre, puis redémarre l’extension.

Ou dans `~/.codex/config.toml` :

```toml
[mcp_servers.cortex]
url = "https://app.cortexexam.com/mcp"
```

Pas de navigateur sur cette machine ? Ajoute `--no-browser` à la commande de connexion.

### Windsurf

*Où* : Windsurf, dans Cascade.

1. Ajoute Cortex dans `~/.codeium/windsurf/mcp_config.json` :

   ```json
   {
     "mcpServers": {
       "cortex": {
         "serverUrl": "https://app.cortexexam.com/mcp"
       }
     }
   }
   ```

2. Actualise les serveurs MCP dans Cascade. Windsurf ouvre la page de connexion : utilise ton compte Cortex.

Windsurf utilise `serverUrl` pour les serveurs distants.

### Autre client

*Où* : Tout client qui accepte les serveurs MCP distants en Streamable HTTP avec OAuth.

1. Adresse :

   ```
   https://app.cortexexam.com/mcp
   ```

2. Transport : **Streamable HTTP**. Authentification : **OAuth 2.1**, découverte par les métadonnées de ressource protégée du serveur, avec enregistrement dynamique du client. Ni clé API, ni en-tête.

Configuration type :

```json
{
  "mcpServers": {
    "cortex": {
      "type": "http",
      "url": "https://app.cortexexam.com/mcp"
    }
  }
}
```

Un client qui ne lance que des serveurs locaux (stdio) ? Passe par un pont :

```sh
npx mcp-remote https://app.cortexexam.com/mcp
```

Fiche du serveur : [/.well-known/mcp/server-card.json](https://cortexexam.com/.well-known/mcp/server-card.json). Version Markdown de cette page : [/mcp-fr.md](https://cortexexam.com/mcp-fr.md).

## Outils

La lecture est gratuite. Les générations utilisent les mêmes crédits que dans l’app : l’assistant t’annonce d’abord le coût exact, et ne lance qu’après ton accord.

| Outil | Ce qu’il fait | Coût |
|---|---|---|
| `list_courses` | Liste tes cours, avec la date d’examen et les jours restants. | Gratuit |
| `get_study_plan` | Ce qu’il faut réviser ensuite, pondéré par ce qui est tombé aux annales. | Gratuit |
| `get_weak_points` | Tes faiblesses par gravité, et celles à revoir maintenant. | Gratuit |
| `get_results` | Tes examens blancs, tes scores d’entraînement et les corrections. | Gratuit |
| `search_course_materials` | Cherche dans tes slides, tes notes et tes annales, et rend le passage. | Gratuit |
| `get_account_status` | Ton solde, le coût de chaque action et tes limites du jour. | Gratuit |
| `get_job_status` | Suit une génération et rend l’examen dès qu’il est prêt. | Gratuit |
| `create_course` | Crée un cours : nom, code, université, date d’examen. | Gratuit |
| `set_exam_format` | Déclare le vrai format de l’examen : type, nombre de questions, durée. | Gratuit |
| `add_course_source` | Ajoute un document à un cours, depuis une adresse web ou son texte. | Gratuit |
| `report_question` | Signale une question générée fausse ou hors programme. | Gratuit |
| `generate_mock_exam` | Un examen blanc complet, au vrai format de ton cours. Un examen plus long coûte un peu plus. | 5 crédits (écrit) · 4 crédits (QCM) |
| `prepare_course` | Lit tes documents, apprend le format de l’examen et construit le plan du cours. | 2 crédits |
| `generate_drill` | Une question type examen, avec indices et solution rédigée. | 0,3 crédit |
| `check_answer` | Corrige ta réponse comme le ferait l’examinateur. | 0,3 crédit |

Les générations comptent aussi dans les limites du jour de l’app. [Voir les offres](https://cortexexam.com/fr#pricing).

## Sécurité

- **Une connexion, pas de clé.** Cortex utilise OAuth avec ton compte Cortex. Aucune clé API à copier, coller ou perdre ; les jetons d’accès expirent au bout d’une heure et se renouvellent seuls.
- **Tu choisis ce qu’il peut faire.** L’écran d’autorisation le dit noir sur blanc : la lecture est toujours incluse ; générer et ajouter des cours sont des cases que tu peux décocher. Jamais permis : supprimer tes cours ou tes documents, ni toucher à tes paiements.
- **Ton compte, celui de personne d’autre.** Chaque appel s’exécute dans ton compte. Le compte vient de la connexion, jamais de ce que tape l’assistant : le cours d’un autre étudiant n’existe tout simplement pas pour lui.
- **Révoque en un clic.** Dans l’app, ouvre **Mon compte → Applications connectées** et clique sur **Révoquer**. L’accès s’arrête aussitôt.

Le texte de tes documents et des examens générés est traité comme des données, jamais comme des instructions. Détails dans la [politique de confidentialité](https://cortexexam.com/privacy) et les [CGV](https://cortexexam.com/terms).

## Questions

### Le connecteur est-il gratuit ?

Se connecter est gratuit, comme tout ce qui lit ton compte. Les générations utilisent tes crédits Cortex, au même coût que dans l’app, et ce coût t’est annoncé avant de lancer quoi que ce soit. L’abonnement de ton assistant est à part.

### Il me faut un compte Cortex ?

Oui : l’assistant travaille sur tes cours. [Crée ton compte](https://app.cortexexam.com), ajoute un cours, puis connecte ton assistant.

### Il peut envoyer mes PDF ?

Il ajoute un document à un cours depuis une adresse web ou depuis son texte, que ton assistant peut lire dans un PDF que tu lui joins. Pour un dossier entier de slides, dépose-le dans l’app.

### Ça marche sur mon téléphone ?

Dans Claude, oui : ajoute Cortex une fois sur claude.ai, puis utilise-le depuis l’appli mobile. ChatGPT ajoute les serveurs personnalisés sur le web.

### Que voit mon assistant ?

Seulement ce que renvoie un outil : tes cours, ton plan, tes faiblesses, tes résultats, des extraits de tes documents et ton solde. Cette conversation est ensuite traitée par le fournisseur de ton assistant, selon ses propres conditions. Voir notre [politique de confidentialité](https://cortexexam.com/privacy).

## Liens

- Cortex: https://cortexexam.com/fr
- App: https://app.cortexexam.com
- Confidentialité : https://cortexexam.com/privacy
- CGV : https://cortexexam.com/terms
- llms.txt: https://cortexexam.com/llms.txt
