dimo storage

npx add-mcp 'https://dimosoftwares.ir/storage/mcp'

Configuración

Hay dos formas de conectarse. Si tu cliente admite «Iniciar sesión», la primera opción es más sencilla y segura.

1. Inicio de sesión (OAuth)

Para claude.ai, Claude Desktop, la app móvil de Claude, Cursor, VS Code y Claude Code. Solo introduce la dirección del servidor; se abrirá la página de inicio de sesión de dimo y, tras pulsar «Permitir», la conexión estará establecida. No se necesita token.

2. Token personal

Para clientes que solo aceptan cabeceras (Hermes, scripts, curl) o cuando no quieras que se abra el navegador. Crea el token en la siguiente sección y envíalo en la cabecera Authorization.

1. Añade la dirección del servidor en el cliente.
   El tipo de conexión es HTTP (Streamable HTTP). En la sección «Configuración de clientes» encontrarás ejemplos para cada cliente.
2. Inicia sesión o introduce el token.
   Con OAuth, pulsa el botón Connect/Authenticate del cliente. Con token, colócalo en la cabecera.
3. Prueba la conexión.
   Pide al asistente que ejecute storage_status; debería mostrarte el espacio utilizado y disponible.

Tu token personal

Solo es necesario para conectarse con token (segunda opción). Este token es distinto del token de Imgen: cada uno puede revocarse de forma independiente. El token es como una contraseña: no lo incluyas en código ni en repositorios públicos.

Para crear un token personal, inicia sesión en tu cuenta.

Configuración de clientes

En los ejemplos con token, sustituye DIMO_STORAGE_TOKEN por tu token (si ya has creado uno, se habrá reemplazado automáticamente). Para conectarte con inicio de sesión, elimina la sección headers.

No se necesita token. En claude.ai ve a Settings → Connectors → Add custom connector, introduce la siguiente dirección y, tras pulsar «Add», haz clic en «Connect». Se abrirá la página de inicio de sesión de dimo; pulsa «Permitir».

https://dimosoftwares.ir/storage/mcp

Deja vacía la sección «Advanced settings» (Client ID / Secret). Claude Desktop y la app móvil también usan este mismo connector. Storage e Imgen son dos connectors separados y puedes añadir solo uno.

Autenticación

Cada solicitud HTTP debe incluir el token en la cabecera. El token no se acepta en la dirección (query string), porque las direcciones quedan registradas en los logs. Los clientes que admiten inicio de sesión detectan automáticamente la ruta OAuth desde la cabecera de la respuesta 401.

Authorization: Bearer dimo_smcp_…    # توکن شخصی استوریج
Authorization: Bearer dimo_oat_…     # صادرشده با OAuth (claude.ai، Cursor)

# یا به‌جای آن:
X-Dimo-Key: dimo_smcp_…

401 Unauthorized

El token no se ha enviado, ha caducado o ha sido revocado. La respuesta incluye la cabecera WWW-Authenticate para que los clientes inicien automáticamente el inicio de sesión OAuth.

Separado de Imgen

El token de Storage (dimo_smcp_) y el token de Imgen (dimo_mcp_) son dos cosas distintas y no funcionan en el otro servidor. Los tokens OAuth también tienen ámbitos (scope) separados.

Tokens OAuth

El token de acceso tiene una validez de una hora y el cliente lo renueva automáticamente; si no se usa durante 60 días, deberás iniciar sesión de nuevo.

Agentes de dimo

Cada agente tiene su propio token (dimo_smcpa_…) y no depende de tu token personal. Desactivar el acceso a archivos o eliminar el agente corta su acceso.

Cambio de token

Con «Crear nuevo token», el token anterior deja de funcionar inmediatamente; actualiza los clientes.

Mantenimiento

dimo solo almacena el hash de los tokens; por eso no es posible volver a mostrar el token personal.

Herramientas

El cliente obtiene automáticamente la lista de herramientas. Obtén los identificadores de archivos (file_id) con list_files. Las herramientas de los grupos «Lectura» y «Cuenta» no modifican nada; trash_item es reversible y delete_file elimina de forma permanente.

list_filesLectura

Lista o busca archivos y carpetas; devuelve los identificadores de archivos para el resto de herramientas.

folder, search, kind, sort, limit, offset

list_foldersLectura

Árbol completo de carpetas en formato plano, con la profundidad de cada fila.

