• MCPサーバー
  • aktar v0.6.0

AIエージェントに、自分のバケットから
ファイルを共有させよう

aktar mcpは、Claude、Cursor、VS Code、Codexなどのエージェントを Aktarアプリにつなぎます。リンクを頼むと、エージェントが自分のS3、Cloudflare R2、Backblaze B2バケットにファイルをアップロードし、URLやMarkdownを返します。ストレージのキーがAktarの外に出ることはありません。

そのあとaktar loginを一度実行します。Cursor、VS Code、Codexなどは下にあります。

デスクトップにあるチェックアウトのバグのスクリーンショットをアップロードして、issue用のMarkdownリンクをください。

Aktarを呼び出しました · upload_file

Screenshotsのアップロード先にアップロードしました。issue用のMarkdownはこちらです:

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

2ステップでセットアップ

アップロードを行うのはMac版またはWindows版のAktarなので、エージェントと同じコンピューターで起動しておく必要があります。

ステップ 01

aktarコマンドをインストールして、Aktarに接続します。Aktarで設定 → 連携を開き、ローカル接続を許可をオンにしてトークンをコピーし、aktar loginに貼り付けます。

npm install -g @getaktar/cli
aktar login
ステップ 02

エージェントにAktarを追加します。--rootの後に、ファイルのアップロード元にしてよいフォルダーを指定します(複数のフォルダーは繰り返して指定)。必要になると、エージェントがaktar mcpを自動で起動します。

Claude Code

コマンド1つで、すべてのプロジェクトに追加できます。~/Projectsは、作業しているフォルダーに変えてください。Claude Codeの/mcpで確認できます。

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

アプリがaktarを見つけられないと表示した場合は、which aktarで表示されるフルパスをcommandに指定してください。デスクトップアプリはシェルのPATHを読み込まないことがあります。グローバルインストールしていない場合は、コマンドにnpx、引数に["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"]を指定します。/Users/you/Projectsは自分のフォルダーに置き換えてください(WindowsではC:\\Users\\you\\Projectsのように)。--rootがない場合、ファイルはエージェントがサーバーを起動したフォルダーからだけ取得され、それがホームフォルダーやディスクの最上位の場合(デスクトップアプリではよくあります)は、どこからも取得されません。stdioでMCPサーバーを実行できるほかのエージェントでも、同じように使えます。

こんなことを頼めます

同僚に話しかけるように頼んでください。エージェントがツールを選び、Aktarがアップロード先ごとの設定でアップロードして、リンクが会話に返ってきます。

  • セッション中のファイルを共有

    “ビルドをzipにして、QAに送れるリンクをください。”

    エージェントがファイルを作ってアップロードします。アップロード先を指定しなければ、メニューバーへのドロップと同じように、Aktarがファイルの種類(各アップロード先の用途)で選びます。

    ツール:upload_file

  • READMEやissue用の画像

    “docs/imagesにある新しいスクリーンショットをREADMEに追加して。”

    画像をアップロードし、Markdownを適切な場所に書き込みます。WebPへの変換や位置情報の削除は、アップロード先の設定に従ってAktarが行います。

    ツール:upload_file

  • リンクはそのままでファイルを更新

    “先週共有したオンボーディングのPDFを、この新しいバージョンに置き換えて。”

    履歴からアップロードを見つけ、その上に新しいファイルを書き込みます。リンクを持つ全員に新しいバージョンが表示され、送り直す必要はありません。置き換えると古いファイルは上書きされるため、--allow-replaceが必要です。

    ツール:search_uploadsreplace_file

  • アップロードしたものを探す

    “月曜にアップロードした請求書のリンクはどれだっけ?”

    Aktarの履歴を名前と日付で検索し、サムネイルを見てスクリーンショット、写真、ドキュメントを見分けることもできます。

    ツール:search_uploadsget_thumbnail

  • 期限付きのリンク

    “Legalバケットにある契約書の30分間有効なリンクをください。”

    バケット内のどのファイルにも使える署名付きリンクで、プライベートバケットや期間限定の共有に便利です。バケットの中身は変わりません。

    ツール:create_temporary_link

  • バケットの中を見て回る

    “Buildsバケットのreleasesフォルダーには何が入ってる?”

    Aktarでアップロードしていないものも含めてフォルダーとファイルを一覧表示し、どのアップロード先がどの種類のファイルに使われるかも把握しています。

    ツール:list_bucketlist_destinations

使っているAIツール別のステップガイド

すぐに使えるプラグインやコピーできる設定と、セットアップ後に頼めることをまとめました。

掲載先:Official MCP RegistryGlamamcpservers.org

エージェントが使えるツール

検索、一覧表示、一時リンク、サムネイルは見るだけです。アップロードはバケットを変更するため、許可していない限り、エージェントは使う前に確認します。置き換えと削除は、自分でオンにしたときだけ提供されます。

