Zernote

Espaço de trabalho de pesquisa de usuários para transcrever entrevistas e transformar conversas em insights.

Documentação

1. O que você pode fazer

  • Listar e gerenciar pastas de pesquisa; navegar por entrevistas por pasta ou Inbox
  • Ler resumos de entrevistas, notas, cartões de citação e janelas de transcrição
  • Pesquisar em todas as entrevistas com busca semântica e citar fragmentos correspondentes
  • Renomear/mover entrevistas; escrever ou substituir notas e resumos quando você solicitar
  • Enviar via Claude - áudio/vídeo de até 2 GB, além de texto (.txt/.md) ou PDF para o Inbox (mídia é transcrita; texto/PDF ficam prontos imediatamente)
  • Detecção automática do entrevistador para que as perguntas do entrevistador não sejam tratadas como insights do respondente

2. Pré-requisitos

  • Uma conta Zernote ativa (contas vazias são aceitas - o upload é o primeiro passo)
  • Uma conta Claude com suporte a Connectors (Claude.ai, Claude Desktop ou Claude Code)

Depois de conectar

  1. Em um novo chat, ative o conector Zernote.
  2. Abra o prompt de upload no Claude
  3. Envie via Claude - áudio/vídeo de até 2 GB, .txt/.md ou PDF → depois analise com busca, notas e cartões de citação.

3. Conectar no Claude.ai (fluxo de diretório)

  1. Entre no Zernote no seu navegador.
  2. Abra claude.ai → Configurações → Personalizar → Connectors.
  3. Pesquise por Zernote → clique em Conectar.
  4. Complete o login OAuth no Zernote e aprove o acesso.
  5. Em um novo chat: [+] → Connectors → ative o Zernote.

4. Claude Code

claude mcp add --transport http zernote https://zernote.com/mcp

Em seguida, execute /mcp, selecione zernote e escolha Autenticar para concluir o OAuth no seu navegador.

5. Endpoint MCP e autenticação

  • Endpoint MCP: https://zernote.com/mcp
  • Transporte: Streamable HTTP (POST)
  • Autenticação: OAuth 2.1 com autorização baseada em navegador e registro dinâmico de clientes. Não há chave de API ou método de acesso por conta de serviço para MCP.
  • Metadados do servidor de autorização OAuth: https://zernote.com/.well-known/oauth-authorization-server
  • Metadados do recurso protegido OAuth: https://zernote.com/.well-known/oauth-protected-resource/mcp

Cada usuário autentica individualmente. O cliente conectado recebe apenas os dados da sua própria conta Zernote.

6. Escopos OAuth

O Zernote usa escopos OAuth granulares. Durante a autorização, você pode ver as seguintes permissões:

  • folders:read - Ler suas pastas
  • folders:write - Criar e renomear pastas
  • interviews:read - Ler suas entrevistas, resumos, notas e cartões de citação
  • interviews:write - Renomear, organizar e gerenciar participantes
  • interviews:upload - Enviar áudio/vídeo/texto/PDF de entrevistas via widget no chat
  • transcripts:read - Ler transcrições de entrevistas
  • search:read - Pesquisar suas entrevistas
  • notes:write - Escrever ou substituir notas e resumos de entrevistas

Se o cliente conectado não solicitar escopos específicos, todos os oito escopos são concedidos por padrão.

7. Referência de ferramentas

