Intégrations / Serveur MCP
IntégrationsMis à jour le 24 octobre 2026
Serveur MCP
Référence des outils, compatibilité du protocole et contrôle d'accès des clients
Version : Ce guide décrit Parrot Scribe 1.1.0.
Nécessite Parrot Scribe Pro. L'accès au serveur MCP fait partie de Parrot Scribe Pro. Les licences existantes incluent déjà Pro.
Pour Claude, Codex et Cursor, commencez par Connecter votre agent. Ce guide utilise Réglages > Apps IA. Écouter et récapituler explique le fonctionnement après la connexion.
Qu'est-ce que MCP ?
Le Model Context Protocol (MCP) permet aux assistants d'IA d'utiliser des outils et des données externes par une interface structurée. Parrot Scribe comprend un serveur MCP local et un auxiliaire signé qui y connecte les applications d'IA. Chaque application a besoin de sa propre connexion. Le plugin ajoute les instructions d'écoute et de récapitulation lorsque cela est pris en charge.
Fonctionnement
Parrot Scribe prend lui-même en charge toutes les lectures et écritures. L'application d'IA lance l'auxiliaire fourni, parrotscribe-mcp, qui transmet les requêtes à l'application en cours d'exécution.
- Intégré : aucun paquet externe ni serveur distinct à gérer.
- Applications de bureau : Claude, Codex et Cursor se connectent par un socket Unix privé. L'auxiliaire vérifie qu'il communique avec l'application Parrot Scribe signée avant de lire les identifiants de cette application d'IA dans le trousseau de ce Mac.
- Autres hôtes : les hôtes en ligne de commande transmettent un jeton dans la variable d'environnement
PARROTSCRIBE_MCP_TOKEN. Ils se connectent à127.0.0.1, où l'auxiliaire vérifie le point de connexion avant d'envoyer le jeton. Les arguments de jeton comme--tokensont refusés. - Pro et accès par application : chaque requête est contrôlée selon le niveau d'accès actuel de l'application et votre licence Pro.
Même lorsque Parrot Scribe est fermé, l'initialisation et la découverte des outils fonctionnent. Un appel d'outil lance Parrot Scribe en arrière-plan, puis s'y connecte. Si l'application ne peut pas démarrer ou si la bibliothèque demande votre attention, ouvrez Parrot Scribe et traitez le message affiché.
Versions du protocole
Le serveur prend en charge la négociation d'initialisation 2024-11-05 et les métadonnées par requête de 2026-07-28 avec server/discover. Il utilise JSON-RPC délimité par des sauts de ligne sur stdio, avec une limite de 1 Mio par requête.
Connecter des applications d'IA
Suivez Connecter votre agent : ouvrez l'application d'IA de bureau, puis choisissez Connecter sur sa ligne dans Réglages > Apps IA. Pour un autre hôte local, ouvrez Avancé et créez un jeton pour cet hôte. Il n'est affiché qu'une fois.
Un agent hébergé dans le cloud ne peut pas atteindre ce serveur local en installant simplement un plugin.
Exemple de première utilisation
Il s'agit d'un exemple illustratif, pas de l'enregistrement d'une session testée. L'interface de votre hôte peut différer ; terminez d'abord sa configuration.
- Vérifiez la connexion. Demandez : "Vérifie l'état de Parrot Scribe. Ne démarre pas d'enregistrement." L'agent appelle
get_statuset rapporte l'état renvoyé. - Choisissez une session. Demandez : "Affiche au plus deux sessions récentes de Parrot Scribe." L'agent appelle
list_sessionsaveclimit: 2et vérifiehasMore. Il ne doit pas présenter ces deux lignes comme l'ensemble de votre bibliothèque. - Lisez avant de résumer. Demandez : "Résume cette session. Sépare les décisions, les questions non résolues et les suivis proposés." L'agent lit chaque page de
read_transcriptet signale les parties manquantes. - Gardez les actions explicites. Approuvez les suivis que vous souhaitez faire exécuter. Une demande prononcée dans l'enregistrement reste une proposition jusqu'à votre approbation directe dans le chat.
L'enregistrement et la transcription restent locaux. Le contenu partagé avec un agent reposant sur le cloud peut être envoyé à son fournisseur.
Modèle d'accès
Chaque application connectée dispose de l'un des deux niveaux d'accès, défini sur sa ligne dans Réglages > Apps IA :
- Simple : le niveau par défaut. L'application peut lire la bibliothèque, contrôler l'enregistrement, nommer les intervenants dans une session et attribuer un segment à un intervenant existant. Les outils destructifs sont refusés.
- Approuvé : autorise aussi les outils destructifs ci-dessous, sans confirmation distincte à chaque appel. L'attribution de cet accès vous demande une confirmation.
Utiliser l'accès simple retire le niveau Approuvé. Déconnecter ou Révoquer le jeton retire l'autorisation de cette application. Les actions en file d'attente et les requêtes en direct en attente revérifient l'accès. Une action déjà autorisée peut se terminer et un appel peut encore renvoyer du contenu qu'il a déjà lu.
Outils
| Outil | Accès | Description |
|---|---|---|
get_status | Simple | État de l'enregistrement, sessionId actif s'il existe, et message |
list_sessions | Simple | Sessions avec nombre total et indicateur de continuation |
read_transcript | Simple | Transcription d'une session, paginée |
search_sessions | Simple | Correspondances dans les identifiants de session, titres, commentaires, transcriptions et noms d'intervenants |
list_speakers | Simple | Identifiants, noms et indicateurs d'inscription des intervenants, sans empreintes vocales |
identify_speakers | Simple | Nomme les intervenants de l'audio système dans l'ordre de parole, sans enregistrer de profils vocaux |
reassign_segment_speaker | Simple | Attribue un segment d'audio système à un intervenant existant |
live_transcript | Simple | Lignes confirmées de l'enregistrement actuel |
start_recording | Simple | Démarre l'enregistrement |
stop_recording | Simple | Arrête l'enregistrement ; un sessionId différent le laisse continuer |
remove_speaker | Approuvé | Retire l'intervenant et son profil vocal ; le texte transcrit reste |
forget_speaker | Approuvé | Supprime l'intervenant et toutes les sessions qui lui sont attribuées |
delete_session | Approuvé | Supprime la session et son audio |
Les outils MCP n'enregistrent et ne mettent jamais à jour un profil vocal. L'enregistrement d'un profil se fait toujours dans Identifier les intervenants. Voir Reconnaissance des intervenants.
Requêtes sur la bibliothèque
list_sessions et search_sessions renvoient 50 résultats par défaut et au plus 1 000 par appel. Utilisez limit et offset ; tant que hasMore est vrai, augmentez offset du nombre de sessions renvoyées.
Lire de longues transcriptions
read_transcript exige sessionId et accepte les paramètres facultatifs sinceSegment et limit. Les pages contiennent 1 000 lignes par défaut et au plus 10 000 ; les lignes ayant le même identifiant de segment restent ensemble et peuvent dépasser cette taille. Conservez les champs qui entourent le contenu. Tant que hasMore est vrai, transmettez nextSinceSegment comme prochain sinceSegment. La lecture est complète seulement lorsque hasMore est faux.
L'arrêt d'un enregistrement rend la main avant la fin de la transcription finale et de l'enregistrement sur disque. Si une lecture ne trouve pas encore la session, vérifiez get_status et réessayez une fois la sauvegarde terminée.
Arguments d'abonnement en direct
live_transcript accepte les arguments facultatifs sessionId, sinceSequence, epoch et waitSeconds. Utilisez la session active de get_status, puis retransmettez les deux valeurs de curseur de chaque réponse. Une requête à jour peut attendre jusqu'à 20 secondes de nouvelles paroles ou un changement d'état. Ne lancez pas de requêtes plus souvent que ne l'indique minPollIntervalSeconds.
Chaque résultat contient state, epoch, sinceSequence, gap, sessionChanged, minPollIntervalSeconds, schema et text, ainsi que sessionId s'il est disponible. Les lignes en direct utilisent leur propre séquence, distincte des identifiants de segments enregistrés. Le flux conserve les 1 024 dernières phrases confirmées. gap indique une perte de lignes ou un changement d'époque ; utilisez read_transcript pour le contenu enregistré. Si sessionChanged est vrai, aucun texte n'est renvoyé ; choisissez la session renvoyée avant de continuer.
Les noms d'intervenants issus de l'analyse finale apparaissent dans la transcription enregistrée, pas dans le flux en direct.
Parrot Scribe ne transforme pas le texte transcrit en instructions. L'hôte doit distinguer les propositions prononcées des commandes directes de l'utilisateur et appliquer sa propre politique d'approbation des outils.
Cycle de vie des jetons
- Pour Claude, Codex et Cursor, utilisez Connecter dans Réglages > Apps IA. Parrot Scribe garde les identifiants de chaque application dans le trousseau de ce Mac ; la configuration générée ne contient que le nom de l'application.
- Pour un autre hôte, créez un jeton dans Avancé et transmettez-le comme
PARROTSCRIBE_MCP_TOKEN. - Parrot Scribe ne conserve que les empreintes des jetons dans sa liste chiffrée de clients.
- Les jetons de 1.0.x n'autorisent pas l'accès à 1.1.0. Reconnectez chaque application après la mise à niveau.
Exemples d'utilisation
- Suivi de réunion : une IA suit un appel en direct et apporte du contexte pertinent.
- Suivi des actions : une IA prépare des tâches à partir des engagements pris en réunion.
- Résumé de session : une IA rédige des résumés structurés après l'enregistrement.
- Assistant de recherche : une IA recherche des tendances dans les transcriptions passées.
Pour le parcours complet d'enregistrement, de révision et de recherche, consultez Méthode de prise de notes de réunion.
En savoir plus
- Documentation du Model Context Protocol, en anglais