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.
npm install -g @getaktar/cli claude mcp add --scope user aktar -- aktar mcpDepois 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.
upload_file{ "path": "~/Desktop/checkout-bug.png" }Enviado para o seu destino Screenshots. Aqui está o Markdown para a issue:
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.
Instale o comando
aktare conecte-o ao Aktar. No Aktar, abra Ajustes > Integrações, ative Permitir conexões locais e copie o token; depois cole-o noaktar login.npm install -g @getaktar/cli aktar loginAdicione o Aktar ao seu agente. O agente inicia o
aktar mcpsozinho quando precisar.Claude Code
Um comando, para todos os projetos. Confira com
/mcpno Claude Code.claude mcp add --scope user aktar -- aktar mcpCodex
Um comando; ele vai para
~/.codex/config.toml.codex mcp add aktar -- aktar mcpClaude 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.jsonde 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.
| Ferramenta | O que faz |
|---|---|
upload_file | Envia um arquivo e devolve o link, o Markdown e o HTML. Destino, nome, pasta e expiração são opcionais. |
upload_clipboard | Envia o arquivo ou a imagem da área de transferência. |
replace_file | Grava 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_uploads | Pesquisa o histórico de envios. |
list_destinations | Lista os destinos e os tipos de arquivo para os quais cada um é usado. |
list_bucket | Lista as pastas e os arquivos de um bucket, inclusive arquivos não enviados pelo Aktar. |
create_temporary_link | Cria um link que deixa de funcionar depois de um tempo (uma URL pré-assinada). |
get_thumbnail | Mostra ao agente uma prévia de um envio. Precisa do Aktar para Mac 0.13.0 ou Windows 0.6.0. |
list_watched_folders | Lista as pastas monitoradas e o status delas. |
get_status | Verifica a conexão com o Aktar. |
delete_upload | Apaga 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
--rootlimita os envios às pastas que você indicar. Os caminhos são resolvidos, inclusive links simbólicos, então um link para~/.sshou para um.envem outro lugar é recusado. -
Somente leitura e sem exclusão
--read-onlydeixa 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-onlySem 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.mdRequisitos
- Aktar para Mac ou Windows, aberto, com pelo menos um destino
-
O comando
aktar0.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.