Plaud MCP

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 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 interface do cliente
Claude Web / ChatGPT Web	Guia interativo	Sem necessidade de reiniciar
Kiro	✓	Sem necessidade de reiniciar

---

Pré-requisitos

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

---

Instalação

Execute isto uma vez. O instalador detecta seus clientes de IA, grava a configuração do MCP e abre seu navegador para o 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 do Plaud estarão disponíveis imediatamente na sua próxima sessão.

Opções

Sinalizador	O que faz
--yes	Configura automaticamente todos os clientes locais detectados sem prompts
--no-login	Pula a etapa de login no navegador (útil em máquinas remotas ou sem interface gráfica)

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"] 
    } 
  } 
}

Observação

Clientes baseados em HTTP (Claude Web, ChatGPT Web)

Ao conectar via HTTP, seus dados de gravação 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 em trânsito. O tratamento de dados é regido pela política de privacidade do Plaud.

Claude Web

Acesse [claude.ai](https://claude.ai), navegue até a barra lateral esquerda e clique em Personalizar -> Conectores. Clique em Conectores, pesquise por Plaud Web MCP e conecte

<Frame>
  <img src="https://mintcdn.com/plaud/T9vhBbV0G8_IPDu5/assets/claude-connect.png?fit=max&auto=format&n=T9vhBbV0G8_IPDu5&q=85&s=002c6e580441b8855f6893353fccbb22" alt="claude-connect" width="2560" height="1529" data-path="assets/claude-connect.png" />
</Frame>

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 agora estão disponíveis na sua conversa.

<Frame>
  <img src="https://mintcdn.com/plaud/T9vhBbV0G8_IPDu5/assets/claude-authorize.jpeg?fit=max&auto=format&n=T9vhBbV0G8_IPDu5&q=85&s=78a2a4242c986e961063cfaa1df65e07" alt="claude-authorize" width="2560" height="1348" data-path="assets/claude-authorize.jpeg" />
</Frame>

ChatGPT Web

[chatgpt.com](https://chatgpt.com) Na barra lateral esquerda, clique em Plugins e pesquise por Plaud

<Frame>
  <img src="https://mintcdn.com/plaud/K9rhUzfIEHohj91s/assets/gpt-connect.png?fit=max&auto=format&n=K9rhUzfIEHohj91s&q=85&s=733f6ac382ba202e7cf9ffd7d3b2e737" alt="gpt-connect" width="2230" height="1250" data-path="assets/gpt-connect.png" />
</Frame>

Clique em Conectar e entre com o Plaud

---

Outros clientes

[Diretório de servidores Kiro](https://kiro.dev/docs/mcp/servers/)

<Step title="Add the Plaud MCP Server">
  <Frame>
    <img src="https://mintcdn.com/plaud/TwHXjNWgs8jnS7KS/assets/kiro.png?fit=max&auto=format&n=TwHXjNWgs8jnS7KS&q=85&s=3e17df30ca4afe46c1a934f912a73c07" alt="kiro" width="2546" height="1440" data-path="assets/kiro.png" />
  </Frame>
</Step>

Início rápido

Após a instalação, entre pelo seu cliente de IA:

Faça login no Plaud

Seu navegador abrirá a página de autorização do Plaud. Clique em Autorizar e volte ao seu cliente — você está conectado.

Depois, experimente:

Liste minhas gravações recentes

Resuma a reunião de terça-feira

Rascunhe um e-mail de acompanhamento com base nos itens de ação desta reunião

---

Ferramentas

Estas ferramentas estão disponíveis para seu cliente de IA quando o Plaud MCP está conectado:

Ferramenta	Descrição
login	Abre seu navegador para login OAuth
logout	Encerra a sessão 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 carimbos de data/hora e rótulos de falante

Filtrando gravações com list_files

Parâmetro	Descrição
query	Correspondência de palavra-chave sem diferenciar maiúsculas/minúsculas no nome da gravação
date_from	Data inicial, YYYY-MM-DD
date_to	Data final, YYYY-MM-DD
page / page_size	Paginação (ignorada quando filtros estão 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	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 de áudio (válida por 24 horas)
source_list	array	Segmentos de transcrição com carimbos de data/hora e rótulos 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 o Síncrono 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 tive esta semana"
plaud-followup	"rascunhe um e-mail de acompanhamento", "liste os itens de ação"
plaud-export	"salvar no Notion", "publicar no Slack"

---

Atualização

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

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

Especificamente para Claude Code:

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

Depois, reinstale dentro do 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	Correção
As ferramentas do Plaud não aparecem após a instalação	Certifique-se de fazer uma reinicialização completa do cliente — fechar e reabrir a janela não é suficiente. Para Claude Code, saia e inicie uma nova sessão claude.
Erros 401 / "Não autenticado"	Peça ao seu cliente de IA: "faça login no Plaud".
Nenhum cliente local configurado no modo --yes	Instale primeiro um cliente local compatível ou execute sem --yes para obter orientação interativa para clientes web.
Erros de atualização de token	Exclua ~/.plaud/tokens-mcp.json e entre 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, depois reinicie o Claude Desktop.
A versão não atualizou 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 é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.