Plaud MCP

Plaud MCP

Conecta tus grabaciones de Plaud a cualquier cliente de IA compatible con MCP — Claude, Cursor, ChatGPT, Codex y más. Busca grabaciones, lee transcripciones y genera documentos sin salir de tu asistente de IA.

Clientes compatibles

Cliente	Configuración automática	Reiniciar después de instalar
Claude Desktop	✓	⌘Q + reabrir
Claude Code	✓	Salir + nueva sesión claude
Codex Desktop	✓	Salir + reabrir
Cursor / Windsurf / VS Code / Zed	✓	Recargar según la interfaz del cliente
Claude Web / ChatGPT Web	Guía interactiva	Sin necesidad de reiniciar
Kiro	✓	Sin necesidad de reiniciar

---

Requisitos previos

• Node.js ≥ 20 — descargar
• Una cuenta de Plaud

---

Instalación

Ejecuta esto una vez. El instalador detecta tus clientes de IA, escribe la configuración de MCP y abre tu navegador para iniciar sesión:

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

Cuando tu navegador se abra, haz clic en Autorizar y luego reinicia los clientes listados en la salida del instalador. Las herramientas de Plaud estarán disponibles inmediatamente en tu próxima sesión.

Opciones

Indicador	Qué hace
--yes	Configura automáticamente todos los clientes locales detectados sin preguntas
--no-login	Omite el paso de inicio de sesión en el navegador (útil en máquinas remotas o sin interfaz gráfica)

Otros clientes MCP

Si tu cliente no se detecta automáticamente, agrega Plaud manualmente pegando esto en la configuración de MCP de tu cliente:

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

**Clientes basados en HTTP (Claude Web, ChatGPT Web)**

Cuando te conectas mediante HTTP, tus datos de grabación pasan a través del servidor MCP de Plaud (alojado en EE. UU.). Plaud no almacena estos datos después de que la solicitud se completa — se procesan solo en tránsito. El manejo de datos se rige por la política de privacidad de Plaud.

Claude Web

Ve a [claude.ai](https://claude.ai), navega a la barra lateral izquierda y haz clic en Personalizar -> Conectores. Haz clic en Conectores, busca Plaud Web MCP y conéctate

<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>

Claude abrirá la página de autorización de Plaud en tu navegador. Inicia sesión en tu cuenta de Plaud y haz clic en **Autorizar**. Vuelve a Claude — las herramientas de Plaud ahora están disponibles en tu conversación.

<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) En la barra lateral izquierda, haz clic en Complementos y busca 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>

Haz clic en Conectar e inicia sesión con Plaud

---

Otros clientes

[Directorio 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>

Inicio rápido

Una vez instalado, inicia sesión desde tu cliente de IA:

Inicia sesión en Plaud

Tu navegador abrirá la página de autorización de Plaud. Haz clic en Autorizar y vuelve a tu cliente — has iniciado sesión.

Luego prueba:

Lista mis grabaciones recientes

Resume la reunión diaria del martes

Redacta un correo de seguimiento a partir de los puntos de acción de esta reunión

---

Herramientas

Estas herramientas están disponibles para tu cliente de IA una vez que Plaud MCP esté conectado:

Herramienta	Descripción
login	Abre tu navegador para iniciar sesión OAuth
logout	Cierra sesión y revoca tu autorización
get_current_user	Muestra los detalles de tu cuenta actual
list_files	Lista tus grabaciones, con filtros opcionales
get_file	Devuelve los detalles completos de una sola grabación
get_note	Devuelve el resumen generado por IA, los puntos de acción y los temas clave
get_transcript	Devuelve la transcripción completa con marcas de tiempo y etiquetas de hablante

Filtrar grabaciones con list_files

Parámetro	Descripción
query	Coincidencia de palabras clave sin distinción de mayúsculas en el nombre de la grabación
date_from	Fecha de inicio, YYYY-MM-DD
date_to	Fecha de finalización, YYYY-MM-DD
page / page_size	Paginación (se ignora cuando hay filtros establecidos)

---

Referencia de datos

Campos devueltos por list_files y get_file

Campo	Tipo	Descripción
id	string	ID único de grabación
name	string	Nombre de la grabación
created_at	string	Hora de creación (ISO 8601)
start_at	string	Hora de inicio de la grabación (ISO 8601)
duration	number	Duración en milisegundos
serial_number	string	Número de serie del dispositivo

Campos adicionales devueltos solo por get_file

Campo	Tipo	Descripción
presigned_url	string	URL temporal de descarga de audio (válida 24 horas)
source_list	array	Segmentos de transcripción con marcas de tiempo y etiquetas de hablante
note_list	array	Notas generadas por IA en Markdown

---

Habilidades

Las habilidades son instrucciones predefinidas que ayudan a tu cliente de IA a manejar flujos de trabajo comunes de Plaud automáticamente. Se cargan cuando se ejecuta el instalador — no se necesitan pasos adicionales.

Habilidad	Se activa cuando preguntas cosas como…
plaud-browse	"lista mis grabaciones", "muestra archivos recientes"
plaud-find	"encuentra el Sincronización Semanal", "la reunión del lunes"
plaud-read	"muestra la transcripción", "resume esta grabación"
plaud-digest	"informe semanal", "¿qué reuniones tuve esta semana?"
plaud-followup	"redacta un correo de seguimiento", "lista los puntos de acción"
plaud-export	"guardar en Notion", "publicar en Slack"

---

Actualización

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

Reinicia tu cliente de IA después de actualizar.

Para Claude Code específicamente:

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

Luego reinstala dentro de Claude Code:

/plugin install plaud

---

Desinstalación

Cliente	Comando de limpieza
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

Luego elimina el paquete y los datos locales:

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

---

Solución de problemas

Síntoma	Solución
Las herramientas de Plaud no aparecen después de la instalación	Asegúrate de haber hecho un reinicio completo del cliente — cerrar y volver a abrir la ventana no es suficiente. Para Claude Code, sal y abre una nueva sesión claude.
401 / errores "No autenticado"	Pregunta a tu cliente de IA: "inicia sesión en Plaud".
Ningún cliente local configurado en modo --yes	Instala primero un cliente local compatible, o ejecuta sin --yes para obtener una guía interactiva para clientes web.
Errores de actualización de token	Elimina ~/.plaud/tokens-mcp.json y vuelve a iniciar sesión.
El navegador no se abre durante el inicio de sesión	Copia la URL que imprime el instalador y ábrela manualmente. En máquinas remotas, reenvía el puerto 8199 primero: ssh -L 8199:localhost:8199 user@host.
"Servidor desconectado" en Claude Desktop	Vuelve a ejecutar la configuración: plaud-mcp unsetup && plaud-mcp setup, luego reinicia Claude Desktop.
La versión no se actualizó después de la actualización	Ejecuta npx -y @plaud-ai/mcp clean-plugin, reinstala con /plugin install plaud en Claude Code, y luego reinicia.