ツールできること
upload_fileファイルをアップロードし、リンク、Markdown、HTMLを返します。アップロード先、名前、フォルダー、有効期限は省略できます。shortで短縮リンクの作成を指定、または抑止できます。
upload_clipboardクリップボードのファイルまたは画像をアップロードします。shortで短縮リンクの作成を指定、または抑止できます。--rootを指定すると提供されません。
replace_fileリンクを保ったまま、アップロード済みのファイルやバケット内の任意のファイルを新しいファイルで置き換えます。--allow-replaceまたは--allow-deleteを付けたときだけ提供されます。Aktar for Mac 0.14.0 または Windows 0.7.0 が必要です。
create_short_linkアップロード先の短縮サービスでアップロードの短縮リンクを作成するか、既存のものを返します。--read-onlyでは提供されません。Aktar for Mac 0.17.0 または Windows 0.10.0 が必要です。
search_uploadsアップロード履歴を検索します。
list_destinationsアップロード先と、それぞれが使われるファイルの種類を一覧表示します。
list_bucketバケット内のフォルダーとファイルを一覧表示します。Aktarでアップロードしていないファイルも含まれます。
create_temporary_link一定時間後に無効になるリンク(署名付きURL)を作成します。それまでは、リンクを知っていれば誰でも、非公開のバケットからでもファイルをダウンロードできます。--max-link-minutesで延ばさない限り最長60分です。
get_thumbnailアップロードしたもののプレビューをエージェントに見せます。Aktar for Mac 0.13.0 または Windows 0.6.0 が必要です。
list_watched_folders監視フォルダーとその状態を一覧表示します。
get_statusAktarへの接続を確認します。
delete_uploadバケットからアップロード済みのファイルを削除します。--allow-deleteを付けた場合のみ。

触れてよい範囲は自分で決める

アップロードしたファイルは、リンクを知っている誰にでも公開されます。そのためサーバーは最小限の機能で始まり、何を追加するかは自分で決められます。

  • アップロードは公開すること

    エージェントには、共有を頼まれたものだけをアップロードするよう指示されており、アップロードするツールを呼ぶ前には確認します。--logを使えばすべてのツール呼び出しが記録されるので、エージェントが何をしたかを後から確認できます。
  • 指定したフォルダーからだけ、秘密情報は対象外

    ファイルは、--rootで指定したフォルダーか、エージェントがサーバーを起動したフォルダーからだけ取得されます。うっかりホームフォルダー全体が対象になることはありません。SSH鍵や秘密鍵、.envファイル、クラウドの認証情報、ブラウザーのプロファイル、パスワードデータベースは、シンボリックリンク経由も含め、どこにあっても拒否されます。
  • 指示しない限り上書きしない

    ファイルの置き換えは--allow-replace、削除は--allow-deleteを付けたときだけ提供されます。--read-onlyを付けると、書き込みを伴うツールがすべて外れます。一時リンクの有効期限は、--max-link-minutesで延ばさない限り最長60分です。
  • キーはAktarの中にとどまる

    サーバーは127.0.0.1上でAktarと通信し、トークンを送る前に相手が本当にAktarかどうかを確認します。エージェントがアクセスキーを目にすることはなく、当社のサーバーを経由することもありません。
aktar mcp
aktar mcp --root ~/Projects --root ~/Desktop --allow-replace
aktar mcp --root ~/Projects --read-only
aktar mcp --root ~/Projects --log ~/aktar-mcp.log

MCPが使えない? スキルを使おう

スキルは使えてもMCPは使えないエージェント向けに、aktar skillがaktarコマンドの使い方を教えるSKILL.mdを出力します。何を実行し、--jsonをどう読み取り、頼まれたものだけをアップロードする、という内容です。すべてのコマンドはCLIドキュメントにあります。

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

必要なもの

  • Mac版またはWindows版のAktar(起動中で、アップロード先が1つ以上あること)
  • aktarコマンド0.4.0以降(Node.js 18以降)。aktar 0.6.0以降にはMac版Aktar 0.18.0またはWindows版0.11.0が必要
  • stdioでMCPサーバーを実行できるエージェント
  • ファイルの置き換え: Mac版Aktar 0.14.0またはWindows版0.7.0。サムネイル: Mac版0.13.0またはWindows版0.6.0
  • GitHubで公開されているオープンソース(MIT)で、公式のMCP Registryに掲載されています

よくある質問

ChatGPTや、ブラウザー上のほかのエージェントでも使えますか?

まだ使えません。サーバーはAktarと同じコンピューター上で動き、stdioでエージェントと通信するため、お使いのコンピューター上で動くエージェント(Claude Code、Claude Desktop、Cursor、VS Code、Codex、Windsurfなど)で使えます。

頼んでいないファイルをエージェントがアップロードすることはありますか?

エージェントが呼び出せるのは許可したツールだけで、特に指定しない限り、アップロードするツールを呼ぶ前に確認します。ファイルは--rootで指定したフォルダー(またはエージェントがサーバーを起動したフォルダー)からだけ取得され、SSH鍵や.envファイルのような秘密情報がアップロードされることはありません。--read-onlyを使うとアップロードはオフになり、--logを使えば何が呼び出されたかを後から確認できます。

どのバケットにアップロードされますか?

Aktarのメニューバーへのドロップと同じです。ファイルの種類に合った用途を持つアップロード先、または選択中のアップロード先が使われます。依頼の中でアップロード先を指定すれば、エージェントはそれを使います。

費用はかかりますか?

いいえ。Aktar、CLI、MCPサーバーは無料です。バケットの料金は、これまでどおりストレージのプロバイダーに支払います。

Windowsでも使えますか?

はい。aktarコマンドはWindows版のAktarでも同じように動き、上に挙げたエージェントもすべて使えます。