Plaud MCP
oficialConecte suas gravações do Plaud a qualquer cliente de IA compatível com MCP. Pesquise gravações, leia transcrições e gere documentos sem sair do seu assistente de IA.
O que você pode fazer com Plaud MCP?
- Listar gravações — Peça ao seu assistente para listar gravações recentes do Plaud, opcionalmente filtradas por palavra-chave ou período.
- Ler transcrições — Recupere a transcrição completa de uma gravação, com marcações de tempo e identificação dos falantes.
- Obter notas de IA — Obtenha o resumo gerado por IA, as ações a realizar e os principais tópicos de uma gravação.
- Redigir acompanhamentos — Peça ao seu assistente para redigir um e-mail de acompanhamento com base nas ações a realizar de uma reunião.
- Gerenciar acesso — Entre ou saia do Plaud pelo seu cliente de IA e confira os dados atuais da conta.
Documentação
Plaud MCP
Conecte suas gravações do Plaud a qualquer cliente de IA compatível com MCP — Claude, Cursor, ChatGPT, Codex e outros. Pesquise gravações, leia transcrições e gere documentos sem sair do seu assistente de IA.
Clientes compatíveis
| 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 pela interface do cliente |
| Claude Web / ChatGPT Web | Guia interativo | Não é necessário reiniciar |
| Kiro | ✓ | Não é necessário reiniciar |
Pré-requisitos
- Node.js ≥ 20 — baixar
- Uma conta Plaud
Instalação
Execute este comando uma vez. O instalador detecta seus clientes de IA, grava a configuração do MCP e abre seu navegador para você entrar:
npx -y @plaud-ai/mcp@latest install
Quando o navegador abrir, clique em Autorizar e reinicie os clientes listados na saída do instalador. As ferramentas do Plaud estarão disponíveis imediatamente na próxima sessão.
Opções
| Sinalizador | O que faz |
|---|---|
--yes | Configura automaticamente todos os clientes locais detectados, sem solicitar confirmação |
--no-login | Ignora a etapa de entrada pelo navegador (útil em máquinas remotas ou sem interface gráfica) |
Outros clientes MCP
Se seu cliente não for detectado automaticamente, adicione o Plaud manualmente colando isto na configuração MCP do cliente:
{
"mcpServers": {
"plaud": {
"command": "npx",
"args": ["-y", "@plaud-ai/mcp@latest"]
}
}
}
[!NOTE]
Clientes baseados em HTTP (Claude Web, ChatGPT Web)
Ao se conectar por HTTP, os dados das suas gravações passam pelo servidor MCP do Plaud (hospedado nos EUA). O Plaud não armazena esses dados após a conclusão da solicitação — eles são processados apenas durante a transmissão. O tratamento dos dados é regido pela política de privacidade do Plaud.
Claude Web
1. Abra os conectores
Acesse claude.ai, vá até a barra lateral esquerda e clique em Customize -> Connectors.
2. Adicione o servidor MCP do Plaud
Clique em Connectors, pesquise Plaud Web MCP e conecte-se

3. Autorize
O Claude abrirá a página de autorização do Plaud no seu navegador. Entre na sua conta Plaud e clique em Autorizar. Volte ao Claude — as ferramentas do Plaud já estarão disponíveis na sua conversa.

ChatGPT Web
1. Abra o ChatGPT Web
2. Encontre o plugin do Plaud
Na barra lateral esquerda, clique em Plugins e pesquise Plaud

