--log는 모든 도구 호출을 기록하므로, 에이전트가 무엇을 했는지 나중에 확인할 수 있습니다.- 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 등은 아래에 있습니다.
바탕화면에 있는 checkout-bug 스크린샷을 업로드하고 이슈에 붙일 Markdown 링크를 줘.
Aktar 호출됨 · upload_file
Screenshots 대상에 업로드했습니다. 이슈에 붙일 Markdown입니다:
두 단계로 설정하기
업로드는 Mac 또는 Windows용 Aktar가 하므로, 에이전트와 같은 컴퓨터에서 실행 중이어야 합니다.
aktar 명령어를 설치하고 Aktar에 연결합니다. Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켠 다음 토큰을 복사해 aktar login에 붙여 넣으세요.
npm install -g @getaktar/cli
aktar login에이전트에 Aktar를 추가하고, --root 뒤에 파일을 업로드할 수 있는 폴더를 지정합니다(폴더가 더 있으면 반복). 에이전트는 필요할 때 aktar mcp를 알아서 시작합니다.
Claude Code
명령어 하나로 모든 프로젝트에 적용됩니다. ~/Projects는 작업 폴더로 바꾸세요. Claude Code에서 /mcp로 확인하세요.
claude mcp add --scope user aktar -- aktar mcp --root ~/ProjectsCodex
명령어 하나면 되고, ~/.codex/config.toml에 저장됩니다.
codex mcp add aktar -- aktar mcp --root ~/ProjectsVS Code
명령어 하나로 VS Code 프로필에 추가됩니다. 이후 Copilot의 에이전트 모드에 Aktar 도구가 나타납니다.
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp","--root","/Users/you/Projects"]}'Cursor
이 파일에 추가하거나, 한 프로젝트에만 쓰려면 .cursor/mcp.json에 추가하세요.
Claude Desktop
Settings > Developer > Edit Config를 열어 아래 내용을 추가하고 Claude Desktop을 다시 시작하세요.
Windsurf
이 파일에 추가한 뒤 Windsurf 설정에서 MCP 서버를 새로 고치세요.
앱이 aktar를 찾지 못한다고 하면 which aktar로 나온 전체 경로를 command에 넣으세요. 데스크톱 앱은 셸의 PATH를 항상 불러오지는 않습니다. 전역 설치를 하지 않았다면 command에 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_fileREADME나 이슈에 넣을 이미지
“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 도구별 단계별 안내
바로 쓸 수 있는 플러그인이나 복사해 쓰는 설정, 그리고 설정한 뒤 요청할 수 있는 것들을 모았습니다.
에이전트가 쓰는 도구
검색, 목록, 임시 링크, 썸네일은 보기만 합니다. 업로드는 버킷을 바꾸므로, 허용해 두지 않는 한 에이전트가 사용 전에 먼저 물어봅니다. 교체와 삭제는 직접 켰을 때만 제공됩니다.
| 도구 | 기능 |
|---|---|
| upload_ | 파일을 업로드하고 링크, Markdown, HTML을 반환합니다. 대상, 이름, 폴더, 만료는 선택 사항입니다. short로 짧은 링크를 요청하거나 만들지 않게 할 수 있습니다. |
| upload_ | 클립보드의 파일이나 이미지를 업로드합니다. short로 짧은 링크를 요청하거나 만들지 않게 할 수 있습니다. --root를 지정하면 제공되지 않습니다. |
| replace_ | 업로드나 버킷의 아무 파일을 새 파일로 덮어쓰면서 링크는 그대로 유지합니다. --allow-replace 또는 --allow-delete를 지정할 때만 제공됩니다. Mac용 Aktar 0.14.0 또는 Windows용 0.7.0이 필요합니다. |
| create_ | 대상의 링크 단축기로 업로드의 짧은 링크를 만들거나 이미 있는 링크를 돌려줍니다. --read-only에서는 제공되지 않습니다. Mac용 Aktar 0.17.0 또는 Windows용 0.10.0이 필요합니다. |
| search_ | 업로드 기록을 검색합니다. |
| list_ | 대상 목록과 각 대상이 어떤 파일 형식에 사용되는지 보여 줍니다. |
| list_ | Aktar로 업로드하지 않은 파일을 포함해 버킷의 폴더와 파일을 보여 줍니다. |
| create_ | 일정 시간이 지나면 작동하지 않는 링크(presigned URL)를 만듭니다. 그때까지는 링크를 가진 누구나 비공개 버킷에서도 파일을 내려받을 수 있습니다. --max-link-minutes로 늘리지 않는 한 최대 60분입니다. |
| get_ | 에이전트에 업로드의 미리보기를 보여 줍니다. Mac용 Aktar 0.13.0 또는 Windows용 0.6.0이 필요합니다. |
| list_ | 감시 폴더와 그 상태를 보여 줍니다. |
| get_ | Aktar와의 연결을 확인합니다. |
| delete_ | 버킷에서 업로드를 삭제합니다. --allow-delete를 지정했을 때만 제공됩니다. |
접근 범위는 내가 정합니다
업로드한 파일은 링크를 가진 누구에게나 공개되므로, 서버는 최소한의 기능으로 시작하고 무엇을 더할지는 내가 정합니다.
업로드는 곧 공개
에이전트는 공유하라고 요청한 파일만 업로드하도록 안내받고, 업로드하는 도구를 호출하기 전에 먼저 물어봅니다.지정한 폴더에서만, 비밀 정보는 제외
파일은--root로 지정한 폴더나 에이전트가 서버를 시작한 폴더에서만 가져오며, 실수로 홈 폴더 전체가 대상이 되는 일은 없습니다. SSH 키와 개인 키,.env파일, 클라우드 자격 증명, 브라우저 프로필, 비밀번호 데이터베이스는 심볼릭 링크를 포함해 어디에 있든 거부됩니다.허락 없이는 덮어쓰지 않음
파일 교체는--allow-replace, 삭제는--allow-delete를 지정할 때만 제공됩니다.--read-only는 쓰기 도구를 모두 제외합니다. 임시 링크는--max-link-minutes로 늘리지 않는 한 최대 60분 동안 유효합니다.키는 Aktar 안에만
서버는 127.0.0.1의 Aktar와 통신하며, 토큰을 보내기 전에 상대가 정말 Aktar인지 확인합니다. 에이전트는 액세스 키를 볼 수 없고, 어떤 데이터도 Aktar의 서버를 거치지 않습니다.
MCP가 없다면 스킬을 쓰세요
스킬은 쓰지만 MCP는 쓰지 않는 에이전트에는 aktar skill이 aktar 명령어를 가르쳐 주는 SKILL.md를 출력합니다. 무엇을 실행할지, --json을 어떻게 읽을지, 요청한 것만 업로드하라는 내용이 담겨 있습니다. 모든 명령어는 CLI 문서에 있습니다.
mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.md요구 사항
- 대상이 하나 이상 있고 실행 중인 Aktar for Mac 또는 Windows
-
aktar명령어 0.4.0 이상(Node.js 18 이상). aktar 0.6.0 이상에는 Aktar for Mac 0.18.0 또는 Windows 0.11.0이 필요 - stdio로 MCP 서버를 실행하는 에이전트
- 파일 교체: Aktar for Mac 0.14.0 또는 Windows 0.7.0. 썸네일: Mac 0.13.0 또는 Windows 0.6.0
- GitHub에 공개된 오픈 소스(MIT)이며 공식 MCP Registry에 등록되어 있습니다
자주 묻는 질문
ChatGPT나 브라우저 안의 다른 에이전트에서도 쓸 수 있나요?
요청하지 않은 파일도 에이전트가 업로드할 수 있나요?
--root로 지정한 폴더(또는 에이전트가 서버를 시작한 폴더)에서만 가져오며, SSH 키나 .env 파일 같은 비밀 정보는 절대 업로드되지 않습니다. --read-only는 업로드를 끄고, --log로는 무엇이 호출되었는지 나중에 확인할 수 있습니다.어느 버킷에 업로드되나요?
비용이 드나요?
Windows에서도 되나요?
aktar 명령어는 Aktar for Windows와도 똑같이 동작하고, 위에 나온 모든 에이전트에서도 마찬가지입니다.