Servidor MCP

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.

1Instalar o CLI
npm install -g @getaktar/cli
2Adicionar ao Claude Code
claude mcp add --scope user aktar -- aktar mcp

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 Aktarupload_file{ "path": "~/Desktop/checkout-bug.png" }

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

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

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 captura de tela que acabei de copiar.”

    Ele envia a imagem, ou o que estiver na área de transferência, 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, upload_clipboard

  • 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.

    Ferramentas: search_uploads, replace_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_uploads, get_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_bucket, list_destinations

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.

  1. 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
  2. Adicione o Aktar ao seu agente. O agente inicia o aktar mcp sozinho quando precisar.

    Claude Code

    Um comando, para todos os projetos. Confira com /mcp no Claude Code.

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

    Codex

    Um comando; ele vai para ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

    Claude Desktop

    Abra Settings > Developer > Edit Config, adicione isto e reinicie o Claude Desktop.

    Em claude_desktop_config.json
    {
      "mcpServers": {
        "aktar": { "command": "aktar", "args": ["mcp"] }
      }
    }

    Cursor

    Adicione isto ao arquivo ou ao .cursor/mcp.json de um projeto.

    Em ~/.cursor/mcp.json
    {
      "mcpServers": {
        "aktar": { "command": "aktar", "args": ["mcp"] }
      }
    }

    VS Code

    Um comando o adiciona ao seu perfil do VS Code. O modo agente do Copilot passa então a listar as ferramentas do Aktar.

    code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp"]}'

    Windsurf

    Adicione isto ao arquivo e atualize os servidores MCP nos ajustes do Windsurf.

    Em ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "aktar": { "command": "aktar", "args": ["mcp"] }
      }
    }

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"] como argumentos. Qualquer outro agente que execute servidores MCP via stdio funciona da mesma forma.

Ferramentas que seu agente recebe

Pesquisar, listar, criar links temporários e ver miniaturas só leem. Enviar e substituir alteram o seu bucket, e seu agente pergunta antes de usá-los, a menos que você permita.

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.
upload_clipboardEnvia o arquivo ou a imagem da área de transferência.
replace_fileGrava um arquivo novo por cima de um envio, mantendo o link. Precisa do Aktar para Mac 0.14.0 ou Windows 0.7.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).
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 é cuidadoso por padrão e você pode restringi-lo ainda mais.

  • 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.

  • Só das suas pastas

    --root limita os envios às pastas que você indicar. Os caminhos são resolvidos, inclusive links simbólicos, então um link para ~/.ssh ou para um .env em outro lugar é recusado.

  • Somente leitura e sem exclusão

    --read-only deixa de fora toda ferramenta que grava. Excluir de um bucket nem é oferecido, a menos que você adicione --allow-delete.

  • Suas chaves ficam no Aktar

    O servidor conversa com o Aktar em 127.0.0.1 usando o seu token. O agente nunca vê suas chaves de acesso, e nada passa por um servidor nosso.

aktar mcp --root ~/Projects --root ~/Desktop
aktar mcp --read-only

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)
  • 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. Para ter certeza, inicie o servidor com --root para que só as pastas que você indicar possam ser enviadas, ou com --read-only.

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.