Use suas gravações do Vocatim em apps de IA no seu Mac

Primeiro, no Vocatim

No seu Mac, abra Ajustes → Dados e dispositivos → Apps de IA neste Mac e ative a opção. Leia a tela que explica o que o app de IA pode ver e clique em Ativar. Depois, siga os passos para o seu app de IA.

Claude Desktop

1. Clique em Instalar no Claude Desktop e salve Vocatim.mcpb onde quiser, por exemplo na pasta Downloads. Assim que o arquivo é salvo, o Vocatim copia a chave do Vocatim.
2. Abra Vocatim.mcpb. O Claude Desktop mostra a extensão do Vocatim e pergunta se você quer instalá-la.
3. Quando o Claude Desktop pedir a chave, cole-a no campo Chave do Vocatim. Deixe o campo Programa vocatim-mcp como está.
4. Em um novo chat, pergunte, por exemplo, “O que decidimos na minha última gravação no Vocatim?”. O Claude pode pedir que você permita o uso da ferramenta do Vocatim.

Prefere editar a configuração por conta própria? Clique em Copiar a configuração para o Claude Desktop. No Claude Desktop, abra o menu Claude na barra de menus do macOS (não os ajustes dentro da janela do Claude) e escolha Settings… → Developer → Edit Config. Se o arquivo ainda não tiver "mcpServers", substitua o conteúdo dele pelo exemplo completo abaixo. Se ele já listar servidores, cole só a entrada "vocatim" dentro de "mcpServers", com uma vírgula entre ela e a entrada anterior. Salve o arquivo, feche o Claude Desktop por completo e abra-o de novo.

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

ChatGPT e Codex

1. Clique em Copiar a configuração para o ChatGPT e o Codex.
2. Abra o arquivo ~/.codex/config.toml em um editor de texto ou crie-o, se ele ainda não existir. ~/.codex é uma pasta oculta dentro da sua pasta de início: no Finder, escolha Ir → Ir para a Pasta… e digite ~/.codex.
3. Se o arquivo não tiver uma seção [mcp_servers.vocatim], cole a configuração em uma nova linha no final. Se ele já tiver uma, de uma configuração anterior, substitua toda essa seção pela nova. O arquivo não pode conter a seção duas vezes.
4. Salve o arquivo e reinicie o ChatGPT ou o Codex.
5. Em um novo chat, pergunte, por exemplo, “O que decidimos na minha última gravação no Vocatim?”. No ChatGPT, use o Vocatim em uma conversa do Codex, não em um chat comum.

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

codex mcp list mostra a chave do Vocatim na coluna Args. A chave só permite que apps deste Mac leiam o Vocatim, e só enquanto o Vocatim estiver aberto. Não compartilhe essa saída; se já compartilhou, use “Redefinir a chave” no Vocatim.

VS Code, Cursor e LM Studio

1. Clique em Instalar no VS Code, Adicionar ao Cursor ou Adicionar ao LM Studio. O Vocatim abre esse app com a configuração do Vocatim.
2. No app, confirme que você quer adicionar o Vocatim.
3. No caso do VS Code, o Vocatim copia a chave do Vocatim: quando o VS Code pedir a Chave do Vocatim, cole-a. O Cursor e o LM Studio recebem a chave junto com a configuração e a salvam nos próprios ajustes.
4. No chat de IA do app, pergunte, por exemplo, “O que decidimos na minha última gravação no Vocatim?”.

Outros apps: Cursor, LM Studio, JetBrains AI Assistant e Junie

1. Clique em Copiar a configuração para outros apps.
2. Abra os ajustes de MCP do app: no Cursor, o arquivo ~/.cursor/mcp.json; no LM Studio, o mcp.json dele; no JetBrains AI Assistant, Settings → Tools → AI Assistant → MCP e Add; no Junie, o arquivo ~/.junie/mcp/mcp.json.
3. Se ainda não houver "mcpServers" ali, cole a configuração inteira. Se já houver servidores listados, adicione só a entrada "vocatim" dentro de "mcpServers" ou use-a para substituir a entrada "vocatim" antiga. A entrada não pode aparecer duas vezes.
4. Salve e depois reinicie o app.

Zed

