Servidor MCP
Deja que tu agente de IA comparta archivos desde tu propio bucket
aktar mcp conecta Claude, Cursor, VS Code, Codex y otros agentes con la app de Aktar. Pide un enlace y el agente sube el archivo a tu propio bucket de S3, Cloudflare R2 o Backblaze B2, y te da la URL o el Markdown. Tus claves de almacenamiento nunca salen de Aktar.
npm install -g @getaktar/cli claude mcp add --scope user aktar -- aktar mcpDespués ejecuta aktar login una vez. Cursor, VS Code, Codex y otros están más abajo.
Sube la captura del bug del checkout que está en mi Escritorio y dame un enlace en Markdown para el issue.
upload_file{ "path": "~/Desktop/checkout-bug.png" }Subida a tu destino Screenshots. Aquí tienes el Markdown para el issue:
Qué puedes pedir
Dilo como se lo dirías a un compañero. El agente elige la herramienta, Aktar hace la subida con los ajustes propios del destino, y tú recibes el enlace en la conversación.
-
Comparte un archivo desde una sesión
“Comprime el build en un zip y dame un enlace que pueda enviar a QA.”
El agente crea el archivo y lo sube. Si no nombras un destino, Aktar elige uno según el tipo de archivo (el ajuste Usar para de cada destino), igual que al soltar en la barra de menús.
Herramientas:
upload_file -
Imágenes para un README o un issue
“Añade al README la captura que acabo de copiar.”
Sube la imagen, o lo que haya en el portapapeles, y escribe el Markdown donde corresponde. La conversión a WebP y la eliminación de la ubicación las hace Aktar, según indique el destino.
Herramientas:
upload_file,upload_clipboard -
Actualiza un archivo, conserva su enlace
“Reemplaza el PDF de onboarding que compartí la semana pasada por esta nueva versión.”
Encuentra la subida en el historial y escribe el archivo nuevo encima. Todos los que tienen el enlace ven la versión nueva; no hay que volver a enviar nada.
Herramientas:
search_uploads,replace_file -
Encuentra lo que subiste
“¿Cuál era el enlace de la factura que subí el lunes?”
Busca en el historial de Aktar por nombre y fecha, y puede mirar las miniaturas para distinguir capturas, fotos y documentos.
Herramientas:
search_uploads,get_thumbnail -
Un enlace que caduca
“Dame un enlace de 30 minutos al contrato del bucket Legal.”
Un enlace prefirmado a cualquier archivo de un bucket, para buckets privados o para compartir durante un tiempo limitado. No cambia nada en el bucket.
Herramientas:
create_temporary_link -
Echa un vistazo a tus buckets
“¿Qué hay en la carpeta releases de mi bucket Builds?”
Lista carpetas y archivos, incluidos los que no se subieron con Aktar, y sabe qué destino se usa para qué tipos de archivo.
Herramientas:
list_bucket,list_destinations
Configúralo en dos pasos
Aktar para Mac o Windows hace la subida, así que tiene que estar abierto en el mismo ordenador que tu agente.
Instala el comando
aktary conéctalo a Aktar. En Aktar, abre Ajustes → Integraciones, activa Permitir conexiones locales y copia el token, luego pégalo enaktar login.npm install -g @getaktar/cli aktar loginAñade Aktar a tu agente. El agente inicia
aktar mcppor sí solo cuando lo necesita.Claude Code
Un comando, para todos los proyectos. Compruébalo con
/mcpen Claude Code.claude mcp add --scope user aktar -- aktar mcpCodex
Un comando; se guarda en
~/.codex/config.toml.codex mcp add aktar -- aktar mcpClaude Desktop
Abre Settings > Developer > Edit Config, añade esto y reinicia Claude Desktop.
En claude_desktop_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }Cursor
Añade esto al archivo, o a
.cursor/mcp.jsonen un solo proyecto.En ~/.cursor/mcp.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }VS Code
Un comando lo añade a tu perfil de VS Code. El modo agente de Copilot lista entonces las herramientas de Aktar.
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp"]}'Windsurf
Añade esto al archivo y luego actualiza los servidores MCP en los ajustes de Windsurf.
En ~/.codeium/windsurf/mcp_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }
Si una app dice que no encuentra aktar, pon la ruta completa que da which aktar en command; las apps de escritorio no siempre cargan el PATH de tu shell. Sin instalación global, usa npx como comando y ["-y", "@getaktar/cli", "mcp"] como argumentos. Cualquier otro agente que ejecute servidores MCP por stdio funciona igual.
Herramientas que recibe tu agente
Buscar, listar, los enlaces temporales y las miniaturas solo miran. Subir y reemplazar cambian tu bucket, y tu agente pregunta antes de usarlas a menos que lo permitas.
| Herramienta | Qué hace |
|---|---|
upload_file | Sube un archivo y devuelve su enlace, Markdown y HTML. Destino, nombre, carpeta y caducidad son opcionales. |
upload_clipboard | Sube el archivo o la imagen del portapapeles. |
replace_file | Escribe un archivo nuevo sobre una subida y conserva su enlace. Necesita Aktar para Mac 0.14.0 o Windows 0.7.0. |
search_uploads | Busca en el historial de subidas. |
list_destinations | Lista los destinos y los tipos de archivo para los que se usa cada uno. |
list_bucket | Lista las carpetas y archivos de un bucket, incluidos los archivos no subidos con Aktar. |
create_temporary_link | Crea un enlace que deja de funcionar pasado un tiempo (una URL prefirmada). |
get_thumbnail | Muestra al agente una vista previa de una subida. Necesita Aktar para Mac 0.13.0 o Windows 0.6.0. |
list_watched_folders | Lista las carpetas vigiladas y su estado. |
get_status | Comprueba la conexión con Aktar. |
delete_upload | Borra una subida de su bucket. Solo con --allow-delete. |
Tú decides qué puede tocar
Una subida es pública para cualquiera que tenga el enlace, así que el servidor es cuidadoso por defecto y puedes restringirlo aún más.
-
Subir es publicar
Al agente se le indica que suba solo lo que pediste compartir, y los agentes preguntan antes de llamar a una herramienta que sube.
-
Solo desde tus carpetas
--rootlimita las subidas a las carpetas que nombres. Las rutas se resuelven, enlaces simbólicos incluidos, así que un enlace a~/.ssho a un.enven otro sitio se rechaza. -
Solo lectura, y sin borrar
--read-onlydeja fuera toda herramienta que escriba. Borrar de un bucket ni siquiera se ofrece, a menos que añadas--allow-delete. -
Tus claves se quedan en Aktar
El servidor habla con Aktar en 127.0.0.1 con tu token. El agente nunca ve tus claves de acceso, y nada pasa por un servidor nuestro.
aktar mcp --root ~/Projects --root ~/Desktop
aktar mcp --read-only¿Sin MCP? Usa el skill
Para los agentes que usan skills pero no MCP, aktar skill imprime un SKILL.md que les enseña el comando aktar: qué ejecutar, cómo leer --json y que suban solo lo que pediste. Todos los comandos están en la documentación de la CLI.
mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.mdRequisitos
- Aktar para Mac o Windows, abierto, con al menos un destino
-
El comando
aktar0.4.0 o posterior (Node.js 18 o posterior) - Un agente que ejecute servidores MCP por stdio
- Reemplazar archivos: Aktar para Mac 0.14.0 o Windows 0.7.0. Miniaturas: Mac 0.13.0 o Windows 0.6.0
- Código abierto (MIT) en GitHub, listado en el MCP Registry oficial
Preguntas
¿Funciona con ChatGPT u otros agentes en el navegador?
Todavía no. El servidor se ejecuta en tu ordenador junto a Aktar y habla con los agentes por stdio, así que funciona con agentes que se ejecutan en tu ordenador: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf y otros.
¿Puede el agente subir archivos que no pedí?
Solo puede llamar a las herramientas que permitas, y los agentes preguntan antes de llamar a una herramienta que sube, salvo que hayas dicho lo contrario. Para estar seguro, inicia el servidor con --root para que solo se pueda subir desde las carpetas que nombres, o con --read-only.
¿A qué bucket sube?
Al mismo que al soltar un archivo en la barra de menús de Aktar: el destino cuyo ajuste Usar para coincide con el tipo de archivo, o el seleccionado. Nombra un destino en tu petición y el agente usará ese.
¿Tiene algún coste?
No. Aktar, la CLI y el servidor MCP son gratuitos. Pagas a tu proveedor de almacenamiento por el bucket, como siempre.
¿Funciona en Windows?
Sí. El comando aktar funciona igual con Aktar para Windows, y también todos los agentes anteriores.