Usa tus grabaciones de Vocatim en las apps de IA de tu Mac

Primero, en Vocatim

En tu Mac, abre Ajustes → Datos y dispositivos → Apps de IA en este Mac y activa la opción. Lee la pantalla que explica lo que puede ver la app de IA y haz clic en Activar. Después, sigue los pasos para tu app de IA.

Claude Desktop

1. Haz clic en Instalar en Claude Desktop y guarda Vocatim.mcpb donde quieras, por ejemplo en la carpeta Descargas. En cuanto se guarda el archivo, Vocatim copia la clave de Vocatim.
2. Abre Vocatim.mcpb. Claude Desktop muestra la extensión de Vocatim y te pregunta si quieres instalarla.
3. Cuando Claude Desktop te pida la clave, pégala en el campo Clave de Vocatim. Deja el campo Programa vocatim-mcp como está.
4. En un chat nuevo, pregunta, por ejemplo, «¿Qué decidimos en mi última grabación de Vocatim?». Puede que Claude te pida que permitas la herramienta de Vocatim.

¿Prefieres editar tú la configuración? Haz clic en Copiar la configuración para Claude Desktop. En Claude Desktop, abre el menú Claude de la barra de menús de macOS (no los ajustes dentro de la ventana de Claude) y elige Settings… → Developer → Edit Config. Si el archivo todavía no tiene "mcpServers", reemplaza su contenido por el ejemplo completo de abajo. Si ya incluye servidores, pega solo la entrada "vocatim" dentro de "mcpServers", con una coma entre ella y la entrada anterior. Guarda el archivo, cierra Claude Desktop por completo y vuelve a abrirlo.

{
  "mcpServers": {
    "vocatim": { … paste from Vocatim … }
  }
}

ChatGPT y Codex

1. Haz clic en Copiar la configuración para ChatGPT y Codex.
2. Abre el archivo ~/.codex/config.toml en un editor de texto, o créalo si todavía no existe. ~/.codex es una carpeta oculta dentro de tu carpeta de inicio: en el Finder, elige Ir → Ir a la carpeta… y escribe ~/.codex.
3. Si el archivo no tiene una sección [mcp_servers.vocatim], pega la configuración en una línea nueva al final. Si ya tiene una, de una configuración anterior, reemplaza toda esa sección por la nueva. El archivo no debe contener la sección dos veces.
4. Guarda el archivo y reinicia ChatGPT o Codex.
5. En un chat nuevo, pregunta, por ejemplo, «¿Qué decidimos en mi última grabación de Vocatim?». En ChatGPT, usa Vocatim en una conversación de Codex, no en un chat normal.

[mcp_servers.vocatim]
command = "/Applications/Vocatim.app/Contents/MacOS/vocatim-mcp"
args = ["--port", "…", "--token", "…"]

codex mcp list muestra la clave de Vocatim en su columna Args. La clave solo permite que las apps de este Mac lean Vocatim, y solo mientras Vocatim está abierto. No compartas ese resultado; si ya lo has hecho, usa «Restablecer la clave» en Vocatim.

VS Code, Cursor y LM Studio

1. Haz clic en Instalar en VS Code, Añadir a Cursor o Añadir a LM Studio. Vocatim abre esa app con la configuración de Vocatim.
2. En la app, confirma que quieres añadir Vocatim.
3. Con VS Code, Vocatim copia la clave de Vocatim: cuando VS Code pida la Clave de Vocatim, pégala. Cursor y LM Studio reciben la clave junto con la configuración y la guardan en sus propios ajustes.
4. En el chat de IA de la app, pregunta, por ejemplo, «¿Qué decidimos en mi última grabación de Vocatim?».

Otras apps: Cursor, LM Studio, JetBrains AI Assistant y Junie

1. Haz clic en Copiar la configuración para otras apps.
2. Abre los ajustes de MCP de la app: en Cursor, el archivo ~/.cursor/mcp.json; en LM Studio, su mcp.json; en JetBrains AI Assistant, Settings → Tools → AI Assistant → MCP y Add; en Junie, el archivo ~/.junie/mcp/mcp.json.
3. Si todavía no hay "mcpServers", pega la configuración completa. Si ya hay servidores, añade solo la entrada "vocatim" dentro de "mcpServers", o úsala para reemplazar la entrada "vocatim" antigua. La entrada no debe aparecer dos veces.
4. Guarda y luego reinicia la app.

Zed

