AI Access — 어시스턴트를 위한 MCP 파일 도구
로컬 서버를 통해 Claude Code나 Gemini 같은 AI 어시스턴트에 mcp 파일 도구를 열어 줍니다 — 어시스턴트가 지시를 내리면 앱의 도구들이 파일 업로드 없이 디스크 위에서 직접 작업을 수행하는 구조입니다.
AI Access는 1FileTool을 로컬 MCP 서버로 만들어 AI 어시스턴트가 mcp 파일 도구 — 압축, 변환, 이름 변경, 가리기 등 — 를 자연어로 실행할 수 있게 하며 파일 업로드는 전혀 없습니다. 어시스턴트는 127.0.0.1로 지시를 보내고, 모든 작업은 머신의 앱 안에서 실행됩니다.
켜기
Settings › AI Access에 모든 설정이 있습니다:
- Allow AI assistant access를 켭니다. 상태 배지가 Listening으로 바뀝니다 — 서버는
127.0.0.1에만 바인딩해 네트워크에서 접근할 수 없습니다. - Your AI tools에서 Connect를 클릭합니다. 1FileTool이 감지된 클라이언트의 설정에
onefiletoolMCP 서버로 자신을 기록합니다 — Claude Code(~/.claude.json)와 Gemini CLI(~/.gemini/settings.json)는 원클릭입니다. - 새 서버를 인식하도록 CLI를 재시작합니다.
Codex CLI의 설정 파일은 현재 Codex 릴리스에서 같은 방식으로 적용되지 않으므로, Codex 및 다른 MCP 클라이언트는 Set up another client manually를 열고 Copy를 눌러 JSON 스니펫을 해당 클라이언트의 MCP 설정에 직접 붙여 넣으세요.
그다음 그냥 요청하세요 — 앱 자체의 예시: use 1filetool mcp to compress these images.
어시스턴트가 얻는 것
모두 filetool_ 접두사가 붙은 도구 열 개:
| 도구 | 용도 |
|---|---|
filetool_status | 앱 상태와 플랜 한도 |
filetool_list_operations | 64개 작업과 파라미터 전부 탐색 |
filetool_run | id로 아무 작업이나 실행 — 범용 도구 |
filetool_inspect | 파일을 바꾸지 않고 메타데이터 읽기 |
filetool_extract_text | PDF와 문서에서 텍스트 추출 |
filetool_compress_images / filetool_convert_images | 이미지 작업 |
filetool_compress_pdf / filetool_pdf_convert | PDF 작업 |
filetool_compress_video | 비디오 작업 |
편의 도구는 흔한 호출을 한 번에 커버하고, filetool_run은 나머지 전부에 닿습니다 — workflow_run_recipe를 통한 워크플로 레시피 포함.
가드레일
- 파괴적 작업은 먼저 묻습니다. 패턴 이름 변경이나 파쇄 같은 작업에는 Asks first 배지가 붙습니다 — 어시스턴트가
confirm: true를 보내야 하므로, 잘못 이해한 프롬프트로 에이전트가 파쇄하거나 대량 이름을 바꿀 수 없습니다. - 앱의 한도가 그대로 적용됩니다. MCP 실행은 버튼 클릭과 같은 허용량을 공유합니다: 무료 플랜은 하루 8개 파일, 일부 작업은 Pro 전용(예: 폴더 감시), 기기 내 AI는 미리보기로 실행됩니다. 한도에 닿으면 어시스턴트에게 알려집니다.
- 앱이 실행 중이어야 합니다. 서버는 1FileTool 안에 살고 있습니다 — 앱을 종료하면 연결도 함께 끊깁니다.
AI Chat과의 차이
AI Chat은 파일에 대해 이야기하는 앱 안의 채팅 창입니다. AI Access는 반대 방향입니다: 여러분은 자신의 터미널이나 편집기에 머물고, 어시스턴트가 앱에 들어와 도구를 실행합니다. 지시는 선을 넘지만 파일은 절대 넘지 않습니다.