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	✓	Cerrar + reabrir
Cursor / Windsurf / VS Code / Zed	✓	Recargar según la interfaz del cliente
Claude Web / ChatGPT Web	Guía interactiva	No necesita reinicio

---

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 MCP y abre tu navegador para iniciar sesión:

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

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

Opciones

Opción	Qué hace
--yes	Configura automáticamente todos los clientes locales detectados sin preguntar
--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, añade Plaud manualmente pegando esto en la configuración MCP de tu cliente:

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

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

Al conectarse mediante HTTP, los datos de tus grabaciones pasan por el servidor MCP de Plaud (alojado en EE. UU.). Plaud no almacena estos datos después de completar la solicitud — solo se procesan 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 **Añadir conector personalizado**. Rellena el formulario:

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

Haz clic en **Añadir**.

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 ya están disponibles en tu conversación.

ChatGPT Web

[chatgpt.com](https://chatgpt.com) En la barra lateral izquierda, haz clic en Apps y busca Plaud Haz clic en Conectar e inicia sesión con Plaud

---

Inicio rápido

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

Iníciame sesión en Plaud

Tu navegador abrirá la página de autorización de Plaud. Haz clic en Autorizar y vuelve a tu cliente — ya 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 el inicio de 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, puntos de acción y 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 palabra clave sin distinción de mayúsculas/minúsculas en el nombre de la grabación
date_from	Fecha de inicio, YYYY-MM-DD
date_to	Fecha de fin, YYYY-MM-DD
page / page_size	Paginación (se ignora cuando se establecen filtros)

---

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 la 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", "enumera los puntos de acción"
plaud-export	"guarda en Notion", "publica 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 instalar	Asegúrate de haber reiniciado completamente el cliente — cerrar y reabrir la ventana no es suficiente. Para Claude Code, sal y comienza una nueva sesión claude.
Errores de 401 / "No autenticado"	Pregunta a tu cliente de IA: "iníciame sesión en Plaud".
No hay clientes locales configurados en modo --yes	Instala primero un cliente local compatible, o ejecuta sin --yes para obtener orientación interactiva para clientes web.
Errores de actualización de token	Elimina ~/.plaud/tokens-mcp.json e inicia sesión de nuevo.
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 primero el puerto 8199: 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, luego reinicia.