# Circleback MCP (/docs/fr/support/platform/circleback-mcp)

Le serveur Model Context Protocol (MCP) de Circleback fournit une interface standardisée qui permet à toute application d’IA compatible, comme Claude et ChatGPT, d’accéder à vos données Circleback de manière simple et sécurisée.

Une fois la connexion établie, votre assistant IA peut rechercher et consulter vos réunions, e-mails, événements d’agenda et plus encore, sans quitter votre application d’IA. Vous n’avez plus besoin de copier-coller entre Circleback et d’autres applications d’IA.

Le serveur MCP suit la [spécification MCP](https://modelcontextprotocol.io/specification/2025-03-26) des serveurs distants authentifiés : le serveur est donc hébergé et géré de manière centralisée.

## Configuration

### Généralités

Le serveur MCP de Circleback prend en charge le transport Streamable HTTP. Il utilise OAuth pour l’authentification à l’adresse [`https://circleback.ai/api/mcp`](https://circleback.ai/api/mcp), avec l’enregistrement dynamique des clients ou des documents de métadonnées d’ID client.

Les administrateurs de l’espace de travail peuvent également configurer [Enterprise-Managed Authorization](/docs/support/security/enterprise-managed-authorization) pour gérer l’accès des membres à Circleback MCP depuis leur fournisseur d’identité.

### Claude⁠

1. Accédez à **Paramètres** depuis la barre latérale sur le web ou sur desktop
2. Sélectionnez **Connecteurs** dans la barre latérale des paramètres et cliquez sur **Parcourir les connecteurs**
3. Recherchez Circleback et cliquez sur **+** pour le connecter

### ChatGPT

Connectez l’application Circleback pour ChatGPT [ici](https://chatgpt.com/apps/circleback/asdk_app_695308f21c648191a0dd48dc9965f4bb). Une fois la connexion établie, ChatGPT fera automatiquement appel à Circleback lorsque c’est pertinent, par exemple lorsque vous posez une question sur des réunions ou des conversations.

Vous pouvez aussi ajouter explicitement Circleback dans votre message pour vous assurer qu’il est utilisé.

### Raycast

Cliquez [ici](raycast://mcp/install?%7B%22name%22%3A%22Circleback%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//circleback.ai/api/mcp%22%7D) pour installer le serveur MCP de Circleback dans Raycast.

Dans la recherche principale, AI Commands ou AI Chat, saisissez @circleback pour mentionner et utiliser les outils fournis par Circleback MCP.

### Claude Code

1. Ouvrez votre terminal et exécutez la commande suivante
   ```
   claude mcp add --transport http circleback https://circleback.ai/api/mcp
   ```
2. Exécutez `/mcp` une fois une session Claude Code ouverte pour suivre le processus d’authentification

### Cursor

Cliquez [ici](https://cursor.com/marketplace/cursor/circleback) pour ajouter le plugin Circleback depuis le Cursor Marketplace.

### Codex

Les étapes de configuration sont les mêmes, que vous utilisiez l’extension IDE ou la CLI, car la configuration est partagée.

#### Configuration via la CLI

1. Exécutez la commande suivante dans le Terminal
   ```
   codex mcp add circleback --url https://circleback.ai/api/mcp
   ```
   Vous serez automatiquement invité à vous connecter avec votre compte Circleback et à le connecter à Codex.\
   \
   **Remarque** : si c’est la première fois que vous utilisez un MCP dans Codex, vous devrez activer la fonctionnalité `rmcp` pour que cela fonctionne. Ajoutez ce qui suit à votre fichier `~/.codex/config.toml`
   ```
   [features]
   experimental_use_rmcp_client = true
   ```

#### Configuration via les variables d’environnement

1. Ouvrez le fichier `~/.codex/config.toml` dans l’éditeur de votre choix et ajoutez ce qui suit

   ```
   [features]
   experimental_use_rmcp_client = true

   [mcp_servers.circleback]
   url = "https://circleback.ai/api/mcp"
   ```

2. Exécutez `codex mcp login circleback` pour suivre le processus d’authentification

## Ce que vous pouvez faire

Le serveur MCP de Circleback propose des outils pour rechercher, lire et mettre à jour vos données Circleback, regroupés ci-dessous selon ce sur quoi ils portent.

### Réunions

- **SearchMeetings** : trouver des réunions par mot-clé, période, tags, participant, domaine, propriété ou dossier. Avec un mot-clé, la première page inclut aussi les réunions dont les transcriptions correspondent, et chaque réunion indique ses extraits de transcription correspondants, horodatés.
- **ReadMeetings** : obtenir des informations détaillées sur des réunions précises, notamment les notes, vos notes privées, les participants, les tâches, les insights, les tags, les dossiers et la durée.
- **UpdateMeeting** : modifier le nom, les notes, vos notes privées, les tags ou les dossiers d’une réunion.
- **ShareMeeting** : partager une réunion avec une personne, une équipe, l’espace de travail ou toute personne disposant du lien, ou retirer l’accès.
- **DisplayMeetings** : afficher les réunions sélectionnées sous forme de cartes sur lesquelles vous pouvez cliquer pour les ouvrir dans Circleback, dans les applications d’IA compatibles avec MCP Apps. Les autres applications les reçoivent sous forme de texte.

### Transcriptions

- **GetTranscriptsForMeetings** : obtenir la transcription complète d’une ou plusieurs réunions, avec les noms des intervenants et les horodatages.

### Tâches

- **SearchActionItems** : trouver des tâches par mot-clé, statut (en attente ou terminée), personne assignée, tag, domaine ou période.
- **CreateActionItem** : créer une tâche, éventuellement avec une description ou liée à une réunion. Elle vous est assignée, sauf si vous désignez quelqu’un d’autre ou demandez à la laisser non assignée.
- **UpdateActionItem** : modifier le titre, la description, le statut ou la personne assignée d’une tâche.
- **DeleteActionItem** : supprimer une tâche.
- **DisplayActionItems** : afficher les tâches sélectionnées sous forme de liste que vous pouvez cocher et réassigner, dans les applications d’IA compatibles avec MCP Apps. Les autres applications les reçoivent sous forme de texte.

### Agenda

- **SearchCalendarEvents** : rechercher des événements d’agenda à venir et passés, y compris les participants, les liens de réunion et le statut de participation.
- **UpdateCalendarEvent** : modifier les notes privées ou les tags d’une réunion avant qu’elle ne commence.
- **DisplayCalendarEvents** : afficher les événements d’agenda à venir sous forme de cartes avec un interrupteur indiquant si Circleback rejoint la réunion, dans les applications d’IA compatibles avec MCP Apps. Les autres applications les reçoivent sous forme de texte.

### E-mails

- **SearchEmails** : rechercher des fils de discussion dans les comptes e-mail connectés par mot-clé, expéditeur, destinataire ou période.

### Personnes et entreprises

- **FindProfiles** : rechercher des personnes par nom pour obtenir leur e-mail, leur fonction et leur entreprise.
- **FindCompanies** : rechercher des entreprises par nom ou domaine.

### Tags

- **ListTags** : lister tous les tags de votre espace de travail, utile pour filtrer les réunions, les transcriptions ou les tâches.
- **CreateTag**, **UpdateTag**, **DeleteTag** : créer, renommer, changer la couleur ou supprimer des tags.

### Dossiers

- **ListFolders** : lister les dossiers que vous pouvez voir dans votre espace de travail, avec leurs ID.
- **ReadFolders** : obtenir les membres, les équipes et les règles d’un dossier.
- **CreateFolder**, **UpdateFolder**, **DeleteFolder** : créer, renommer, modifier les règles ou supprimer des dossiers.
- **ShareFolder** : partager un dossier avec une personne, une équipe, l’espace de travail ou toute personne disposant du lien, modifier leur accès ou les retirer.

### Espace de travail

- **ListTeams** : lister votre espace de travail et ses équipes, avec les ID utilisés pour le partage.

### Assistance

- **SearchSupportArticles** : rechercher dans la documentation d’assistance de Circleback de l’aide et des guides pratiques.
- **SubmitFeedback** : envoyer un commentaire, un rapport de bug ou une demande de fonctionnalité à l’équipe Circleback.

## Accès en écriture

Les outils qui apportent des modifications, comme la création ou la suppression d’une tâche, nécessitent un accès en écriture. Circleback le demande lors de la connexion, et votre application d’IA peut tout de même vous demander de confirmer chaque modification. Si vous vous êtes connecté avant que ces outils ne soient disponibles, déconnectez puis reconnectez Circleback dans votre application d’IA pour accorder l’accès en écriture.

Par défaut, la connexion accorde un accès en lecture et en écriture (`scope=user user:write`). Si votre application n’a besoin que d’un accès en lecture seule, transmettez plutôt `scope=user` dans la demande d’autorisation. Les outils qui apportent des modifications renvoient alors une erreur demandant à l’utilisateur de se reconnecter avec un accès en écriture.