1. Clique em Copiar a configuração para o Zed.
2. No Zed, execute zed: open settings file.
3. Coloque a parte "context_servers" dentro das chaves externas desse arquivo. Se "context_servers" já estiver lá, adicione dentro dele só a entrada "vocatim" ou use-a para substituir a entrada "vocatim" antiga. A entrada não pode aparecer duas vezes.
4. Salve o arquivo e depois reinicie o Zed.

Vocatim no Terminal (linha de comando)

Você também pode ler suas gravações no Terminal deste Mac, com as mesmas quatro ferramentas somente leitura que os apps de IA recebem: lista, busca, transcrição e resumo. A linha de comando usa a mesma opção e a mesma chave do Vocatim que os seus apps de IA, e só funciona enquanto o Vocatim estiver aberto com a opção ativada.

1. Copie este comando e cole-o em uma janela do Terminal, mas ainda não pressione Return:

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

2. No Vocatim, clique em Copiar o comando CLI. O Vocatim copia uma linha: um alias chamado vocatim para o zsh, o shell padrão do macOS.
3. Volte ao Terminal e pressione Return. O comando adiciona a linha copiada ao fim de ~/.zshrc, o arquivo que o zsh lê sempre que você abre uma janela do Terminal. Ele só adiciona uma linha que começa com alias vocatim=, então nada mais da área de transferência entra no arquivo.
4. Abra uma nova janela do Terminal e digite vocatim list. O alias funciona nas janelas que você abrir depois do passo 3.

Os quatro comandos:

• vocatim list mostra as suas 20 gravações mais recentes, uma por linha: id, data e hora, duração e título. vocatim list --limit 50 mostra até 50.
• vocatim search orçamento encontra gravações cujo título, transcrição, resumo, notas ou alguma tradução contêm “orçamento”. Coloque entre aspas uma busca com espaços: vocatim search "revisão semanal". Mostra até 10 resultados, ou até 20 com --limit 20.
• vocatim transcript <id> mostra a transcrição completa de uma gravação. O id está na primeira coluna de vocatim list e de vocatim search.
• vocatim summary <id> mostra o resumo dela.

Adicione --json a qualquer comando para obter JSON para os seus próprios scripts. vocatim help lista os comandos.

Sua chave. A linha vocatim em ~/.zshrc contém a sua chave do Vocatim. Se você colar essa linha diretamente no Terminal, a chave também fica no histórico do Terminal. A chave só permite que apps deste Mac leiam o Vocatim, e só enquanto o Vocatim estiver aberto. Não compartilhe a linha nem o arquivo; se já compartilhou, use “Redefinir a chave” no Vocatim.

Depois de “Redefinir a chave”, ou quando o Vocatim mostrar “A configuração mudou: configure seus apps de IA de novo.”, a linha antiga para de funcionar. Repita os passos 1 a 4. Vale a linha vocatim mais recente em ~/.zshrc; você pode apagar as mais antigas.

Depois de um comando, Apps de IA neste Mac nos Ajustes do Vocatim mostra vocatim-cli, assim como mostra o nome de um app de IA.

A linha de comando só se comunica com o Vocatim neste Mac e mostra o resultado na sua janela do Terminal. Se você passar esse resultado adiante, por exemplo para um serviço de IA online, ele vai para lá.

Para removê-la, apague todas as linhas vocatim de ~/.zshrc; depois de repetir os passos 1 a 4, pode haver mais de uma. Desativar a opção no Vocatim, ou “Redefinir a chave”, também a interrompe.

Se não funcionar: as mensagens da linha de comando do Vocatim começam com vocatim-mcp:.

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings. (o Vocatim não está aberto neste Mac ou o acesso de apps de IA está desativado nos Ajustes do Vocatim): abra o Vocatim e confira a opção. Depois de “Redefinir a chave” ou “A configuração mudou”, repita os passos 1 a 4. A linha acima, se houver, dá o motivo técnico, por exemplo vocatim-mcp: connect: Connection refused.
• zsh: command not found: vocatim: abra uma nova janela do Terminal. Se a mensagem continuar, verifique se ~/.zshrc tem uma linha que começa com alias vocatim=; se não tiver, repita os passos 1 a 4. Verifique também se echo $SHELL mostra /bin/zsh.
• zsh: no such file or directory com um caminho para vocatim-mcp: a linha aponta para um lugar onde o Vocatim não está mais, por exemplo depois que você moveu o app. Repita os passos 1 a 4.
• vocatim-mcp: Too many requests, try again in a moment. (solicitações demais, tente de novo daqui a pouco): espere um pouco e execute o comando de novo.
• vocatim sem comando, por exemplo vocatim ou vocatim --json, fica esperando e não mostra nada: pressione Control-C e depois digite um comando como vocatim list.

