AI 에이전트가 내 버킷에서 파일을 공유하게 하세요

이렇게 요청해 보세요

• 작업 중에 파일 공유하기

  “빌드를 zip으로 묶어서 QA팀에 보낼 링크를 줘.”

  에이전트가 파일을 만들어 업로드합니다. 대상을 지정하지 않으면 메뉴 막대에 파일을 끌어다 놓을 때처럼 파일 형식(각 대상의 용도)에 따라 Aktar가 고릅니다.

  도구: upload_file

• README나 이슈에 넣을 이미지

  “방금 복사한 스크린샷을 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

두 단계로 설정하기

1. aktar 명령어를 설치하고 Aktar에 연결합니다. Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켠 다음 토큰을 복사해 aktar login에 붙여 넣으세요.

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

2. 에이전트에 Aktar를 추가합니다. 에이전트는 필요할 때 aktar mcp를 알아서 시작합니다.

   Claude Code

   명령어 하나로 모든 프로젝트에 적용됩니다. Claude Code에서 /mcp로 확인하세요.

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

   Codex

   명령어 하나면 되고, ~/.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

   명령어 하나로 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의 서버를 거치지 않습니다.

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

자주 묻는 질문