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
- Em um novo chat, ative o conector Zernote.
- Abra o prompt de upload no Claude
- 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)
- Entre no Zernote no seu navegador.
- Abra claude.ai → Configurações → Personalizar → Connectors.
- Pesquise por Zernote → clique em Conectar.
- Complete o login OAuth no Zernote e aprove o acesso.
- 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 pastasfolders:write- Criar e renomear pastasinterviews:read- Ler suas entrevistas, resumos, notas e cartões de citaçãointerviews:write- Renomear, organizar e gerenciar participantesinterviews:upload- Enviar áudio/vídeo/texto/PDF de entrevistas via widget no chattranscripts:read- Ler transcrições de entrevistassearch:read- Pesquisar suas entrevistasnotes: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
| Ferramenta | Escopo OAuth | Acesso | Descrição | Exemplo de prompt |
|---|---|---|---|---|
projects_read | folders:read | Leitura | Listar projetos (action=list). Suporta paginação. Alias legado: folders_read. | "Quais projetos de pesquisa eu tenho?" |
projects_edit | folders:write | Escrita | Criar ou renomear projetos. Alias legado: folders_edit. | "Crie um projeto chamado Lote de descoberta 2" |
interviews_read | interviews:read / transcripts:read | Leitura | Listar/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_edit | interviews:write / notes:write | Escrita | Renomear, 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}" |
search | search:read | Leitura | Busca semântica com trechos de transcrição correspondentes e URLs de citação. | "Encontre entrevistas mencionando objeções de preço" |
cards_read | interviews:read | Leitura | Listar cartões de citação codificados com links profundos opcionais para citações. | "Liste cartões de dor de entrevistas no projeto X" |
jtbd_read | interviews:read | Leitura | Listar segmentos JTBD e árvores de jobs (grafo com escopo por segmento). | "Mostre a árvore de jobs para o segmento desta entrevista" |
jtbd_edit | interviews:write | Escrita | Extrair jobs, mover entrevistas entre segmentos, preencher jobs/soluções. | "Extraia jobs JTBD da entrevista {id}" |
upload_interview | interviews:upload | Escrita | Abre 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
- "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."
- "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."
- "Liste cartões de citação com lens=gtm neste projeto e salve uma nota de síntese curta na entrevista {id}."
- "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
- Abra uma janela anônima ou privada do navegador.
- Entre no Zernote com a conta correta.
- Entre no claude.ai com a conta Claude correta.
- Desconecte e reconecte o conector Zernote.
O conector não mostra ferramentas
- Acesse claude.ai/customize/connectors (use a interface web mesmo se você conversar no Claude Desktop).
- Desconecte o Zernote e clique em Conectar novamente sem atualizar a página.
- 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