Connecter votre agent

Version : Ce guide décrit la version stable 1.0.8 de Parrot Scribe. La bêta publique 1.1.0 propose des commandes différentes et certaines fonctions restent inachevées. Consultez Installation de la bêta et différences avant d'appliquer ces instructions à la bêta.

Nécessite Parrot Scribe Pro. L'accès au serveur MCP fait partie de Parrot Scribe Pro. Les licences existantes incluent déjà Pro.

Connectez ChatGPT, Claude ou Cursor depuis Parrot Scribe. Ces étapes nécessitent Parrot Scribe 1.0.2 ou version ultérieure. La reconnexion après le redémarrage d'une app IA nécessite Parrot Scribe 1.0.5. Parrot Scribe 1.0.1 utilise Réglages > MCP et un jeton client. Mettez l'app à jour avant de suivre les étapes ci-dessous.

Le catalogue Parrot Scribe, en anglais est destiné à Claude Code et à la CLI Codex. Il n'installe pas les trois lignes d'apps de bureau. Parrot Scribe crée ces connexions sur ce Mac.

Configuration commune

1. Installez Parrot Scribe dans /Applications/Parrot Scribe.app et laissez-le ouvert.
2. Ouvrez l'app IA de bureau à connecter et laissez-la ouverte.
3. Dans Parrot Scribe, ouvrez Réglages > Apps IA.
4. Activez Autoriser les apps IA. Cela nécessite Pro.
5. Choisissez Connecter sur la ligne de l'app souhaitée. Une ligne déjà configurée affiche d'abord Gérer…. Ouvrez ce menu puis choisissez Connecter.

Connecter approuve cette app de bureau sur ce Mac. La connexion reste utilisable, y compris après la fermeture puis la réouverture de ChatGPT, Claude ou Cursor. Lorsque l'app se reconnecte, sa ligne affiche Connecté pendant le travail et Configuré · Inactif entre les requêtes, sans passer par Gérer… > Connecter. Choisissez de nouveau Connecter uniquement après Déconnecter ou après 90 jours sans utilisation. L'app de bureau doit être ouverte lors de la première sélection de Connecter. Dans Parrot Scribe 1.0.4 et les versions antérieures, l'approbation prend fin lorsque l'app IA est fermée.

Chaque ligne conserve son propre état :

L'app stocke l'identifiant de connexion et lance son adaptateur signé avec un identifiant de profil. Ne copiez pas de jeton dans l'app de bureau, un profil de shell ou un message de conversation. Une session cloud ou mobile ne peut pas accéder à ce Mac en installant un plugin.

ChatGPT Desktop

Choisissez Connecter sur la ligne ChatGPT. Parrot Scribe ouvre un plugin local comprenant la connexion et la compétence d'écoute. Terminez l'installation dans ChatGPT, puis créez une nouvelle tâche locale et sélectionnez listening.

Une tâche web, mobile ou cloud n'obtient pas accès à ce Mac. Utilisez une tâche locale.

La version 1.0.6 corrigeait l'ancien état obsolète Configuré · Non connecté après un redémarrage de Parrot Scribe. Si vous mettez à niveau depuis 1.0.5 ou une version antérieure, fermez puis rouvrez une fois l'app IA connectée pour charger l'adaptateur mis à jour.

Claude Desktop

Choisissez Connecter sur la ligne Claude. Parrot Scribe installe une extension Claude locale pour la connexion. Claude peut afficher un avertissement rouge d'extension non examinée. Cet avertissement appartient à Claude. L'installation de l'extension ne le supprime pas.

Une fois l'extension installée, choisissez Ajouter la compétence d'écoute… sur la ligne Claude. Ce bouton ouvre Claude pour vous permettre de consulter et d'ajouter la compétence. Sur ce Mac, ouvrir directement le fichier de compétence peut le transmettre à ChatGPT à la place.

L'extension et la compétence d'écoute restent séparées. Ne remplacez pas l'extension par un plugin Claude combiné. Cela peut faire perdre la connexion dans Chat de Claude.

Si vous choisissez Déconnecter puis Connecter à nouveau, Claude peut encore avoir l'ancienne extension installée. Si Claude propose Uninstall au lieu d'installer, choisissez Uninstall, puis Install.

Cowork est un hôte distinct. Ces étapes pour les apps de bureau ne configurent pas Cowork.

Cursor

Choisissez Connecter sur la ligne Cursor. Parrot Scribe installe un plugin local dans ~/.cursor/plugins/local/parrot et ouvre le transfert de connexion vers Cursor. Il n'ajoute pas les anciennes commandes Cursor.

Terminez le transfert dans Cursor, puis créez une nouvelle conversation et demandez-lui d'utiliser la compétence d'écoute. La connexion seule ne charge pas cette compétence dans une conversation existante.

