Aktar
KO
다운로드다운로드

Claude Code용 Aktar

Claude Code에서 내 버킷으로 파일 업로드

Aktar 플러그인을 쓰면 Claude Code가 스크린샷, 빌드, PDF를 내 S3, Cloudflare R2 또는 Backblaze B2 버킷에 업로드하고 링크나 Markdown을 건네 줍니다. 내 컴퓨터의 Aktar 앱과 함께 실행되므로 스토리지 키는 Aktar 밖으로 나가지 않습니다.

설정하기getaktar/agent-pluginsv0.6.0

docs/images/settings.png를 업로드하고 README의 Settings 아래에 추가해 줘.

Aktar 호출됨upload_file{ "path": "docs/images/settings.png" }

업로드하고 README에 이미지를 추가했습니다:

https://files.example.com/2026/11/settings.png

이렇게 요청해 보세요

  • README나 PR에 넣을 이미지

    “docs/images에 있는 새 스크린샷을 PR 설명에 추가해 줘.”

    Claude가 이미지를 업로드하고 Markdown을 작성합니다. WebP 변환과 위치 정보 제거는 대상 설정에 따라 Aktar가 처리합니다.

    도구: upload_file

  • 빌드 공유하기

    “dist 폴더를 zip으로 묶어서 QA팀에 보낼 링크를 줘.”

    프로젝트에서 파일을 만들어 업로드합니다. 대상을 지정하지 않으면 메뉴 막대에 파일을 끌어다 놓을 때처럼 파일 형식에 따라 Aktar가 고릅니다.

    도구: upload_file

  • 예전 링크 찾기

    “지난주에 올린 로고 링크가 뭐였지?”

    Aktar의 업로드 기록에서 이름과 날짜로 검색합니다. 앱에서 직접 올린 파일도 포함됩니다.

    도구: search_uploads

설정하기

  1. Mac 또는 Windows용 Aktar를 설치하고 대상(내 버킷)을 추가합니다. Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켠 다음 토큰을 복사해 이 명령어에 붙여 넣으세요. Node.js 18 이상이 필요합니다.

    npx @getaktar/cli login

  2. Claude Code에서 Aktar 마켓플레이스를 추가하고 플러그인을 설치합니다. 그러면 모든 프로젝트에서 켜집니다.

    Claude Code에서
    /plugin marketplace add getaktar/agent-plugins
/plugin install aktar@aktar

  3. 프로젝트 폴더에서 Claude Code를 시작하고 /mcp를 실행하세요. aktar가 연결됨으로 표시되어야 합니다. 링크를 요청하면 Claude가 그 폴더의 파일을 업로드합니다.

플러그인은 고정된 버전의 @getaktar/cli를 npx로 실행하므로 aktar 명령어를 따로 설치할 필요가 없습니다. Claude에게 Aktar를 언제, 어떻게 쓸지 알려 주는 스킬도 함께 추가됩니다.

Claude Code가 실행된 폴더의 파일만 업로드합니다. 다른 폴더도 허용하거나 Claude가 업로드를 교체(--allow-replace)하거나 삭제(--allow-delete)할 수 있게 하려면, 플러그인 대신 MCP 서버 페이지의 안내대로 서버를 직접 추가하세요. Claude Desktop을 쓰나요? 설정 방법은 그곳에도 있습니다.

접근할 수 있는 범위

파일은 서버가 사용할 수 있는 폴더에서만 가져오며, SSH 키, .env 파일, 클라우드 자격 증명 같은 비밀 정보는 절대 업로드되지 않습니다. 업로드 교체와 삭제는 직접 켜지 않는 한 꺼져 있습니다. 스토리지 키는 Aktar에 남고, 에이전트에게는 파일 이름과 링크만 돌아가며, 저희에게는 아무것도 전송되지 않습니다. 업로드한 파일은 링크를 가진 누구에게나 공개되므로, 공유하고 싶은 것만 요청하세요.

자세한 내용은 개인정보 처리방침에 있습니다. 모든 도구와 옵션은 MCP 서버 페이지에서 볼 수 있습니다.

등록된 곳:Official MCP RegistryGlamamcpservers.org

자주 묻는 질문

플러그인이 내 스토리지 키를 받나요?

아니요. 키는 Aktar 앱에 남아 있습니다. 플러그인은 npx @getaktar/cli login이 나만 읽을 수 있는 파일에 저장하는 로컬 토큰만 사용하며, 127.0.0.1에서 Aktar와 통신합니다.

Claude가 업로드하기 전에 물어보나요?

네. Claude Code는 허용해 두지 않은 플러그인 도구를 호출하기 전에 먼저 물어봅니다. 검색과 목록은 보기만 하고, 업로드는 버킷을 바꿉니다.

어느 버킷에 업로드되나요?

Aktar 메뉴 막대에 파일을 끌어다 놓을 때와 같습니다. 파일 형식이 용도와 일치하는 대상, 또는 선택된 대상이 쓰입니다. 요청에 대상을 지정하면 Claude가 그 대상을 사용합니다.

Windows에서도 되나요?

네, Windows용 Aktar 0.11.0 이상에서 됩니다. Mac에서는 Mac용 Aktar 0.18.0 이상이 필요합니다.

다른 AI 도구