Conecta tu agente

Versión: Esta guía describe Parrot Scribe estable 1.0.8. La beta pública 1.1.0 tiene controles diferentes y algunas funciones sin terminar. Consulta Instalación y diferencias de la beta antes de aplicar estos pasos a la beta.

Requiere Parrot Scribe Pro. El acceso al servidor MCP forma parte de Parrot Scribe Pro. Las licencias existentes ya incluyen Pro.

Conecta ChatGPT, Claude o Cursor desde Parrot Scribe. Estos pasos requieren Parrot Scribe 1.0.2 o posterior. Mantener la conexión después de reiniciar una app de IA requiere Parrot Scribe 1.0.5. Parrot Scribe 1.0.1 usa Ajustes > MCP y un token de cliente. Actualiza antes de seguir los pasos de escritorio que aparecen a continuación.

El catálogo de Parrot Scribe es para Claude Code y la CLI de Codex. No instala las tres filas de escritorio. Parrot Scribe crea esas conexiones en este Mac.

Configuración común

1. Instala Parrot Scribe en /Applications/Parrot Scribe.app y mantenlo en ejecución.
2. Abre la app de IA de escritorio que quieras conectar y déjala en ejecución.
3. En Parrot Scribe, abre Ajustes > Apps de IA.
4. Activa Permitir apps de IA. Requiere Pro.
5. Elige Conectar en la fila de la app que quieras. Si una fila ya está configurada, primero muestra Gestionar…. Ábrela y elige Conectar.

Conectar autoriza esa app de escritorio en este Mac. La conexión se mantiene mientras la uses, incluso después de cerrar y volver a abrir ChatGPT, Claude o Cursor. Cuando se vuelve a conectar, su fila muestra Conectado mientras trabaja y Configurado · Inactivo entre solicitudes, sin necesidad de Gestionar… > Conectar. Vuelve a elegir Conectar solo después de Desconectar o tras 90 días sin uso. La app de escritorio tiene que estar en ejecución la primera vez que elijas Conectar. En Parrot Scribe 1.0.4 y anteriores, la autorización termina cuando se cierra la app de IA.

Cada fila mantiene su propio estado:

La app guarda la credencial de conexión e inicia su adaptador firmado con un identificador de perfil. No copies un token en la app de escritorio, en un perfil de shell ni en un mensaje de chat. Una sesión en la nube o en el móvil no puede acceder a este Mac por instalar un plugin.

ChatGPT Desktop

Elige Conectar en la fila de ChatGPT. Parrot Scribe abre un plugin local que incluye la conexión y la habilidad de escucha. Completa la instalación en ChatGPT, inicia una tarea local nueva y selecciona listening.

Una tarea web, móvil o en la nube no obtiene acceso a este Mac. Usa una tarea local.

La versión 1.0.6 corrigió el estado desactualizado Configurado · Sin conexión que aparecía después de reiniciar Parrot Scribe. Si actualizas desde 1.0.5 o una versión anterior, cierra y vuelve a abrir una vez la app de IA conectada para cargar el ayudante actualizado.

Claude Desktop

Elige Conectar en la fila de Claude. Parrot Scribe instala una extensión local de Claude para la conexión. Claude puede mostrar un aviso rojo de extensión no revisada. Ese aviso pertenece a Claude. Instalar la extensión no lo elimina.

Una vez instalada la extensión, elige Añadir habilidad de escucha… en la fila de Claude. Ese botón abre Claude para que puedas revisar y añadir la habilidad. En este Mac, abrir directamente el archivo de la habilidad puede entregárselo a ChatGPT.

La extensión y la habilidad de escucha se mantienen separadas. No sustituyas la extensión por un plugin combinado de Claude. Podrías perder la conexión de Chat de Claude.

Si eliges Desconectar y después Conectar de nuevo, Claude puede conservar la extensión anterior instalada. Si Claude ofrece Uninstall (Desinstalar) en lugar de instalar, elige Uninstall y después Install (Instalar).