Vérifier la connexion

1. Vérifiez que la ligne affiche Connecté ou Configuré · Inactif après la reconnexion de l'app de bureau.
2. Demandez-lui d'appeler get_status sans démarrer d'enregistrement.
3. Demandez-lui d'appeler list_sessions avec limit: 2. Un tableau sessions vide est normal pour une bibliothèque vide. Vérifiez unavailableSessionCount avant de considérer que le résultat couvre toutes les données.
4. Sélectionnez une session que vous souhaitez partager avant de demander un récapitulatif. Consultez Écouter et récapituler.

Si la configuration indique que la connexion n'a pas pu être préparée, vérifiez d'abord que l'app IA de bureau choisie est déjà ouverte, puis réessayez Connecter. Si la ligne reste sur Configuré · Non connecté alors que l'app est ouverte, l'approbation a peut-être pris fin après 90 jours sans utilisation. Choisissez Gérer… > Connecter. Si Connecter vous demande continuellement d'ouvrir une app déjà ouverte, choisissez Déconnecter sur cette ligne puis Connecter. Si des outils manquent, terminez le transfert dans cette app puis créez une nouvelle tâche ou conversation. Gardez Parrot Scribe ouvert avec Pro et Autoriser les apps IA activé.

Autres hôtes locaux

Claude Code, la CLI Codex et les autres hôtes stdio locaux n'ont pas de ligne dans Apps IA. Utilisez un jeton par hôte depuis Réglages > Apps IA > Avancé. Copiez le jeton lorsqu'il est affiché. Il n'est affiché qu'une fois.

L'adaptateur lit PARROTSCRIBE_MCP_TOKEN depuis son environnement. Parrot Scribe refuse --token et --token=.... Gardez les jetons hors des arguments de commande, des fichiers de projet, des profils de shell et des messages de conversation.

L'adaptateur signé se trouve ici :

/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim

Si un hôte dispose déjà d'une connexion Parrot Scribe, ne gardez qu'une connexion activée. Ne laissez pas deux ensembles d'outils actifs.

Claude Code

Installez le catalogue et le plugin :

/plugin marketplace add 3jct-com/parrotscribe-plugins
/plugin install parrot@parrotscribe-plugins

Le plugin 0.4.0 comprend la connexion pour Claude Code. Saisissez le jeton de ce client dans la demande Parrot Scribe client token du plugin. Créez ce jeton dans Avancé. Claude Code le stocke dans son magasin d'identifiants et le transmet à l'adaptateur. Utilisez une version actuelle de Claude Code prenant en charge userConfig.

N'ajoutez pas une deuxième connexion manuelle après l'installation du plugin. Créez une nouvelle session et utilisez /parrot:listen ou /parrot:recap.

CLI Codex

Ajoutez le catalogue, installez le plugin et créez une nouvelle session :

codex plugin marketplace add 3jct-com/parrotscribe-plugins

Fournissez un jeton distinct dans l'environnement de l'hôte Codex. Le plugin transmet PARROTSCRIBE_MCP_TOKEN. Il ne s'agit pas de la ligne ChatGPT décrite ci-dessus. Une connexion manuelle utilise :

[mcp_servers.parrotscribe]
command = "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
env_vars = ["PARROTSCRIBE_MCP_TOKEN"]

Gardez une seule connexion activée. Ne réutilisez pas ce jeton pour un autre hôte.

Hôtes nécessitant une configuration des variables d'environnement

Utilisez le même adaptateur et un jeton distinct. Si l'hôte ne transmet pas PARROTSCRIBE_MCP_TOKEN à l'adaptateur, utilisez le lanceur Trousseau ci-dessous.

Grok Build, dans ~/.grok/config.toml :

[mcp_servers.parrotscribe]
command = "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
env = { PARROTSCRIBE_MCP_TOKEN = "${PARROTSCRIBE_MCP_TOKEN}" }

Gemini CLI, dans ~/.gemini/settings.json :

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "env": {
        "PARROTSCRIBE_MCP_TOKEN": "$PARROTSCRIBE_MCP_TOKEN"
      }
    }
  }
}

OpenCode, sous mcp dans ~/.config/opencode/opencode.json :

{
  "mcp": {
    "parrotscribe": {
      "type": "local",
      "command": [
        "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
      ],
      "environment": {
        "PARROTSCRIBE_MCP_TOKEN": "{env:PARROTSCRIBE_MCP_TOKEN}"
      }
    }
  }
}

Ces hôtes disposent des outils MCP. Ils ne disposent pas de la compétence d'écoute de bureau ni de /parrot:listen, sauf si vous chargez le contrat d'écoute, en anglais comme instructions.

Lanceur Trousseau pour les autres hôtes

