Aller au contenu
Screeb Help CenterCentre d'aide
Ouvrir Screeb

Connecter un assistant IA au serveur MCP de Screeb

Laissez Claude, ChatGPT, Cursor ou un autre client MCP lire vos données Screeb et répondre à vos questions, après connexion et choix d'une organisation.

Guide pratique4 min de lecture, mis à jour le 15 oct. 2026

Le serveur MCP de Screeb permet à un assistant IA comme Claude, ChatGPT ou Cursor de lire vos données Screeb et de répondre à des questions comme “De quoi se plaignent les utilisateurs dans mon enquête NPS ce mois-ci ?”. Vous vous connectez avec votre compte Screeb et choisissez l’organisation que l’assistant peut lire.

  • Votre compte Screeb est membre de l’organisation à connecter.
  • Votre assistant IA ou votre éditeur de code prend en charge les serveurs MCP distants avec connexion OAuth, comme Claude, ChatGPT, Cursor, Claude Code ou Visual Studio Code. Un client qui n’accepte qu’un jeton d’API fixe ne peut pas se connecter.
  • L’accès est en lecture seule : l’assistant ne peut rien modifier dans Screeb.
  1. Ouvrez votre organisation, cliquez sur Paramètres dans sa barre latérale puis, sous IA, sur Général. Les paramètres de l’organisation ne s’affichent que pour les Admins : en tant que Member, ouvrez directement la page des paramètres IA généraux.
  2. Dans la section Serveur MCP, copiez l’adresse.
Les paramètres IA généraux d'une organisation, avec la section Serveur MCP et son adresse prête à copier

La plupart des comptes utilisent https://mcp.screeb.app/mcp. Les comptes hébergés sur un environnement Screeb dédié ont leur propre adresse : copiez toujours celle affichée dans votre admin.

  1. Ouvrez les réglages de connecteurs ou de serveurs MCP de votre assistant. Dans Claude, ce sont Paramètres, puis Connecteurs, puis Ajouter un connecteur personnalisé.
  2. Saisissez un nom, par exemple Screeb, et l’adresse du serveur. Aucun jeton ni clé d’API n’est nécessaire.
  3. Enregistrez, puis connectez-vous. L’assistant ouvre une fenêtre de connexion Screeb.

Dans un éditeur de code ou un outil en ligne de commande, ajoutez le serveur à sa configuration MCP. Pour Claude Code :

Fenêtre de terminal
claude mcp add --transport http screeb https://mcp.screeb.app/mcp

Pour Cursor, dans .cursor/mcp.json :

{
"mcpServers": {
"screeb": { "url": "https://mcp.screeb.app/mcp" }
}
}
  1. Connectez-vous avec votre compte Screeb, si ce n’est pas déjà fait.
  2. Sur l’écran d’autorisation, choisissez une organisation dans Organisation. L’accès demandé est “Lire vos workspaces et les données de vos enquêtes”.
  3. Cliquez sur Autoriser. Vous revenez dans votre assistant, désormais connecté.
L'écran d'autorisation Screeb, avec le choix de l'organisation, l'accès en lecture demandé et le bouton Autoriser

L’assistant peut lire une seule organisation, et seulement les workspaces auxquels votre compte a accès. Pour le connecter à une autre organisation, reconnectez-vous depuis l’assistant et choisissez-la.

Le serveur fournit trois outils en lecture seule à votre assistant, qui les choisit seul selon vos questions.

Outil Ce qu’il fait
list_workspaces Liste les workspaces de l’organisation auxquels vous avez accès.
search_surveys Trouve des enquêtes et des messages par nom ou par tag, avec leur statut, leur nombre de réponses et leurs questions.
ask_screeb_ai Pose à Screeb AI une question sur vos données : réponses et scores, segments, événements, sessions et messages.

Si l’organisation n’a qu’un workspace, l’assistant l’utilise. S’il y en a plusieurs, nommez-en un dans votre question (“dans le workspace Marketing”), dites “sur tous les workspaces”, ou répondez quand l’assistant vous demande d’en choisir un. Les questions suivantes d’une même conversation gardent le contexte des précédentes.

  1. Cliquez sur votre nom en bas de la barre latérale, puis sur Compte.
  2. Dans Applications connectées, repérez l’assistant et l’organisation qu’il peut lire.
  3. Cliquez sur Révoquer. L’assistant perd l’accès en une heure au plus, et doit repasser par la connexion pour se reconnecter.
La section Applications connectées des paramètres du compte, avec un assistant, son organisation et un bouton Révoquer

L’accès est accordé par organisation : en révoquer une laisse les autres connectées.

Votre assistant répond avec des chiffres et des synthèses calculés à partir de vos données Screeb, sans export ni tableau de bord. Chaque assistant connecté apparaît dans les paramètres de votre compte, d’où vous pouvez le retirer à tout moment.

L’assistant n’arrive pas à se connecter. Comparez l’adresse avec la section Serveur MCP de votre admin, et vérifiez que votre assistant gère la connexion OAuth pour les serveurs MCP distants.

L’écran d’autorisation indique “Échec de l'autorisation”. La demande de connexion expire au bout de 10 minutes. Relancez la connexion depuis votre assistant.

Votre organisation n’est pas dans la liste. Votre compte n’en est pas membre. Demandez à un administrateur de cette organisation de vous inviter.

L’assistant demande quel workspace utiliser. Nommez le workspace dans votre question, ou dites “sur tous les workspaces”.

L’assistant vous demande de vous reconnecter. Cela arrive en général après plusieurs semaines sans utilisation, ou après une révocation. Repassez par la connexion et l’autorisation.