Cowork es un anfitrión distinto. Estos pasos de escritorio no configuran Cowork.

Cursor

Elige Conectar en la fila de Cursor. Parrot Scribe instala un plugin local en ~/.cursor/plugins/local/parrot y abre el traspaso de conexión a Cursor. No añade los comandos antiguos de Cursor.

Completa el traspaso en Cursor, inicia un chat nuevo y pídele que use la habilidad de escucha. Conectar por sí solo no carga esa habilidad en un chat existente.

Comprueba la conexión

1. Confirma que la fila muestre Conectado o Configurado · Inactivo después de que la app de escritorio se vuelva a conectar.
2. Pídele que llame a get_status sin iniciar una grabación.
3. Pídele que llame a list_sessions con limit: 2. Un array sessions vacío es válido para una biblioteca vacía. Comprueba unavailableSessionCount antes de tratar el resultado como una cobertura completa.
4. Selecciona una sesión que quieras compartir antes de pedir un resumen. Consulta Escuchar y resumir.

Si la configuración indica que no ha podido preparar la conexión, comprueba primero que la app de IA de escritorio seleccionada ya esté en ejecución y vuelve a intentar Conectar. Si la fila permanece en Configurado · Sin conexión mientras esa app está abierta, puede que la autorización haya terminado tras 90 días sin uso. Elige Gestionar… > Conectar. Si Conectar sigue pidiéndote que abras una app que ya está abierta, elige Desconectar en esa fila y después Conectar. Si faltan herramientas, completa el traspaso en esa app e inicia una tarea o chat nuevos. Mantén Parrot Scribe en ejecución con Pro y Permitir apps de IA activado.

Otros anfitriones locales

Claude Code, la CLI de Codex y otros anfitriones stdio locales no tienen filas en Apps de IA. Usa un token por anfitrión desde Ajustes > Apps de IA > Avanzado. Copia el token cuando se muestre. Solo se muestra una vez.

El adaptador lee PARROTSCRIBE_MCP_TOKEN de su entorno. Parrot Scribe rechaza --token y --token=.... Mantén los tokens fuera de argumentos de comandos, archivos de proyecto, perfiles de shell y mensajes de chat.

El adaptador firmado está en:

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

Si un anfitrión ya tiene una conexión con Parrot Scribe, conserva una sola conexión activada. No dejes dos conjuntos de herramientas activos.

Claude Code

Instala el catálogo y el plugin:

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

El plugin 0.4.0 incluye la conexión para Claude Code. Introduce el token de este cliente en la solicitud Parrot Scribe client token del plugin. Crea ese token en Avanzado. Claude Code lo guarda en su almacén de credenciales y se lo proporciona al adaptador. Usa una versión actual de Claude Code compatible con userConfig.

No añadas una segunda conexión manual después de instalar el plugin. Inicia una sesión nueva y usa /parrot:listen o /parrot:recap.

CLI de Codex

Añade el catálogo, instala el plugin e inicia una sesión nueva:

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

Proporciona un token independiente en el entorno del anfitrión Codex. El plugin reenvía PARROTSCRIBE_MCP_TOKEN. Esto no es la fila de ChatGPT anterior. Una conexión manual usa:

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

Conserva una sola conexión activada. No reutilices este token en otro anfitrión.

Anfitriones que necesitan una asignación de entorno

Usa el mismo adaptador y un token independiente. Si el anfitrión no pasa PARROTSCRIBE_MCP_TOKEN al adaptador, usa el lanzador de llavero que aparece más abajo.

Grok Build, en ~/.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, en ~/.gemini/settings.json:

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

OpenCode, dentro de mcp en ~/.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}"
      }
    }
  }
}

Estos anfitriones obtienen herramientas MCP. No obtienen la habilidad de escucha de escritorio ni /parrot:listen, salvo que cargues el contrato de escucha (en inglés) como instrucciones.

