Gestiona tus archivos digitales desde Claude con EasyBits
EasyBits Team
8 min de lectura
MCP
EasyBits MCP te da acceso a más de 30 herramientas que puedes usar directamente desde Claude Desktop, Claude Code o Cursor. En esta guía exploramos cada una con ejemplos prácticos para que le saques el máximo provecho.
¿Aún no configuraste MCP?
Revisa primero nuestra guía de configuración
para conectar tu agente en 3 pasos.
Subir y gestionar archivos
El flujo básico de archivos es: subir → organizar → compartir.
Subir un archivo
"Sube un archivo llamado presentacion.pdf de 2MB, hazlo público"
La herramienta upload_file crea el registro y te devuelve una URL presigned para hacer el PUT con los bytes del archivo. Puedes elegir:
- Acceso:
publicoprivate - Región:
LATAM,USoEU - Asset: asociar el archivo a un asset existente
Listar archivos
"Muéstrame mis archivos"
list_files devuelve tus archivos con nombre, tamaño, tipo, acceso y fecha de creación. Soporta paginación con cursor para colecciones grandes.
Actualizar un archivo
"Cambia el nombre de ese archivo a 'Manual v2' y hazlo privado"
update_file puede cambiar nombre, nivel de acceso y metadata. Cuando cambias de público a privado (o viceversa), EasyBits copia el objeto entre buckets automáticamente.
Obtener detalles y URL de descarga
"Dame el link de descarga de mi archivo más reciente"
get_file devuelve toda la metadata del archivo más una URL firmada de descarga que expira en 1 hora.
Compartir contenido
EasyBits ofrece dos formas de compartir: por email o por link temporal.
Compartir por email
"Comparte el archivo con juan@ejemplo.com con acceso de lectura"
share_file crea un permiso de acceso para otro usuario de EasyBits. Puedes configurar permisos granulares: lectura, escritura y/o eliminación.
Generar links temporales
"Genera un link de descarga que expire en 24 horas"
generate_share_token crea una URL presigned con expiración configurable entre 60 segundos y 7 días. Ideal para compartir con personas que no tienen cuenta en EasyBits.
Ver tokens activos
"Muéstrame todos los share tokens de ese archivo"
list_share_tokens muestra todos los tokens generados con su estado de expiración. Puedes filtrar por archivo específico.
Optimizar imágenes
"Optimiza esa imagen PNG a WebP con calidad 85"
optimize_image convierte imágenes a WebP o AVIF, creando un archivo nuevo (el original no se toca). Devuelve:
- Tamaño original vs optimizado
- Porcentaje de ahorro
- El nuevo archivo con su ID
Valores por defecto
Si no especificas calidad, usa 80 para WebP y 50 para AVIF. Ambos ofrecen excelente relación calidad/tamaño.
Transformar imágenes
"Redimensiona mi última imagen a 400px de ancho"
"Rota esa foto 90 grados y conviértela a JPEG"
"Hazla blanco y negro y voltéala"
transform_image permite resize, rotar, voltear, convertir formato y escala de grises en una sola operación. Crea un archivo nuevo (el original no se toca). Parámetros disponibles:
- width/height — dimensiones objetivo
- fit — cover, contain, fill, inside, outside
- format — webp, avif, png, jpeg
- quality — 1-100
- rotate — grados de rotación
- flip — voltear verticalmente
- grayscale — blanco y negro
Búsqueda con IA
Para usar búsqueda inteligente, primero configura una API key de Anthropic u OpenAI:
"Configura mi key de Anthropic para búsqueda de archivos"
Una vez configurada, puedes buscar con lenguaje natural:
"Busca todos los PDFs que tengan que ver con facturas"
search_files usa IA para entender tu consulta y devuelve hasta 20 archivos relevantes, ordenados por fecha.
Gestionar keys de IA
| Herramienta | Qué hace |
|---|---|
set_ai_key | Guarda una key de Anthropic u OpenAI (encriptada) |
list_ai_keys | Muestra las keys configuradas (valores enmascarados) |
delete_ai_key | Elimina una key almacenada |
Papelera y recuperación
Los archivos eliminados no desaparecen inmediatamente. Tienes 7 días para recuperarlos.
"Muéstrame los archivos eliminados"
list_deleted_files muestra cada archivo con los días que faltan para la purga definitiva.
"Restaura ese archivo que borré ayer"
restore_file devuelve el archivo a estado activo inmediatamente.
Duplicar y permisos
"Duplica ese archivo PDF"
duplicate_file crea una copia completa del archivo (objeto de storage + registro en DB). Ideal para crear versiones sin perder el original.
"¿Quién tiene acceso a mi archivo?"
list_permissions muestra todos los permisos compartidos de un archivo: quién tiene acceso y con qué nivel (lectura, escritura, eliminación).
Operaciones en lote (Bulk)
Cuando necesitas trabajar con múltiples archivos a la vez:
"Sube estos 10 archivos de una vez"
bulk_upload_files genera hasta 20 URLs de upload en una sola operación, ahorrando tiempo y llamadas.
"Elimina todos los archivos de la carpeta temporal"
bulk_delete_files puede eliminar hasta 100 archivos de golpe. Todos van a papelera con los mismos 7 días de recuperación.
Webhooks
Recibe notificaciones en tiempo real cuando algo cambia en tus archivos:
"Crea un webhook que me notifique cuando se suba un archivo"
| Herramienta | Qué hace |
|---|---|
create_webhook | Crea un webhook con URL, eventos y secreto HMAC |
list_webhooks | Lista todos tus webhooks con su estado |
update_webhook | Actualiza URL, eventos o estado |
delete_webhook | Elimina un webhook |
Eventos disponibles: file.created, file.updated, file.deleted, file.restored, website.created, website.deleted.
Los webhooks incluyen firma HMAC (X-Easybits-Signature) para verificar autenticidad. Si un webhook falla 5 veces consecutivas, se pausa automáticamente.
Websites
EasyBits también permite gestionar sitios web estáticos:
"Crea un website llamado 'Mi Portfolio'"
| Herramienta | Qué hace |
|---|---|
create_website | Crea un sitio con slug automático |
list_websites | Lista todos los sitios con stats |
get_website | Detalle de un sitio (archivos, tamaño total) |
update_website | Cambia nombre o estado |
delete_website | Elimina el sitio (archivos van a papelera 7 días) |
Storage
"¿Qué proveedor de storage estoy usando?"
list_providers muestra tus proveedores configurados. Por defecto, EasyBits usa Tigris como almacenamiento.
Estadísticas de uso
"¿Cuánto storage estoy usando?"
get_usage_stats devuelve tu plan actual, storage usado/máximo, y conteo de archivos, websites y webhooks.
Documentación
"Muéstrame la documentación de la API"
get_docs devuelve la documentación completa de la API REST de EasyBits, ideal para que tu agente consulte endpoints y parámetros disponibles.
Referencia rápida: las 33 herramientas
| # | Herramienta | Categoría | Descripción |
|---|---|---|---|
| 1 | list_files | Archivos | Listar archivos con paginación |
| 2 | get_file | Archivos | Metadata + URL de descarga |
| 3 | upload_file | Archivos | Crear registro + URL de upload |
| 4 | update_file | Archivos | Actualizar nombre, acceso, metadata |
| 5 | delete_file | Archivos | Soft-delete (7 días de recuperación) |
| 6 | restore_file | Archivos | Restaurar archivo eliminado |
| 7 | list_deleted_files | Archivos | Ver papelera con días hasta purga |
| 8 | search_files | Archivos | Búsqueda con IA (lenguaje natural) |
| 9 | duplicate_file | Archivos | Duplicar archivo completo |
| 10 | list_permissions | Archivos | Ver permisos compartidos de un archivo |
| 11 | share_file | Compartir | Compartir por email con permisos |
| 12 | generate_share_token | Compartir | Link temporal (60s–7 días) |
| 13 | list_share_tokens | Compartir | Ver tokens y expiración |
| 14 | optimize_image | Imágenes | Convertir a WebP/AVIF |
| 15 | transform_image | Imágenes | Resize, rotar, voltear, escala de grises |
| 16 | bulk_upload_files | Bulk | Subir hasta 20 archivos a la vez |
| 17 | bulk_delete_files | Bulk | Eliminar hasta 100 archivos a la vez |
| 18 | list_webhooks | Webhooks | Listar webhooks configurados |
| 19 | create_webhook | Webhooks | Crear webhook con URL y eventos |
| 20 | update_webhook | Webhooks | Actualizar webhook |
| 21 | delete_webhook | Webhooks | Eliminar webhook |
| 22 | set_ai_key | IA | Guardar key de Anthropic/OpenAI |
| 23 | list_ai_keys | IA | Ver keys configuradas |
| 24 | delete_ai_key | IA | Eliminar key de IA |
| 25 | list_providers | Storage | Ver proveedores de almacenamiento |
| 26 | get_usage_stats | Cuenta | Plan, storage y conteos |
| 27 | list_websites | Websites | Listar sitios web |
| 28 | create_website | Websites | Crear nuevo sitio |
| 29 | get_website | Websites | Detalle de un sitio |
| 30 | update_website | Websites | Actualizar nombre/estado |
| 31 | delete_website | Websites | Eliminar sitio |
| 32 | get_docs | Utilidades | Documentación de la API REST |
Empieza ahora
- Configura tu agente en 3 pasos
- Prueba con: "Muéstrame mis archivos"
- Explora las 33 herramientas desde tu agente favorito
¿Dudas? Escríbenos en el chat de soporte o en GitHub.
