Plaud MCP

Plaud MCP

Conecte suas gravações do Plaud a qualquer cliente de IA compatível com MCP — Claude, Cursor, ChatGPT, Codex e mais. Pesquise gravações, leia transcrições e gere documentos sem sair do seu assistente de IA.

Clientes suportados

Cliente	Configuração automática	Reiniciar após a instalação
Claude Desktop	✓	⌘Q + reabrir
Claude Code	✓	Sair + nova sessão claude
Codex Desktop	✓	Sair + reabrir
Cursor / Windsurf / VS Code / Zed	✓	Recarregar conforme a UI do cliente
Claude Web / ChatGPT Web	Guia interativo	Não é necessário reiniciar

---

Pré-requisitos

• Node.js ≥ 20 — download
• Uma conta Plaud

---

Instalar

Execute isto uma vez. O instalador detecta seus clientes de IA, grava a configuração MCP e abre seu navegador para login:

npx -y @plaud-ai/mcp@latest install

Quando seu navegador abrir, clique em Autorizar e reinicie os clientes listados na saída do instalador. As ferramentas Plaud estarão disponíveis imediatamente na sua próxima sessão.

Opções

Sinalizador	O que faz
--yes	Configurar automaticamente todos os clientes locais detectados sem avisos
--no-login	Pular a etapa de login no navegador (útil em máquinas remotas ou headless)

Outros clientes MCP

Se o seu cliente não for detectado automaticamente, adicione o Plaud manualmente colando isto na configuração MCP do seu cliente:

{ "mcpServers": { "plaud": { "command": "npx", "args": ["-y", "@plaud-ai/mcp@latest"] } } }

**Clientes baseados em HTTP (Claude Web, ChatGPT Web)**

Ao conectar via HTTP, seus dados de gravação passam pelo servidor MCP da Plaud (hospedado nos EUA). A Plaud não armazena esses dados após a conclusão da solicitação — eles são processados apenas em trânsito. O tratamento de dados é regido pela política de privacidade da Plaud.

Claude Web

Acesse [claude.ai](https://claude.ai), navegue até a barra lateral esquerda e clique em Personalizar -> Conectores. Clique em **Adicionar conector personalizado**. Preencha o formulário:

* **Nome** — `Plaud Web MCP`
* **URL do servidor MCP remoto** — `https://mcp.plaud.ai/mcp`

Clique em **Adicionar**.

O Claude abrirá a página de autorização da Plaud no seu navegador. Faça login na sua conta Plaud e clique em **Autorizar**. Retorne ao Claude — as ferramentas Plaud agora estão disponíveis na sua conversa.

ChatGPT Web

[chatgpt.com](https://chatgpt.com) Na barra lateral esquerda, clique em Apps e procure por Plaud Clique em Conectar e faça login com o Plaud

---

Início rápido

Uma vez instalado, faça login a partir do seu cliente de IA:

Faça login no Plaud para mim

Seu navegador abrirá a página de autorização da Plaud. Clique em Autorizar e retorne ao seu cliente — você estará logado.

Então experimente:

Liste minhas gravações recentes

Resuma a reunião diária de terça-feira

Rascunhe um e-mail de acompanhamento a partir dos itens de ação desta reunião

---

Ferramentas

Estas ferramentas estão disponíveis para o seu cliente de IA assim que o Plaud MCP estiver conectado:

Ferramenta	Descrição
login	Abre seu navegador para login OAuth
logout	Desconecta e revoga sua autorização
get_current_user	Mostra os detalhes da sua conta atual
list_files	Lista suas gravações, com filtros opcionais
get_file	Retorna detalhes completos de uma única gravação
get_note	Retorna o resumo gerado por IA, itens de ação e tópicos principais
get_transcript	Retorna a transcrição completa com timestamps e identificação de falante

Filtrando gravações com list_files

Parâmetro	Descrição
query	Correspondência de palavra-chave insensível a maiúsculas/minúsculas no nome da gravação
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 filtros são definidos)

---

Referência de dados

Campos retornados por list_files e get_file

Campo	Tipo	Descrição
id	string	ID único da gravação
name	string	Nome da gravação
created_at	string	Hora de criação (ISO 8601)
start_at	string	Hora de início da gravação (ISO 8601)
duration	number	Duração em milissegundos
serial_number	string	Número de série do dispositivo

Campos adicionais retornados apenas por get_file

Campo	Tipo	Descrição
presigned_url	string	URL temporária de download do áudio (válida por 24 horas)
source_list	array	Segmentos da transcrição com timestamps e identificação de falante
note_list	array	Notas geradas por IA em Markdown

---

Habilidades

Habilidades são instruções pré-construídas que ajudam seu cliente de IA a lidar com fluxos de trabalho comuns do Plaud automaticamente. Elas são carregadas quando o instalador é executado — sem etapas extras necessárias.

Habilidade	Acionada quando você pergunta coisas como…
plaud-browse	"liste minhas gravações", "mostre arquivos recentes"
plaud-find	"encontre a Sincronização Semanal", "a reunião de segunda-feira"
plaud-read	"mostre a transcrição", "resuma esta gravação"
plaud-digest	"relatório semanal", "quais reuniões eu tive esta semana"
plaud-followup	"rascunhe um e-mail de acompanhamento", "liste os itens de ação"
plaud-export	"salve no Notion", "publique no Slack"

---

Atualizar

npm install -g @plaud-ai/mcp@latest

Reinicie seu cliente de IA após a atualização.

Para o Claude Code especificamente:

npx -y @plaud-ai/mcp clean-plugin

Então reinstale dentro do Claude Code:

/plugin install plaud

---

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

Então remova o pacote e os dados locais:

npm uninstall -g @plaud-ai/mcp
rm -rf ~/.plaud

---

Solução de problemas

Sintoma	Correção
As ferramentas Plaud não aparecem após a instalação	Certifique-se de ter feito uma reinicialização completa do cliente — fechar e reabrir a janela não é suficiente. Para o Claude Code, saia e inicie uma nova sessão claude.
Erros de 401 / "Não autenticado"	Pergunte ao seu cliente de IA: "faça login no Plaud para mim".
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 de atualização de token	Exclua ~/.plaud/tokens-mcp.json e faça login novamente.
O navegador não abre durante o login	Copie a URL que o instalador imprime e abra-a manualmente. Em máquinas remotas, encaminhe a porta 8199 primeiro: ssh -L 8199:localhost:8199 user@host.
"Servidor desconectado" no Claude Desktop	Execute a configuração novamente: plaud-mcp unsetup && plaud-mcp setup e reinicie o Claude Desktop.
A versão não foi atualizada após a atualização	Execute npx -y @plaud-ai/mcp clean-plugin, reinstale com /plugin install plaud no Claude Code e reinicie.