1. Haz clic en Copiar la configuración para Zed.
2. En Zed, ejecuta zed: open settings file.
3. Coloca la parte "context_servers" dentro de las llaves exteriores de ese archivo. Si "context_servers" ya está ahí, añade dentro solo la entrada "vocatim", o úsala para reemplazar la entrada "vocatim" antigua. La entrada no debe aparecer dos veces.
4. Guarda el archivo y luego reinicia Zed.

Vocatim en Terminal (línea de comandos)

También puedes leer tus grabaciones en Terminal en este Mac, con las mismas cuatro herramientas de solo lectura que reciben las apps de IA: lista, búsqueda, transcripción y resumen. La línea de comandos usa el mismo interruptor y la misma clave de Vocatim que tus apps de IA, y solo funciona mientras Vocatim está abierto con el interruptor activado.

1. Copia este comando y pégalo en una ventana de Terminal, pero no pulses Retorno todavía:

   printf '\n%s\n' "$(pbpaste | grep -m 1 '^alias vocatim=')" >> ~/.zshrc

2. En Vocatim, haz clic en Copiar el comando CLI. Vocatim copia una línea: un alias llamado vocatim para zsh, el shell predeterminado de macOS.
3. Vuelve a Terminal y pulsa Retorno. El comando añade la línea copiada al final de ~/.zshrc, el archivo que zsh lee cada vez que abres una ventana de Terminal. Solo añade una línea que empiece por alias vocatim=, así que nada más del portapapeles entra en el archivo.
4. Abre una ventana nueva de Terminal y escribe vocatim list. El alias funciona en las ventanas que abras después del paso 3.

Los cuatro comandos:

• vocatim list muestra tus 20 grabaciones más recientes, una por línea: identificador, fecha y hora, duración y título. vocatim list --limit 50 muestra hasta 50.
• vocatim search presupuesto encuentra las grabaciones cuyo título, transcripción, resumen, notas o alguna traducción contienen «presupuesto». Pon entre comillas una búsqueda con espacios: vocatim search "revisión semanal". Muestra hasta 10 resultados, o hasta 20 con --limit 20.
• vocatim transcript <id> muestra la transcripción completa de una grabación. El identificador está en la primera columna de vocatim list y de vocatim search.
• vocatim summary <id> muestra su resumen.

Añade --json a cualquier comando para obtener JSON para tus propios scripts. vocatim help muestra la lista de comandos.

Tu clave. La línea vocatim de ~/.zshrc contiene tu clave de Vocatim. Si pegas esa línea directamente en Terminal, la clave también queda en el historial de Terminal. La clave solo permite que las apps de este Mac lean Vocatim, y solo mientras Vocatim está abierto. No compartas la línea ni el archivo; si ya lo has hecho, usa «Restablecer la clave» en Vocatim.

Después de «Restablecer la clave», o cuando Vocatim muestre «La configuración ha cambiado: vuelve a configurar tus apps de IA.», la línea antigua deja de funcionar. Repite los pasos 1 a 4. La que cuenta es la línea vocatim más reciente de ~/.zshrc; puedes borrar las anteriores.

Después de un comando, Apps de IA en este Mac en los Ajustes de Vocatim muestra vocatim-cli, igual que muestra el nombre de una app de IA.

La línea de comandos solo se comunica con Vocatim en este Mac y muestra el resultado en tu ventana de Terminal. Si pasas ese resultado a otro sitio, por ejemplo a un servicio de IA en línea, acaba allí.

Para quitarla, borra todas las líneas vocatim de ~/.zshrc; después de repetir los pasos 1 a 4 puede haber más de una. Desactivar el interruptor en Vocatim, o «Restablecer la clave», también la detiene.

Si no funciona: los mensajes de la línea de comandos de Vocatim empiezan por vocatim-mcp:.

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings. (Vocatim no está abierto en este Mac, o el acceso de las apps de IA está desactivado en los Ajustes de Vocatim): abre Vocatim y comprueba el interruptor. Después de «Restablecer la clave» o «La configuración ha cambiado», repite los pasos 1 a 4. La línea de arriba, si la hay, indica el motivo técnico, por ejemplo vocatim-mcp: connect: Connection refused.
• zsh: command not found: vocatim: abre una ventana nueva de Terminal. Si sigue apareciendo, comprueba que ~/.zshrc tenga una línea que empiece por alias vocatim=; si no la tiene, repite los pasos 1 a 4. Comprueba también que echo $SHELL muestre /bin/zsh.
• zsh: no such file or directory con una ruta a vocatim-mcp: la línea apunta a un lugar donde Vocatim ya no está, por ejemplo después de mover la app. Repite los pasos 1 a 4.
• vocatim-mcp: Too many requests, try again in a moment. (demasiadas solicitudes, inténtalo de nuevo en un momento): espera un momento y vuelve a ejecutar el comando.
• vocatim sin comando, por ejemplo vocatim o vocatim --json, se queda esperando y no muestra nada: pulsa Control-C y luego escribe un comando como vocatim list.