Utilisez cette méthode lorsqu'un hôte ne peut pas injecter le jeton dans l'environnement de l'adaptateur. Créez un élément de mot de passe générique dans Trousseaux d'accès pour cet hôte. Enregistrez le jeton comme mot de passe. Ne réutilisez pas le jeton d'un autre hôte.

Enregistrez ce script dans un chemin absolu, par exemple /Users/you/.local/bin/parrotscribe-mcp-keychain. Remplacez /Users/you par le chemin de votre compte. Le script ne contient aucun jeton :

#!/bin/zsh
set -eu
: "${PARROTSCRIBE_MCP_KEYCHAIN_ITEM:?Set PARROTSCRIBE_MCP_KEYCHAIN_ITEM}"
PARROTSCRIBE_MCP_TOKEN=$(/usr/bin/security find-generic-password -w -s "$PARROTSCRIBE_MCP_KEYCHAIN_ITEM")
export PARROTSCRIBE_MCP_TOKEN
exec "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim" "$@"

Exécutez chmod 700 /Users/you/.local/bin/parrotscribe-mcp-keychain. Faites pointer la commande de l'hôte vers ce script et transmettez uniquement le nom de l'élément du Trousseau :

{
  "command": "/Users/you/.local/bin/parrotscribe-mcp-keychain",
  "env": {
    "PARROTSCRIBE_MCP_KEYCHAIN_ITEM": "Parrot Scribe MCP Host Name"
  }
}

N'utilisez pas ce lanceur pour les lignes ChatGPT, Claude ou Cursor. Ces lignes gèrent l'identifiant d'accès.

Maintenance

• Pour déconnecter ChatGPT, Claude ou Cursor, choisissez Déconnecter sur sa ligne. Les autres apps restent configurées.
• Pour renouveler le jeton d'un autre hôte, révoquez-le dans Avancé, créez-en un nouveau, mettez à jour sa source secrète et redémarrez l'hôte.
• Pour une ancienne configuration --token, retirez le jeton de la commande ou de la configuration. Utilisez Avancé ou le lanceur Trousseau puis redémarrez l'hôte. Révoquez tout jeton exposé dans une commande, un journal ou un fichier copié.
• Redémarrez l'hôte après une modification de jeton ou de configuration.

Les arguments des outils et les contrôles d'accès sont décrits dans Serveur MCP. La méthode est expliquée dans Écouter et récapituler.

Bêta 1.1.0

La section Réglages > Apps IA de la bêta répertorie Codex, Claude et Cursor. Ouvrez d'abord l'app IA, sélectionnez Connecter sur sa ligne et terminez le transfert dans cette app. Utilisez les commandes Gérer… de la ligne pour reconnecter cette app, modifier son accès ou la déconnecter. Chaque ligne dispose de son propre nouvel identifiant d'accès. Les approbations existantes de 1.0.x n'autorisent pas la bêta.

Choisissez Simple pour la lecture, les commandes d'enregistrement et la modification des noms d'intervenants. Simple ne peut pas supprimer des sessions ni retirer ou oublier des intervenants. Approuvé autorise aussi ces outils destructifs sans nouvelle demande. Son attribution nécessite une confirmation. Les demandes d'autorisation propres à l'hôte IA continuent de s'appliquer. Déconnecter la ligne ou révoquer un jeton manuel retire l'accès de ce client.

Pour un hôte en ligne de commande, ouvrez Avancé, saisissez un nom de client et choisissez Créer un jeton. Utilisez la configuration générée avec un jeton distinct pour cet hôte. Le jeton n'est affiché qu'une fois et doit figurer dans PARROTSCRIBE_MCP_TOKEN, pas dans les arguments de commande. Gardez une seule connexion activée par hôte. Les configurations de catalogue existantes utilisant le chemin de compatibilité parrotscribe-mcp-shim peuvent utiliser un nouveau jeton bêta. Le paquet signé fournit aussi parrotscribe-mcp.

Cursor nécessite actuellement Reload dans ses réglages MCP après le redémarrage de Parrot Scribe. Une ligne configurée ne prouve pas à elle seule qu'un hôte IA s'est reconnecté. Demandez-lui d'appeler get_status et d'effectuer une lecture voulue. La vérification de la reconnexion et de la révocation avec chaque hôte réel reste distincte de l'installation de sa configuration.

L'adaptateur de bureau géré de la bêta utilise un socket Unix privé. Il vérifie l'utilisateur et l'identité de signature de code de l'app connectée avant de lire l'identifiant géré dans le Trousseau. Les connexions manuelles avec jeton d'environnement utilisent un transport distinct sur 127.0.0.1, avec vérification d'un secret de point de terminaison avant l'envoi du jeton. La capture et le stockage restent locaux, mais un hôte IA utilisant le cloud peut envoyer le contenu des transcriptions récupérées à son fournisseur. Consultez Limites du stockage de la bêta.