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.

1Instala la CLI
npm install -g @getaktar/cli
2Añádelo a Claude Code
claude mcp add --scope user aktar -- aktar mcp

Despué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.

Aktar llamadoupload_file{ "path": "~/Desktop/checkout-bug.png" }

Subida a tu destino Screenshots. Aquí tienes el Markdown para el issue:

![checkout-bug.png](https://files.example.com/2026/10/7f3c2a91.png)

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.

  1. Instala el comando aktar y conéctalo a Aktar. En Aktar, abre Ajustes → Integraciones, activa Permitir conexiones locales y copia el token, luego pégalo en aktar login.

    npm install -g @getaktar/cli
    aktar login
  2. Añade Aktar a tu agente. El agente inicia aktar mcp por sí solo cuando lo necesita.

    Claude Code

    Un comando, para todos los proyectos. Compruébalo con /mcp en Claude Code.

    claude mcp add --scope user aktar -- aktar mcp

    Codex

    Un comando; se guarda en ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

    Claude 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.json en 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.

HerramientaQué hace
upload_fileSube un archivo y devuelve su enlace, Markdown y HTML. Destino, nombre, carpeta y caducidad son opcionales.
upload_clipboardSube el archivo o la imagen del portapapeles.
replace_fileEscribe un archivo nuevo sobre una subida y conserva su enlace. Necesita Aktar para Mac 0.14.0 o Windows 0.7.0.
search_uploadsBusca en el historial de subidas.
list_destinationsLista los destinos y los tipos de archivo para los que se usa cada uno.
list_bucketLista las carpetas y archivos de un bucket, incluidos los archivos no subidos con Aktar.
create_temporary_linkCrea un enlace que deja de funcionar pasado un tiempo (una URL prefirmada).
get_thumbnailMuestra al agente una vista previa de una subida. Necesita Aktar para Mac 0.13.0 o Windows 0.6.0.
list_watched_foldersLista las carpetas vigiladas y su estado.
get_statusComprueba la conexión con Aktar.
delete_uploadBorra 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

    --root limita las subidas a las carpetas que nombres. Las rutas se resuelven, enlaces simbólicos incluidos, así que un enlace a ~/.ssh o a un .env en otro sitio se rechaza.

  • Solo lectura, y sin borrar

    --read-only deja 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.md

Requisitos

  • Aktar para Mac o Windows, abierto, con al menos un destino
  • El comando aktar 0.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.