Clientes admitidos
| Cliente | Autoconfigurado | Reiniciar después de instalar |
|---|---|---|
| Claude Desktop | ✓ | ⌘Q + reabrir |
| Claude Code | ✓ | Salir + nueva sesión de Claude |
| Codex Desktop | ✓ | Salir + reabrir |
| Cursor/Windsurf/VS Code/Zed | ✓ | Recargar según la interfaz de usuario del cliente |
| Claude Web/ChatGPT Web | Guía interactiva | No se necesita reiniciar |
Requisitos previos
- Node.js ≥ 20 — Descargar
- Una cuenta Plaud
Instalación
Ejecútalo una vez. El instalador detecta tus clientes de IA, escribe la configuración de MCP y abre tu navegador para iniciar sesión:Opciones
| Alerta | Qué hace |
|---|---|
| —yes | Autoconfigura todos los clientes locales detectados sin necesidad de avisos |
| —no-login | Omite el paso de inicio de sesión del navegador (útil en máquinas remotas o sin cabeza) |
Otros clientes de MCP
Si tu cliente no se detecta automáticamente, agrega Plaud manualmente pegando esto en la configuración MCP de tu cliente:Claude Web
1- Abre los conectores Accede a claude.ai, navega hasta la barra lateral izquierda y haz clic en Personalizar → Conectores. 2- Añade el servidor Plaud MCP Haz clic en Añadir conector personalizado. Completa el formulario:- Nombre: Plaud
- URL del servidor MCP remoto: https://mcp.plaud.ai/mcp
ChatGPT Web
1- Habilita el modo desarrollador Ve a chatgpt.com, haz clic en el avatar de tu perfil y selecciona Configuración → Aplicaciones → Configuración avanzada. Activa el Modo de desarrollador. 2- Crea la Plaud app Haz clic en Crear aplicación. Completa el formulario:- Nombre: Plaud
- URL del servidor MCP: https://mcp.plaud.ai/mcp
- Autenticación — OAuth
Inicio rápido
Una vez completada la instalación, inicia sesión desde tu cliente de IA:- Inicia sesión en Plaud
- Enumera mis grabaciones recientes
- Resume la presentación del martes
- Redacta un correo electrónico de seguimiento con los puntos de acción de esta reunión
Herramientas
Estas herramientas estará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 en OAuth |
| logout | Cierra sesión y revoca tu autorización |
| get_current_user | Muestra los detalles de tu cuenta actual |
| list_files | Enumera tus grabaciones con filtros opcionales |
| get_file | Devuelve todos los detalles de una sola grabación |
| get_note | Devuelve el resumen, los elementos de acción y los temas clave generados por la IA |
| get_transcript | Devuelve la transcripción completa con marcas de tiempo y etiquetas de orador |
Filtrar grabaciones con list_files
| Parámetro | Descripción |
|---|---|
| query | Coincidencia de palabras clave insensible a mayúsculas en el nombre de grabación |
| date_from | Fecha de inicio, AAAA-MM-DD |
| date_to | Fecha de finalización, AAAA-MM-DD |
| page/page_size | Paginación (ignorada cuando se establecen filtros) |
Referencia de datos
Campos devueltos por list_files y get_file
| Campo | Tipo | Descripción |
|---|---|---|
| id | secuencia | ID de grabación único |
| name | secuencia | Nombre de la grabación |
| created_at | secuencia | Hora de creación (ISO 8601) |
| start_at | secuencia | Hora de inicio de la grabación (ISO 8601) |
| duration | número | Duración en milisegundos |
| serial_number | secuencia | Número de serie del dispositivo |
Campos adicionales devueltos solo por get_file
| Campo | Tipo | Descripción |
|---|---|---|
| presigned_url | secuencia | URL de descarga de audio temporal (válido 24 horas) |
| source_list | matriz | Segmentos de transcripción con marcas de tiempo y etiquetas de orador |
| note_list | matriz | Notas generadas por IA en Markdown |
Habilidades
Las habilidades son instrucciones prediseñadas 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 hay pasos adicionales.| Habilidad | Se dispara cuando pides cosas como… |
|---|---|
| plaud-browse | «enumera mis grabaciones», «muéstrame los archivos recientes» |
| plaud-find | «encuentra la sincronización semanal», «la reunión del lunes» |
| plaud-read | «muéstrame la transcripción», «resume esta grabación» |
| plaud-digest | «informe semanal», «qué reuniones he tenido esta semana» |
| plaud-followup | «redacta un correo electrónico de seguimiento», «enumera los elementos de acción» |
| plaud-export | «guárdalo en Notion», «publícalo en Slack» |
Actualización
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 |
Solución de problemas
| Síntoma | Solución |
|---|---|
| Las herramientas Plaud no aparecen después de la instalación | Asegúrate de reiniciar el cliente por completo; cerrar y volver a abrir la ventana no es suficiente. Para Claude Code, sal y comienza una nueva sesión de Claude. |
| 401 / Errores «no autenticados» | Pídele a tu cliente de IA: «inicia 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 los 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 el puerto 8199 primero: ssh -L 8199:localhost:8199 user@host. |
| Mensaje de «Servidor desconectado» en Claude Desktop | Vuelve a ejecutar la configuración: plaud-mcp unsetup && plaud-mcp setup y, 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. |