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

こんなことを頼めます

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

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

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

  ツール: upload_file

• READMEやissue用の画像

  “いまコピーしたスクリーンショットをREADMEに追加して。”

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

  ツール: upload_file, upload_clipboard

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

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

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

  ツール: search_uploads, replace_file

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

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

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

  ツール: search_uploads, get_thumbnail

• 期限付きのリンク

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

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

  ツール: create_temporary_link

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

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

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

  ツール: list_bucket, list_destinations

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

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

   $ npm install -g @getaktar/cli
   $ aktar login

2. エージェントにAktarを追加します。必要になると、エージェントがaktar mcpを自動で起動します。

   Claude Code

   コマンド1つで、すべてのプロジェクトに追加できます。Claude Codeの/mcpで確認できます。

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

   Codex

   コマンド1つで、~/.codex/config.tomlに書き込まれます。

   $ codex mcp add aktar -- aktar mcp

   Claude Desktop

   Settings > Developer > Edit Configを開き、これを追加して、Claude Desktopを再起動します。

   claude_desktop_config.jsonに追加

   {
     "mcpServers": {
       "aktar": { "command": "aktar", "args": ["mcp"] }
     }
   }

   Cursor

   このファイル、または特定のプロジェクトの.cursor/mcp.jsonに追加します。

   ~/.cursor/mcp.jsonに追加

   {
     "mcpServers": {
       "aktar": { "command": "aktar", "args": ["mcp"] }
     }
   }

   VS Code

   コマンド1つでVS Codeのプロファイルに追加されます。CopilotのエージェントモードにAktarのツールが表示されます。

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

   Windsurf

   このファイルに追加し、Windsurfの設定でMCPサーバーを更新します。

   ~/.codeium/windsurf/mcp_config.jsonに追加

   {
     "mcpServers": {
       "aktar": { "command": "aktar", "args": ["mcp"] }
     }
   }

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

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

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

  エージェントには、共有を頼まれたものだけをアップロードするよう指示されており、アップロードするツールを呼ぶ前には確認します。

• 指定したフォルダーからだけ

  --rootで、アップロードを指定したフォルダーに限定します。シンボリックリンクも含めてパスが解決されるため、~/.sshへのリンクや、ほかの場所にある.envは拒否されます。

• 読み取り専用、削除なし

  --read-onlyを付けると、書き込みを伴うツールがすべて外れます。バケットからの削除は、--allow-deleteを付けない限り、そもそも提供されません。

• キーはAktarの中にとどまる

  サーバーは、トークンを使って127.0.0.1上でAktarと通信します。エージェントがアクセスキーを目にすることはなく、当社のサーバーを経由することもありません。

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

よくある質問