3. Conecte-se
Clique em Connect e entre com sua conta Plaud
Outros clientes
[accordion] Configuração do Kiro
1. Acesse o diretório de servidores do Kiro
Diretório de servidores do Kiro
2. Adicione o servidor MCP do Plaud
Início rápido
Depois de instalar, entre pela interface do seu cliente de IA:
Faça meu login no Plaud
Seu navegador abrirá a página de autorização do Plaud. Clique em Autorizar e volte ao cliente — sua sessão estará iniciada.
Depois, experimente:
Liste minhas gravações recentes
Resuma a reunião diária de terça-feira
Escreva um e-mail de acompanhamento com base nos itens de ação desta reunião
Ferramentas
Estas ferramentas ficam disponíveis no seu cliente de IA quando o Plaud MCP está conectado:
| Ferramenta | Descrição |
|---|---|
login | Abre seu navegador para entrar via OAuth |
logout | Encerra a sessão e revoga sua autorização |
get_current_user | Mostra os dados atuais da sua conta |
list_files | Lista suas gravações, com filtros opcionais |
get_file | Retorna todos os detalhes de uma gravação |
get_note | Retorna o resumo gerado por IA, os itens de ação e os principais tópicos |
get_transcript | Retorna a transcrição completa com marcações de tempo e identificação dos falantes |
Filtrar gravações com list_files
| Parâmetro | Descrição |
|---|---|
query | Busca por palavra-chave no nome da gravação, sem diferenciar maiúsculas de minúsculas |
date_from | Data inicial, YYYY-MM-DD |
date_to | Data final, YYYY-MM-DD |
page / page_size | Paginação (ignorada quando há filtros definidos) |
Referência de dados
Campos retornados por list_files e get_file
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID exclusivo da gravação |
name | string | Nome da gravação |
created_at | string | Horário de criação (ISO 8601) |
start_at | string | Horário 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 somente por get_file
| Campo | Tipo | Descrição |
|---|---|---|
presigned_url | string | URL temporária para baixar o áudio (válida por 24 horas) |
source_list | array | Segmentos da transcrição com marcações de tempo e identificação dos falantes |
note_list | array | Anotações geradas por IA em Markdown |
Skills
As skills são instruções pré-configuradas que ajudam seu cliente de IA a executar automaticamente fluxos de trabalho comuns do Plaud. Elas são carregadas quando o instalador é executado — não é necessário fazer mais nada.
| Skill | Acionada quando você pede algo como… |
|---|---|
plaud-browse | "liste minhas gravações", "mostre os arquivos recentes" |
plaud-find | "encontre a Weekly Sync", "a reunião de segunda-feira" |
plaud-read | "mostre a transcrição", "resuma esta gravação" |
plaud-digest | "relatório semanal", "quais reuniões tive esta semana" |
plaud-followup | "escreva um e-mail de acompanhamento", "liste os itens de ação" |
plaud-export | "salve no Notion", "publique no Slack" |
Atualização
npm install -g @plaud-ai/mcp@latest
Reinicie seu cliente de IA após a atualização.
Especificamente para o Claude Code:
npx -y @plaud-ai/mcp clean-plugin
Depois, reinstale pelo Claude Code:
/plugin install plaud
Desinstalação
| 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 |
Depois, remova o pacote e os dados locais:
npm uninstall -g @plaud-ai/mcp
rm -rf ~/.plaud
Solução de problemas
| Sintoma | Solução |
|---|---|
| As ferramentas do Plaud não aparecem após a instalação | Faça uma reinicialização completa do cliente — fechar e reabrir a janela não é suficiente. No Claude Code, saia e inicie uma nova sessão claude. |
Erros 401 / "Not authenticated" | Peça ao seu cliente de IA: "faça meu login no Plaud". |
Nenhum cliente local configurado no modo --yes | Instale primeiro um cliente local compatível ou execute sem --yes para receber orientações interativas para clientes Web. |
| Erros de atualização do token | Exclua ~/.plaud/tokens-mcp.json e entre novamente. |
| O navegador não abre durante a entrada | Copie a URL exibida pelo instalador e abra-a manualmente. Em máquinas remotas, encaminhe primeiro a porta 8199: ssh -L 8199:localhost:8199 user@host. |
| "Server disconnected" no Claude Desktop | Execute a configuração novamente: plaud-mcp unsetup && plaud-mcp setup, depois 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. |
Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.
