• Servidor MCP
  • aktar v0.6.0

Deixe seu agente de IA compartilhar arquivos do seu próprio bucket

aktar mcp conecta Claude, Cursor, VS Code, Codex e outros agentes ao app Aktar. Peça um link e o agente envia o arquivo para o seu próprio bucket S3, Cloudflare R2 ou Backblaze B2 e entrega a URL ou o Markdown. Suas chaves de armazenamento nunca saem do Aktar.

Depois execute aktar login uma vez. Cursor, VS Code, Codex e outros estão abaixo.

Envie a captura de tela do bug do checkout que está na minha Mesa e me dê um link em Markdown para a issue.

Chamou o Aktar · upload_file

Enviado para o seu destino Screenshots. Aqui está o Markdown para a issue:

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

Configure em dois passos

O Aktar para Mac ou Windows faz o envio, então ele precisa estar aberto no mesmo computador que o seu agente.

PASSO 01

Instale o comando aktar e conecte-o ao Aktar. No Aktar, abra Ajustes > Integrações, ative Permitir conexões locais e copie o token; depois cole-o no aktar login.

npm install -g @getaktar/cli
aktar login
PASSO 02

Adicione o Aktar ao seu agente, com a pasta da qual ele pode enviar arquivos depois de --root (repita-o para mais pastas). O agente inicia o aktar mcp sozinho quando precisar.

Claude Code

Um comando, para todos os projetos. Troque ~/Projects pela pasta em que fica o seu trabalho. Confira com /mcp no Claude Code.

claude mcp add --scope user aktar -- aktar mcp --root ~/Projects

Se um app disser que não encontra o aktar, coloque em command o caminho completo mostrado por which aktar; apps de desktop nem sempre carregam o PATH do seu shell. Sem uma instalação global, use npx como comando e ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] como argumentos. Troque /Users/you/Projects pela sua própria pasta (no Windows, algo como C:\\Users\\you\\Projects). Sem --root, os arquivos vêm só da pasta em que o agente inicia o servidor, e nenhum quando ela é a sua pasta pessoal ou a raiz do disco, como costuma acontecer com apps de desktop. Qualquer outro agente que execute servidores MCP via stdio funciona da mesma forma.

O que você pode pedir

Fale como falaria com um colega. O agente escolhe a ferramenta, o Aktar faz o envio com os ajustes do próprio destino e você recebe o link na conversa.

  • Compartilhar um arquivo durante a sessão

    “Compacte o build em um zip e me dê um link que eu possa mandar para o QA.”

    O agente cria o arquivo e o envia. Sem um destino indicado, o Aktar escolhe um pelo tipo de arquivo (o Usar para de cada destino), como um arquivo solto na barra de menus.

    Ferramentas:upload_file

  • Imagens para um README ou uma issue

    “Adicione ao README a nova captura de tela em docs/images.”

    Ele envia a imagem e escreve o Markdown no lugar certo. A conversão para WebP e a remoção da localização acontecem no Aktar, conforme o destino definir.

    Ferramentas:upload_file

  • Atualizar um arquivo mantendo o link

    “Substitua o PDF de onboarding que compartilhei na semana passada por esta nova versão.”

    Ele encontra o envio no histórico e grava o novo arquivo por cima. Quem tem o link vê a nova versão; não é preciso enviar nada de novo. Substituir sobrescreve o arquivo antigo, então precisa de --allow-replace.

    Ferramentas:search_uploadsreplace_file

  • Encontrar o que você enviou

    “Qual era o link da fatura que enviei na segunda-feira?”

    Ele pesquisa o histórico do Aktar por nome e data e pode olhar as miniaturas para distinguir capturas de tela, fotos e documentos.

    Ferramentas:search_uploadsget_thumbnail

  • Um link que expira

    “Me dê um link de 30 minutos para o contrato no bucket Legal.”

    Um link pré-assinado para qualquer arquivo de um bucket, para buckets privados ou para compartilhar por tempo limitado. Nada muda no bucket.

    Ferramentas:create_temporary_link

  • Explorar seus buckets

    “O que tem na pasta releases do meu bucket Builds?”

    Ele lista pastas e arquivos, inclusive os que não foram enviados com o Aktar, e sabe qual destino é usado para cada tipo de arquivo.

    Ferramentas:list_bucketlist_destinations

Passo a passo para a sua ferramenta de IA

Um plugin pronto ou uma configuração para copiar, com o que pedir depois de configurar.

Listado em:Official MCP RegistryGlamamcpservers.org

Ferramentas que seu agente recebe

Pesquisar, listar, criar links temporários e ver miniaturas só leem. Enviar altera o seu bucket, e seu agente pergunta antes de usar essa ferramenta, a menos que você permita. Substituir e excluir só são oferecidos quando você os ativa.