Para scripts: los datos van a la salida estándar, completos y solo si el comando funciona; los mensajes van a la salida de error estándar. Con --json, cada respuesta de Vocatim es una línea de JSON, así que transcript muestra una línea por cada página de una transcripción larga: lee el resultado línea a línea, no como un único documento JSON. Códigos de salida: 0 hecho, 1 otro error, 2 comando u opción incorrectos, 3 Vocatim no está abierto o el acceso está desactivado, 4 demasiadas solicitudes.

Qué sale de tu Mac

El acceso de las apps de IA a tus grabaciones está desactivado de forma predeterminada. Lo activas tú en los Ajustes de Vocatim, solo si decides compartir tus transcripciones con apps de IA en este Mac.

Vocatim no envía nada por sí mismo. Si la app de IA usa un modelo en línea, como suelen hacer Claude Desktop, ChatGPT y Codex, lo que lee de Vocatim se envía a esa empresa (Anthropic u OpenAI) con la cuenta que tienes en ella, como si lo hubieras pegado en el chat.

Para detenerlo

Desactiva el interruptor en Vocatim. Restablecer la clave inutiliza todas las claves que hayas copiado y todas las configuraciones que hayas pegado. Para volver a conectar, configura de nuevo la app de IA. Para la extensión de Claude Desktop, vuelve a hacer clic en Instalar en Claude Desktop en Vocatim, guarda el archivo y ábrelo: Vocatim copia la clave nueva en cuanto se guarda el archivo. Pégala cuando Claude Desktop te la pida, o en el campo Clave de Vocatim de la extensión de Vocatim en Claude Desktop. Para Cursor y LM Studio, vuelve a hacer clic en Añadir a Cursor o Añadir a LM Studio. Si has pegado una configuración, cópiala de nuevo y pégala sobre la entrada o la sección antigua. Después cierra la app de IA por completo (no basta con cerrar su ventana) y vuelve a abrirla: hasta entonces sigue usando la clave antigua. También puedes quitar Vocatim de la app de IA: la extensión de Vocatim en Claude Desktop, la entrada "vocatim" en su configuración, en los ajustes de MCP de otra app o en el archivo de ajustes de Zed, o la sección [mcp_servers.vocatim] en ~/.codex/config.toml.

Si no funciona

• «Vocatim no está abierto en este Mac, o el acceso de las apps de IA está desactivado en los Ajustes de Vocatim.»: abre Vocatim y comprueba el interruptor. Después de «Restablecer la clave», configura de nuevo la app de IA y luego ciérrala por completo (no basta con cerrar su ventana) y vuelve a abrirla.
• Vocatim muestra «La configuración ha cambiado: vuelve a configurar tus apps de IA.»: vuelve a configurar cada app de IA como se explica arriba, sobre la entrada o la sección antigua, y reiníciala.
• Vocatim muestra «La app no se abrió. ¿Está instalada en este Mac?»: instala esa app en este Mac. Para Cursor y LM Studio también puedes usar Copiar la configuración para otras apps.
• ChatGPT o Codex deja de funcionar, o informa de un error en config.toml, después de que hayas pegado la configuración por segunda vez: el archivo tiene dos secciones [mcp_servers.vocatim]. Conserva solo la más reciente.
• Codex dice que no hay ninguna herramienta de Vocatim: empieza una conversación nueva en un proyecto cuya carpeta esté en este Mac (un proyecto sincronizado desde otro ordenador puede no tener carpeta aquí).
• Has abierto la app de IA antes que Vocatim: reinicia la app de IA con Vocatim abierto.
• Falta una grabación: las grabaciones de la papelera y las grabaciones de ejemplo no se muestran, y una grabación nueva solo aparece cuando su transcripción termina o se detiene. Una grabación que no está transcrita por completo aparece en la lista, pero su transcripción y su resumen no están disponibles hasta que lo esté.