—

get_fileLectura

Información de un archivo junto con enlaces de vista y descarga (para entregártelos a ti).

file_id

read_fileLectura

Lee el contenido del archivo: texto como texto, imagen como vista previa, el resto en base64.

file_id, as_text, max_bytes

list_trashLectura

Archivos dentro de la papelera (recuperables hasta 30 días).

limit

storage_statusCuenta

Espacio utilizado, disponible y total, y número de archivos.

resync

upload_fileEscritura

Guarda un archivo nuevo; se crea la carpeta con nombre no especificado y nunca se sobrescribe un nombre existente.

filename, text | data_base64, folder, content_type

create_folderEscritura

Crea una carpeta, dentro de otra si es necesario.

name, parent

rename_itemEscritura

Cambia el nombre de un archivo o una carpeta.

new_name, file_id | folder_id

move_fileEscritura

Mueve un archivo a otra carpeta (o a la raíz del espacio de almacenamiento).

file_id, folder

trash_itemEliminación

Envía un archivo o una carpeta completa a la papelera: reversible hasta 30 días.

file_id | folder_id

restore_fileEliminación

Restaura un archivo desde la papelera.

file_id

delete_fileEliminación

Eliminación permanente y liberación de espacio; requiere confirm=true y es irreversible.

file_id, confirm

share_fileCompartir

Crea un enlace público para un archivo o revoca un enlace existente.

file_id | revoke_token, expires_days

Ejemplos de solicitudes

No es necesario conocer los nombres de las herramientas; basta con pedirlo en lenguaje natural.

Buscar

«Busca contratos en mi espacio de almacenamiento y dame la lista.»

Leer

«Lee el archivo notes.md y resúmelo.»

Crear

«Guarda esta tabla como CSV en la carpeta de documentos.»

Organizar

«Mueve todas las imágenes de la raíz del espacio de almacenamiento a la carpeta de imágenes.»

Compartir

«Crea un enlace público de siete días para el informe trimestral.»

Espacio

«¿Cuánto espacio tengo ocupado y cuáles son mis archivos más grandes?»

Con Imgen

«Crea un póster y guárdalo junto a los archivos de la campaña.» (Imgen lo crea, Storage lo mueve.)

Notas

El mismo espacio

Este es el mismo espacio que ves en «Mis archivos», no una copia. Cualquier cambio que haga el asistente se verá inmediatamente en la página web.

Eliminación en dos pasos

trash_item envía el archivo a la papelera y es recuperable hasta 30 días. delete_file es permanente y, para evitar errores, requiere confirm=true.

Nunca se sobrescribe

Un nombre duplicado se convierte en «nombre (2)»; ninguna herramienta reemplaza el contenido de un archivo existente.

Cuota

Las cargas descuentan de tu espacio contratado. Si no hay espacio, la herramienta devuelve un error claro.

Tamaño

Cada carga a través de MCP es de hasta 64 MB y la lectura de archivos binarios de hasta 8 MB; para archivos más grandes, usa la página de carga.

Carpeta de agentes

Cuando el agente no especifica una carpeta, su salida se guarda en «Archivos de agentes» para no saturar la raíz de tu espacio.

Enlace compartido

El enlace público se abre sin necesidad de cuenta. Cuando quieras, revócalo con share_file(revoke_token=…) o desde la página «Compartido».

Solución de problemas

claude.ai no se conecta

Introduce la dirección exactamente como arriba, sin / al final, y deja vacía la sección Advanced settings. Si tras pulsar «Permitir» no vuelves a claude.ai, pulsa el botón «Volver a la aplicación».

401 con token

El token ha sido revocado o cambiado, falta el prefijo Bearer , o has enviado el token de Imgen a este servidor. Crea un token de Storage y sustitúyelo.

«No hay espacio suficiente»

Tu cuota está llena. Vacía la papelera o añade espacio desde paquetes de recursos.

No se encuentra el archivo

Quizá esté en la papelera; pulsa list_trash. La búsqueda de list_files(search=…) recorre todo el espacio, no solo la carpeta actual.

«Esta extensión no está permitida»

El servidor de Storage no acepta scripts del lado del servidor (php, sh, py, etc.). Cambia la extensión o coloca el archivo en un archivo comprimido.

No se ven las herramientas

Tras cambiar la configuración, reinicia el cliente o haz clic en Refresh en la lista de servidores MCP.