Cursor용 Aktar
Cursor에서 내 버킷으로 파일 업로드
Cursor에 Aktar를 추가하면 에이전트가 이미지와 파일을 내 S3, Cloudflare R2 또는 Backblaze B2 버킷에 업로드하고, 임시 링크를 만들고, 버킷 안을 살펴볼 수 있습니다. 내 컴퓨터의 Aktar 앱과 함께 실행되므로 스토리지 키는 Aktar 밖으로 나가지 않습니다.
설정하기getaktar/cliv0.6.0
public/og-image.png를 업로드하고 그 URL을 og:image 메타 태그에 써 줘.
upload_file{ "path": "public/og-image.png" }업로드했습니다. og:image 태그에 이 URL을 넣었습니다:
https://files.example.com/2026/11/og-image.png이렇게 요청해 보세요
-
문서와 변경 내역에 넣을 이미지
“docs/에 있는 스크린샷을 업로드하고 CHANGELOG.md에 링크를 걸어 줘.”
에이전트가 이미지를 하나씩 업로드하고 알맞은 위치에 링크를 씁니다. 이미지 변환과 정리는 대상 설정에 따라 Aktar가 처리합니다.
도구:
upload_file -
만료되는 링크
“Builds 버킷에 있는 backup.sql의 30분짜리 링크를 줘.”
버킷에 있는 어떤 파일이든 사전 서명된 링크를 만듭니다. 비공개 버킷이나 기간을 정해 공유할 때 좋습니다. 버킷은 전혀 바뀌지 않으며, 더 길게 허용하지 않는 한 링크는 최대 60분 동안 유효합니다.
도구:
create_temporary_link -
버킷 안 살펴보기
“Downloads 버킷의 releases 폴더에 뭐가 있어?”
Aktar로 올리지 않은 파일까지 포함해 폴더와 파일을 나열합니다.
도구:
list_bucket
설정하기
Mac 또는 Windows용 Aktar를 설치하고 대상(내 버킷)을 추가합니다. Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켠 다음 토큰을 복사해 이 명령어에 붙여 넣으세요. Node.js 18 이상이 필요합니다.
npx @getaktar/cli login프로젝트에 다음 내용으로
.cursor/mcp.json을 만드세요.${workspaceFolder}는 프로젝트 폴더이므로 Aktar는 그 프로젝트의 파일만 업로드합니다..cursor/mcp.json에 추가{ "mcpServers": { "aktar": { "command": "npx", "args": ["-y", "@getaktar/cli", "mcp", "--root", "${workspaceFolder}"] } } }Cursor 설정을 열고 MCP 목록에서
aktar를 찾아 켜져 있는지 확인하세요. 그러면 에이전트가 Aktar 도구를 사용할 수 있습니다.
모든 프로젝트에서 Aktar를 쓰려면 같은 내용을 ~/.cursor/mcp.json에 넣고 ${workspaceFolder} 대신 /Users/you/Projects 같은 폴더를 쓰세요(Windows에서는 C:\\Users\\you\\Projects). 폴더를 더 허용하려면 --root와 폴더를 반복하세요.
폴더를 --root로 지정했기 때문에 클립보드에서 바로 업로드하는 기능은 빠집니다. 대신 에이전트에게 파일을 알려 주세요. 업로드를 교체하거나 삭제할 수 있게 하려면 인자에 --allow-replace나 --allow-delete를 추가하세요. Cursor가 npx를 시작하지 못하면 which npx로 나온 전체 경로를 command에 넣으세요.
접근할 수 있는 범위
파일은 서버가 사용할 수 있는 폴더에서만 가져오며, SSH 키, .env 파일, 클라우드 자격 증명 같은 비밀 정보는 절대 업로드되지 않습니다. 업로드 교체와 삭제는 직접 켜지 않는 한 꺼져 있습니다. 스토리지 키는 Aktar에 남고, 에이전트에게는 파일 이름과 링크만 돌아가며, 저희에게는 아무것도 전송되지 않습니다. 업로드한 파일은 링크를 가진 누구에게나 공개되므로, 공유하고 싶은 것만 요청하세요.
자세한 내용은 개인정보 처리방침에 있습니다. 모든 도구와 옵션은 MCP 서버 페이지에서 볼 수 있습니다.
자주 묻는 질문
Cursor가 내 스토리지 키를 받나요?
아니요. 키는 Aktar 앱에 남아 있습니다. 서버는 npx @getaktar/cli login이 나만 읽을 수 있는 파일에 저장하는 로컬 토큰만 사용하며, 127.0.0.1에서 Aktar와 통신합니다.
에이전트가 업로드하기 전에 물어보나요?
Cursor는 자동 실행을 켜 두지 않은 MCP 도구를 실행하기 전에 먼저 물어봅니다. 검색, 목록, 임시 링크는 보기만 하고, 업로드는 버킷을 바꿉니다.
모든 프로젝트에서 한 번에 쓸 수 있나요?
네. 대신 ~/.cursor/mcp.json에 설정을 넣고, --root 뒤에 업로드할 수 있는 폴더를 지정하세요.
Windows에서도 되나요?
네, Windows용 Aktar 0.11.0 이상에서 됩니다. Mac에서는 Mac용 Aktar 0.18.0 이상이 필요합니다.