Gemini CLI용 Aktar
Gemini CLI에서 내 버킷으로 파일 업로드
Aktar 확장 프로그램을 쓰면 Gemini CLI가 파일과 스크린샷을 내 S3, Cloudflare R2 또는 Backblaze B2 버킷에 업로드하고, 클립보드에 있는 것을 링크로 만들고, 예전에 올린 파일을 찾을 수 있습니다. 내 컴퓨터의 Aktar 앱과 함께 실행되므로 스토리지 키는 Aktar 밖으로 나가지 않습니다.
dist/report.pdf를 업로드하고 팀에 보낼 링크를 줘.
upload_file{ "path": "dist/report.pdf" }업로드했습니다. 링크입니다:
https://files.example.com/2026/11/report.pdf이렇게 요청해 보세요
-
파일 공유하기
“dist/report.pdf를 업로드하고 링크를 줘.”
Gemini가 프로젝트의 파일을 업로드합니다. 대상을 지정하지 않으면 메뉴 막대에 파일을 끌어다 놓을 때처럼 파일 형식에 따라 Aktar가 고릅니다.
도구:
upload_file -
복사한 것 업로드하기
“클립보드에 있는 스크린샷을 업로드해 줘.”
복사한 이미지나 파일을 Aktar가 업로드하고, 링크는 대화창으로 돌아옵니다.
도구:
upload_clipboard -
짧은 링크
“어제 올린 릴리스 노트의 짧은 링크를 만들어 줘.”
해당 업로드를 찾은 뒤, 그 대상에 설정한 단축 서비스로 짧은 링크를 만들어 달라고 Aktar에 요청합니다.
도구:
search_uploads,create_short_link
설정하기
Mac 또는 Windows용 Aktar를 설치하고 대상(내 버킷)을 추가합니다. Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켠 다음 토큰을 복사해 이 명령어에 붙여 넣으세요. Node.js 18 이상이 필요합니다.
npx @getaktar/cli login터미널에서 확장 프로그램을 설치합니다.
gemini extensions install https://github.com/getaktar/agent-plugins프로젝트 폴더에서
gemini를 시작하고, 물어보면 폴더를 신뢰하세요. Gemini CLI는 신뢰하지 않은 폴더에서는 MCP 서버를 시작하지 않습니다./mcp를 실행하면 Aktar 도구가 보입니다.
확장 프로그램은 고정된 버전의 @getaktar/cli를 npx로 실행하므로 aktar 명령어를 따로 설치할 필요가 없습니다. 업데이트는 gemini extensions update aktar로 합니다.
Gemini CLI가 실행된 폴더의 파일만 업로드합니다. 홈 폴더에서 시작하면 로컬 파일을 전혀 업로드하지 않으므로, 프로젝트 폴더에서 시작하세요.
접근할 수 있는 범위
파일은 서버가 사용할 수 있는 폴더에서만 가져오며, SSH 키, .env 파일, 클라우드 자격 증명 같은 비밀 정보는 절대 업로드되지 않습니다. 업로드 교체와 삭제는 직접 켜지 않는 한 꺼져 있습니다. 스토리지 키는 Aktar에 남고, 에이전트에게는 파일 이름과 링크만 돌아가며, 저희에게는 아무것도 전송되지 않습니다. 업로드한 파일은 링크를 가진 누구에게나 공개되므로, 공유하고 싶은 것만 요청하세요.
자세한 내용은 개인정보 처리방침에 있습니다. 모든 도구와 옵션은 MCP 서버 페이지에서 볼 수 있습니다.
자주 묻는 질문
확장 프로그램이 내 스토리지 키를 받나요?
아니요. 키는 Aktar 앱에 남아 있습니다. 확장 프로그램은 npx @getaktar/cli login이 나만 읽을 수 있는 파일에 저장하는 로컬 토큰만 사용하며, 127.0.0.1에서 Aktar와 통신합니다.
Gemini에 Aktar 도구가 보이지 않는 이유는 뭔가요?
대개 폴더를 신뢰하지 않았기 때문입니다. Gemini CLI는 신뢰하지 않은 폴더에서는 MCP 서버에 연결하지 않습니다. 그 폴더에서 gemini trust를 실행하거나 Gemini가 물어볼 때 신뢰한 다음, /mcp로 확인하세요.
Gemini가 업로드하기 전에 물어보나요?
네. 도구를 허용해 두었거나 Gemini CLI를 YOLO 모드로 시작한 경우만 빼고요. 검색과 목록은 보기만 하고, 업로드는 버킷을 바꿉니다.
Windows에서도 되나요?
네, Windows용 Aktar 0.11.0 이상에서 됩니다. Mac에서는 Mac용 Aktar 0.18.0 이상이 필요합니다.