Clientes compatíveis
| Cliente | Configurado automaticamente | Reiniciar após a instalação |
|---|---|---|
| Claude Desktop | ✓ | ⌘Q + reabrir |
| Claude Code | ✓ | Sair + nova sessão do Claude |
| Codex Desktop | ✓ | Sair + reabrir |
| Cursor / Windsurf / VS Code / Zed | ✓ | Recarregar pela interface do cliente |
| Claude Web / ChatGPT Web | Guia interativo | Não é necessário reiniciar |
Pré-requisitos
- Node.js ≥ 20 — Descarregar
- Uma conta Plaud
Instalar
Execute isto uma vez. O programa de instalação deteta os seus clientes AI, configura o MCP e abre o seu navegador para que possa iniciar sessão:Opções
| Flag | O que faz |
|---|---|
| —yes | Configura automaticamente todos os clientes locais detetados sem solicitar confirmação |
| —no-login | Ignora o passo de início de sessão no navegador (útil em máquinas remotas ou sem monitor) |
Outros clientes do MCP
Se o seu cliente não for detetado automaticamente, adicione o Plaud manualmente colando isto na configuração MCP do seu cliente:Claude Web
1 — Abrir conectores Aceda a claude.ai, vá até à barra lateral esquerda e clique em Personalizar → Conectores. 2 — Adicionar o servidor Plaud MCP Clique em Adicionar conector personalizado. Preencha o formulário:- Nome — Plaud
- URL do servidor MCP remoto: https://mcp.plaud.ai/mcp
ChatGPT Web
1 — Ativar modo de programador Aceda a chatgpt.com, clique no seu avatar de perfil e selecione Definições → Aplicações → Definições avançadas. Ligue o Modo de Programador. 2 — Criar a Plaud app Clique em Criar aplicação. Preencha o formulário:- Nome — Plaud
- URL do servidor MCP: https://mcp.plaud.ai/mcp
- Autenticação: OAuth
Início rápido
Uma vez instalado, entre no seu cliente IA:- Iniciar sessão no Plaud
- Lista das minhas gravações recentes
- Resumir a reunião de terça-feira
- Redigir um e-mail de acompanhamento com base nos pontos de ação desta reunião
Ferramentas
Estas ferramentas ficam disponíveis para o seu cliente de IA assim que o Plaud MCP estiver ligado:| Ferramenta | Descrição |
|---|---|
| login | Abre o seu navegador para o login OAuth |
| Logout | Saia e revoga sua autorização |
| get_current_user | Mostra os detalhes da sua conta atual |
| list_files | Lista as suas gravações, com filtros opcionais |
| get_file | Apresenta todos os detalhes de uma única gravação |
| get_note | Devolve o resumo gerado pela IA, as ações a realizar e os tópicos principais |
| get_transcript | Devolve a transcrição completa com marcas temporais e indicações dos interlocutores |
Filtrar gravações com list_files
| Parâmetro | Descrição |
|---|---|
| query | Correspondência de palavras-chave no nome da gravação, sem distinção entre maiúsculas e minúsculas |
| date_from | Data de início, YYYY-MM-DD |
| date_to | Data de término, YYYY-MM-DD |
| page / page_size | Paginação (ignorada quando são definidos filtros) |
Referência de dados
Campos devolvidos pelas funções list_files e get_file
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | ID de gravação exclusivo |
| name | string | Nome da gravação |
| created_at | string | Tempo de criação (ISO 8601) |
| start_at | string | Tempo de início de gravação (ISO 8601) |
| duration | number | Duração em milissegundos |
| serial_number | string | Número de série do dispositivo |
Campos adicionais devolvidos apenas pela função get_file
| Campo | Tipo | Descrição |
|---|---|---|
| presigned_url | string | URL de download de áudio temporário (válido 24 horas) |
| source_list | array | Segmentos de transcrição com marcas temporais e indicação do interlocutor |
| note_list | array | Notas geradas por IA em Markdown |
Habilidades
As habilidades são instruções pré-definidas que ajudam o seu cliente de IA a gerir automaticamente fluxos de trabalho comuns do Plaud. São carregadas quando o instalador é executado. Não são necessários passos adicionais.| Habilidade | Aciona-se quando se perguntam coisas como… |
|---|---|
| plaud-browse | «listar as minhas gravações», «mostrar ficheiros recentes» |
| plaud-find | «encontrar a Sincronização Semanal», «a reunião de segunda-feira» |
| plaud-read | «mostrar a transcrição», «resumir esta gravação» |
| plaud-digest | «relatório semanal», «que reuniões tive esta semana» |
| plaud-followup | «redigir um e-mail de acompanhamento», «enumerar os itens de ação» |
| plaud-export | «guardar no Notion», «publicar no Slack» |
Atualizar
Desinstalar
| Cliente | Comando de limpeza |
|---|---|
| Claude Desktop | plaud-mcp unsetup |
| Claude Code | claude mcp remove plaud —scope user && npx -y @plaud-ai/mcp clean-plugin |
| Codex Desktop | plaud-mcp unsetup codex |
Resolução de problemas
| Sintoma | Correção |
|---|---|
| As ferramentas Plaud não aparecem após a instalação | Certifique-se de que reiniciou completamente o cliente. Fechar e voltar a abrir a janela não é suficiente. Para o Claude Code, saia e inicie uma nova sessão do Claude. |
| Erros 401 / «Não autenticado» | Peça ao seu cliente de IA: «inicia sessão no Plaud». |
| Nenhum cliente local configurado no modo —yes | Instale um cliente local suportado primeiro, ou execute sem —yes para obter orientação interativa para clientes web. |
| Erros na atualização do token | Apague ~/.plaud/tokens-mcp.json e entre novamente. |
| O navegador não abre durante o início de sessão | Copie o URL que o instalador apresenta e abra-o manualmente. Em máquinas remotas, encaminhe a porta 8199 primeiro: ssh -L 8199:localhost:8199 user@host. |
| «Servidor desconectado» em Claude Desktop | Execute novamente a configuração: plaud-mcp unsetup && plaud-mcp setup, depois reinicie o Claude Desktop. |
| A versão não foi atualizada após a atualização | Execute o npx -y @plaud-ai/mcp clean-plugin, reinstale com o /plugin install plaud no Claude Code e, em seguida, reinicie. |