Para scripts: os dados vão para a saída padrão, completos e só quando o comando dá certo; as mensagens vão para a saída de erro padrão. Com --json, cada resposta do Vocatim é uma linha de JSON, então transcript mostra uma linha para cada página de uma transcrição longa: leia o resultado linha por linha, não como um único documento JSON. Códigos de saída: 0 concluído, 1 outro erro, 2 comando ou opção incorretos, 3 o Vocatim não está aberto ou o acesso está desativado, 4 solicitações demais.

O que sai do seu Mac

O acesso de apps de IA às suas gravações fica desativado por padrão. Você o ativa por conta própria nos Ajustes do Vocatim, só se decidir compartilhar suas transcrições com apps de IA neste Mac.

O próprio Vocatim não envia nada. Se o app de IA usar um modelo online, como o Claude Desktop, o ChatGPT e o Codex normalmente fazem, o que ele lê do Vocatim é enviado para essa empresa (Anthropic ou OpenAI), pela conta que você tem nela, como se você tivesse colado isso no chat.

Para interromper

Desative a opção no Vocatim. Redefinir a chave invalida todas as chaves que você copiou e todas as configurações que você colou. Para reconectar, configure o app de IA de novo. Para a extensão do Claude Desktop, clique de novo em Instalar no Claude Desktop no Vocatim, salve o arquivo e abra-o: o Vocatim copia a nova chave assim que o arquivo é salvo. Cole-a quando o Claude Desktop pedir, ou no campo Chave do Vocatim da extensão do Vocatim no Claude Desktop. Para o Cursor e o LM Studio, clique de novo em Adicionar ao Cursor ou Adicionar ao LM Studio. Se você colou uma configuração, copie-a de novo e cole-a por cima da entrada ou seção antiga. Depois, feche o app de IA por completo (fechar a janela dele não basta) e abra-o de novo: até lá, ele continua usando a chave antiga. Você também pode remover o Vocatim do app de IA: a extensão do Vocatim no Claude Desktop, a entrada "vocatim" na configuração dele, nos ajustes de MCP de outro app ou no arquivo de ajustes do Zed, ou a seção [mcp_servers.vocatim] em ~/.codex/config.toml.

Se não funcionar

• “O Vocatim não está aberto neste Mac ou o acesso de apps de IA está desativado nos Ajustes do Vocatim.”: abra o Vocatim e confira a opção. Depois de “Redefinir a chave”, configure o app de IA de novo, em seguida feche-o por completo (fechar a janela dele não basta) e abra-o novamente.
• O Vocatim mostra “A configuração mudou: configure seus apps de IA de novo.”: configure cada app de IA de novo como descrito acima, por cima da entrada ou seção antiga, e reinicie-o.
• O Vocatim mostra “O app não abriu. Ele está instalado neste Mac?”: instale esse app neste Mac. Para o Cursor e o LM Studio, você também pode usar Copiar a configuração para outros apps.
• O ChatGPT ou o Codex para de funcionar, ou informa um erro em config.toml, depois que você colou a configuração pela segunda vez: o arquivo tem duas seções [mcp_servers.vocatim]. Mantenha só a mais recente.
• O Codex diz que não há nenhuma ferramenta do Vocatim: comece uma nova conversa em um projeto cuja pasta esteja neste Mac (um projeto sincronizado de outro computador pode não ter pasta aqui).
• Você abriu o app de IA antes do Vocatim: reinicie o app de IA com o Vocatim aberto.
• Falta uma gravação: gravações na lixeira e gravações de exemplo não são mostradas, e uma nova gravação só aparece quando a transcrição dela termina ou é interrompida. Uma gravação que não foi totalmente transcrita aparece na lista, mas a transcrição e o resumo dela só ficam disponíveis quando ela estiver totalmente transcrita.