FerramentaEscopo OAuthAcessoDescriçãoExemplo de prompt
projects_readfolders:readLeituraListar projetos (action=list). Suporta paginação. Alias legado: folders_read."Quais projetos de pesquisa eu tenho?"
projects_editfolders:writeEscritaCriar ou renomear projetos. Alias legado: folders_edit."Crie um projeto chamado Lote de descoberta 2"
interviews_readinterviews:read / transcripts:readLeituraListar/obter entrevistas e janelas de transcrição. A listagem padrão usa resumos breves; a transcrição usa janelas de caracteres."Liste entrevistas no projeto X com resumos breves"
interviews_editinterviews:write / notes:writeEscritaRenomear, mover, substituir notas/resumo (substituição completa), assign_speakers, set_voiceprint (detecção automática do entrevistador)."Confirme que o participante B é o entrevistador na entrevista {id}"
searchsearch:readLeituraBusca semântica com trechos de transcrição correspondentes e URLs de citação."Encontre entrevistas mencionando objeções de preço"
cards_readinterviews:readLeituraListar cartões de citação codificados com links profundos opcionais para citações."Liste cartões de dor de entrevistas no projeto X"
jtbd_readinterviews:readLeituraListar segmentos JTBD e árvores de jobs (grafo com escopo por segmento)."Mostre a árvore de jobs para o segmento desta entrevista"
jtbd_editinterviews:writeEscritaExtrair jobs, mover entrevistas entre segmentos, preencher jobs/soluções."Extraia jobs JTBD da entrevista {id}"
upload_interviewinterviews:uploadEscritaAbre o widget Enviar para Zernote no chat (áudio/vídeo/texto/PDF). Primeiro passo recomendado para contas novas."Envie esta gravação de entrevista para o Zernote"

Nomes de ferramentas mais antigos (folders_read, folders_edit, list_folders, list_interviews, get_interview, get_transcript, search_interviews, write_note) ainda funcionam como aliases para clientes conectados.

Exemplos de prompts

  1. "Abra o widget de upload do Zernote para eu enviar a entrevista de hoje (áudio, texto ou PDF) para o Inbox e depois sugira títulos quando estiver pronta."
  2. "Para o projeto zernote-batch-1, leia os resumos e notas das entrevistas e depois encontre evidências de apoio com busca e citações."
  3. "Liste cartões de citação com lens=gtm neste projeto e salve uma nota de síntese curta na entrevista {id}."
  4. "Detecte automaticamente o participante A sinalizado como entrevistador - mostre links de citação e depois confirme o nome para preencher retroativamente."

8. Permissões e acesso a dados

O OAuth concede acesso apenas aos dados da sua conta Zernote. O assistente conectado lê ou escreve somente quando você solicita naquele chat. O Zernote nunca compartilha seus dados com um assistente de IA, a menos que você conclua a autorização OAuth para esse cliente específico. Para detalhes completos sobre quais dados as conexões MCP podem acessar, consulte a seção 7 da nossa Política de Privacidade.

9. Solução de problemas

A conexão falha ou a conta Zernote errada

  1. Abra uma janela anônima ou privada do navegador.
  2. Entre no Zernote com a conta correta.
  3. Entre no claude.ai com a conta Claude correta.
  4. Desconecte e reconecte o conector Zernote.

O conector não mostra ferramentas

  1. Acesse claude.ai/customize/connectors (use a interface web mesmo se você conversar no Claude Desktop).
  2. Desconecte o Zernote e clique em Conectar novamente sem atualizar a página.
  3. Inicie um novo chat e ative o conector Zernote.

Ainda com problemas?

Envie um e-mail para report@zernote.com com:

  • Qual cliente você está usando (Claude.ai, Claude Desktop, Claude Code ou outro cliente MCP)
  • Uma gravação de tela das etapas de conexão
  • Logs do console do navegador (Cmd+Option+I → Console no macOS; Ctrl+Shift+I → Console no Windows/Linux)

10. Desconectar e revogar acesso

Para revogar o acesso, vá em Claude → Configurações → Personalizar → Connectors → Zernote → Desconectar. Os tokens OAuth são revogados quando você desconecta; o Zernote para de servir seus dados para esse cliente imediatamente.

11. Contato

E-mail de suporte do produto: report@zernote.com

Suporte do produto: @sagotly

Consulte também Suporte.

Última atualização: 31/07/2026 · Início · Suporte · Privacidade