Lanzador de llavero para otros anfitriones

Úsalo cuando un anfitrión no pueda introducir el token en el entorno del adaptador. Crea un elemento de contraseña genérica en Acceso a Llaveros para ese anfitrión. Guarda el token como contraseña. No reutilices el token de otro anfitrión.

Guarda este script en una ruta absoluta, como /Users/you/.local/bin/parrotscribe-mcp-keychain. Sustituye /Users/you por la ruta de tu cuenta. El script no contiene ningún token:

#!/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" "$@"

Ejecuta chmod 700 /Users/you/.local/bin/parrotscribe-mcp-keychain. Configura el comando del anfitrión para que apunte a ese script y pasa solo el nombre del elemento del llavero:

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

No uses este lanzador para las filas de ChatGPT, Claude o Cursor. Esas filas gestionan la credencial.

Mantenimiento

• Para desconectar ChatGPT, Claude o Cursor, elige Desconectar en esa fila. Las demás apps siguen configuradas.
• Para rotar un token de otro anfitrión, revócalo en Avanzado, emite uno nuevo, actualiza el origen del secreto y reinicia el anfitrión.
• Si tienes una configuración antigua con --token, elimina el token del comando o de la configuración. Usa Avanzado o el lanzador de llavero y reinicia el anfitrión. Revoca cualquier token que haya quedado expuesto en un comando, registro o archivo copiado.
• Reinicia el anfitrión después de cambiar un token o la configuración.

Los argumentos de herramientas y los controles de acceso se documentan en Servidor MCP. El flujo de trabajo se explica en Escuchar y resumir.

Beta 1.1.0

Ajustes > Apps de IA en la beta muestra Codex, Claude y Cursor. Abre primero la app de IA, selecciona Conectar en su fila y completa el traspaso allí. Usa los controles Gestionar… de la fila para volver a conectar, cambiar el acceso o desconectar esa app. Cada fila tiene su propia credencial nueva; las autorizaciones de 1.0.x no autorizan la beta.

Elige Sencillo para lectura, controles de grabación y cambios de nombres de hablantes. Sencillo no puede eliminar sesiones ni eliminar u olvidar hablantes. De confianza permite además esas herramientas destructivas sin otra solicitud de confirmación; concederlo requiere confirmación. Los avisos de permisos del propio anfitrión de IA siguen aplicándose. Desconectar la fila o revocar un token manual elimina el acceso de ese cliente.

Para un anfitrión de línea de comandos, abre Avanzado, introduce un nombre de cliente y elige Crear token. Usa la configuración generada con un token independiente para ese anfitrión. El token se muestra una sola vez y debe ir en PARROTSCRIBE_MCP_TOKEN, no en argumentos de comandos. Conserva una sola conexión activada por anfitrión. Las configuraciones existentes del catálogo que usan la ruta de compatibilidad parrotscribe-mcp-shim pueden usar un token nuevo de la beta; el paquete firmado también expone parrotscribe-mcp.

Actualmente, Cursor necesita Reload en sus ajustes de MCP después de reiniciar Parrot Scribe. Una fila configurada no demuestra por sí sola que el anfitrión de IA se haya vuelto a conectar: pídele que llame a get_status y haga una lectura prevista. La comprobación de reconexión y revocación con cada anfitrión real sigue siendo independiente de instalar su configuración.

El ayudante de escritorio gestionado de la beta usa un socket Unix privado. Verifica el usuario y la identidad de firma de código de la app conectada antes de leer la credencial gestionada del llavero. Las conexiones manuales con tokens de entorno usan un transporte separado en 127.0.0.1 con un desafío de secreto del punto de conexión antes de enviar el token. La captura y el almacenamiento siguen siendo locales, pero un anfitrión de IA basado en la nube puede enviar a su proveedor el contenido de transcripciones que recupere. Consulta Límites de almacenamiento de la beta.