FerramentaO que faz
upload_fileEnvia um arquivo e devolve o link, o Markdown e o HTML. Destino, nome, pasta e expiração são opcionais. short pede um link curto, ou nenhum.
upload_clipboardEnvia o arquivo ou a imagem da área de transferência. short pede um link curto, ou nenhum. Fica de fora quando --root é passado.
replace_fileGrava um arquivo novo por cima de um envio ou de qualquer arquivo em um bucket, mantendo o link. Só com --allow-replace ou --allow-delete. Precisa do Aktar para Mac 0.14.0 ou Windows 0.7.0.
create_short_linkCria um link curto para um envio com o encurtador do destino, ou devolve o que ele já tem. Fica de fora com --read-only. Precisa do Aktar para Mac 0.17.0 ou Windows 0.10.0.
search_uploadsPesquisa o histórico de envios.
list_destinationsLista os destinos e os tipos de arquivo para os quais cada um é usado.
list_bucketLista as pastas e os arquivos de um bucket, inclusive arquivos não enviados pelo Aktar.
create_temporary_linkCria um link que deixa de funcionar depois de um tempo (uma URL pré-assinada). Qualquer pessoa com ele pode baixar o arquivo até lá, mesmo de um bucket privado. No máximo 60 minutos, a menos que --max-link-minutes permita mais.
get_thumbnailMostra ao agente uma prévia de um envio. Precisa do Aktar para Mac 0.13.0 ou Windows 0.6.0.
list_watched_foldersLista as pastas monitoradas e o status delas.
get_statusVerifica a conexão com o Aktar.
delete_uploadApaga um envio do bucket. Só com --allow-delete.

Você decide no que ele pode mexer

Um envio fica público para qualquer pessoa com o link, então o servidor começa com pouco e você decide o que acrescentar.

  • Enviar é publicar

    O agente é instruído a enviar só o que você pediu para compartilhar, e os agentes perguntam antes de chamar uma ferramenta que envia. --log mantém um registro de cada chamada de ferramenta, para você ver depois o que um agente fez.
  • Só das suas pastas, nunca segredos

    Os arquivos vêm só das pastas que você indicar com --root, ou da pasta em que o agente inicia o servidor, nunca da sua pasta pessoal inteira por acidente. Chaves SSH e privadas, arquivos .env, credenciais de nuvem, perfis de navegador e bancos de dados de senhas são recusados onde quer que estejam, inclusive por links simbólicos.
  • Nada é sobrescrito sem você dizer

    Substituir um arquivo só é oferecido com --allow-replace, e excluir com --allow-delete. --read-only deixa de fora toda ferramenta que grava. Links temporários duram no máximo 60 minutos, a menos que --max-link-minutes permita mais.
  • Suas chaves ficam no Aktar

    O servidor conversa com o Aktar em 127.0.0.1 e verifica que é mesmo o Aktar antes de enviar o seu token. O agente nunca vê suas chaves de acesso, e nada passa por um servidor nosso.
aktar mcp
aktar mcp --root ~/Projects --root ~/Desktop --allow-replace
aktar mcp --root ~/Projects --read-only
aktar mcp --root ~/Projects --log ~/aktar-mcp.log

Sem MCP? Use a skill

Para agentes que usam skills mas não MCP, o aktar skill imprime um SKILL.md que os ensina o comando aktar: o que executar, como ler o --json e a enviar só o que você pediu. Todos os comandos estão na documentação do CLI.

mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.md

Requisitos

  • Aktar para Mac ou Windows, aberto, com pelo menos um destino
  • O comando aktar 0.4.0 ou mais recente (Node.js 18 ou mais recente). O aktar 0.6.0 e mais recentes precisam do Aktar para Mac 0.18.0 ou Windows 0.11.0
  • Um agente que execute servidores MCP via stdio
  • Substituir arquivos: Aktar para Mac 0.14.0 ou Windows 0.7.0. Miniaturas: Mac 0.13.0 ou Windows 0.6.0
  • Código aberto (MIT) no GitHub, listado no MCP Registry oficial

Perguntas

Funciona com o ChatGPT ou com outros agentes no navegador?

Ainda não. O servidor roda no seu computador, ao lado do Aktar, e conversa com os agentes via stdio, então funciona com agentes que rodam no seu computador: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf e outros.

O agente pode enviar arquivos que eu não pedi?

Ele só pode chamar as ferramentas que você permitir, e os agentes perguntam antes de chamar uma ferramenta que envia, a menos que você diga o contrário. Os arquivos só vêm das pastas que você indicar com --root (ou da pasta em que o agente o inicia), e segredos como chaves SSH e arquivos .env nunca são enviados. --read-only desliga os envios, e --log mostra depois o que foi chamado.

Para qual bucket ele envia?

O mesmo de um arquivo solto na barra de menus do Aktar: o destino cujo Usar para corresponde ao tipo de arquivo, ou o selecionado. Indique um destino no seu pedido e o agente usa esse.

Tem algum custo?

Não. O Aktar, o CLI e o servidor MCP são gratuitos. Você paga ao seu provedor de armazenamento pelo bucket, como de costume.

Funciona no Windows?

Sim. O comando aktar funciona com o Aktar para Windows da mesma forma, e todos os agentes acima também.