AI 코딩 에이전트, 이제 도구는 필요 없다
원제 · AI Coding Agents Don't Need Tools Anymore
핵심 요약
미라지는 외부 서비스와 API를 가상 파일 시스템으로 추상화하여, AI 에이전트가 복잡한 도구 호출 과정 없이 친숙한 파일 명령어로 여러 플랫폼의 데이터를 효율적으로 처리할 수 있게 만든다.
하이라이트
미라지(Mirage)는 AI 에이전트가 Gmail, Notion, Slack, Google Drive 등의 외부 서비스를 코드베이스의 마크다운 파일처럼 읽고 쓸 수 있게 만드는 가상 파일 시스템이다.
기존의 MCP(Model Context Protocol)는 첨부 파일 내용을 읽지 못하거나 대용량 파일 다운로드 시 컨텍스트를 낭비하는 한계가 있지만, 미라지는 파일 시스템 기반으로 직접 복사하고 읽는다.
LLM은 수십 년간 다듬어진 유닉스 파일 시스템 인터페이스를 반복 학습을 통해 이미 완벽하게 이해하고 있으므로 추가적인 토큰 오버헤드나 학습 과정이 발생하지 않는다.
macOS 환경에서 미라지를 실행하기 위해 타사 파일 시스템을 지원하는 MacFuse 라이브러리와 시스템 확장 프로그램 설정이 필요하다.
미라지는 데몬 프로세스를 통해 여러 작업 공간을 영구적으로 유지하고 표준 HTTP 서버로 호스팅하여 다양한 기기에서 파일 시스템 지식 베이스로 활용할 수 있다.
타임라인
가상 파일 시스템 미라지의 개념과 필요성
기존의 MCP 도구 방식은 에이전트가 도구 호출 순서를 계획하고 불필요한 토큰을 소모하게 만든다. 반면 50년 동안 다듬어진 유닉스 파일 시스템은 LLM이 이미 완벽하게 이해하고 있는 인터페이스이므로 여러 서비스에 걸쳐 에이전트가 목적을 잃지 않고 작업할 수 있는 유일한 추상화를 제공한다.
- 미라지는 AI 에이전트가 컴퓨터 내 폴더에 접근하듯 외부 서비스에 접근할 수 있게 만드는 가상 파일 시스템이다.
- LLM에게 맞춤형 도구를 제공하는 방식은 매번 새로운 사용법을 학습해야 하는 토큰 오버헤드를 발생시킨다.
- 파일 시스템 인터페이스는 모든 LLM이 사전 학습 과정에서 수십억 번 접해온 표준화된 구조이다.
기존 MCP의 한계와 미라지의 파일 처리 방식
이메일 첨부 파일이나 대용량 파일을 다룰 때 기존 MCP는 앞을 보지 못하는 상태와 다를 바 없이 작동한다. 미라지는 모든 데이터를 파일 시스템상의 실제 파일로 다루기 때문에, 대용량 파일도 응답 제한이나 컨텍스트 낭비 없이 bash 명령어를 통해 직접 복사하고 활용할 수 있다.
- 기존 Gmail MCP는 첨부 파일 이름을 볼 수만 있고 실제 내용을 읽지 못하는 치명적인 한계가 있다.
- Google Drive MCP는 작은 파일 다운로드에도 문자열 디코딩과 기록 과정을 거쳐 4분 이상의 시간과 컨텍스트를 낭비한다.
- 미라지를 사용하면 이메일 첨부 파일이나 드라이브 파일을 실제 파일처럼 직접 읽고 bash 복사 명령어로 로컬에 곧바로 가져올 수 있다.
macOS 설치 과정과 도구 마운트 설정
소스 코드를 시스템에 복제한 뒤 Claude의 안내를 받아 설치 과정을 진행한다. MacFuse는 시스템 확장 프로그램이므로 설치 과정에서 맥 재시작이 필요하며, 이로 인해 유실될 수 있는 채팅 세션은 슬래시 명령어로 이름을 바꾸거나 이전 기록을 다시 불러오는 방식으로 보완해야 한다.
- macOS에서 미라지를 실행하려면 타사 파일 시스템을 지원하는 MacFuse 라이브러리를 설치해야 한다.
- 시스템 확장 프로그램 설정과 보안 구성 변경으로 인해 맥을 재시작해야 하므로 기존 채팅 세션 관리가 필요하다.
- 설정 완료 후 타입스크립트 파일과 Google Cloud Console 등을 통해 자격 증명을 추가하고 터미널에서 마운트 명령어를 실행한다.
백그라운드 데몬 실행과 확장성
모든 도구의 백엔드 API를 파일 시스템 구조로 변환함으로써 Google Chat, Notion, Slack 등 다양한 서비스를 하나의 디렉토리 안에서 통합 관리할 수 있다. 데몬을 통해 작업 공간이 영구적으로 유지되며 표준 HTTP 서버로 작동하므로 다양한 성능의 하드웨어 환경으로 유연하게 전환할 수 있다.
- 파일 시스템 내부에서 bash 명령어를 조합하여 서로 다른 MCP 도구들의 기능을 파이프라인 형태로 연결할 수 있다.
- 미라지는 데몬 프로세스를 통해 재시작 후에도 캐시와 인덱스를 유지하며 여러 작업 공간을 동시에 실행한다.
- 표준 HTTP 서버 구조를 갖추고 있어 로컬 기기뿐만 아니라 어디서나 호스팅하여 파일 시스템 지식 베이스로 쓸 수 있다.
설명
AI coding agents just got a new abstraction. Mirage mounts Gmail, Notion, and Drive as folders your agent reads with bash, no ai coding tools overhead. Works with Claude Code, Codex, and any best ai for coding setup. Learn how to use Claude Code with virtual filesystems. Try ChatLLM from Abacus AI: https://chatllm.abacus.ai/aib Access ChatGPT, Claude, Gemini, image generation, AI agents, and 100+ models in one place. What Mirage Does Mirage mounts Gmail, Notion, Google Drive, Slack, and Telegram as local folders. Your agent navigates them like any other directory. Standard bash commands work across every connected service: grep, cat, cp, ls. Email attachments and Drive files become readable local files, so there's no manual context loading. Pipelines chain operations across multiple services in a single command without bloating the context window. Why This Beats Tool Calls Every LLM learned file operations during training, so there's no token overhead teaching it new APIs on the fly. Bash pipelines keep intermediate results out of context, unlike chained tool calls that dump everything back into the conversation. Unix has refined this abstraction for 50 years, and agents inherit that reliability. The whole thing runs as a persistent background daemon across sessions and machines through a standard HTTP server. Setup Clone the repo, open Claude Code inside it, and let the agent handle the install. Mac users need the MacFUSE system extension and a one-time security restart. Each service authenticates separately through Google Cloud Console or OAuth. Named background workspaces can run on any server for multi-machine setups. What You Can Build Gmail-to-Notion pipelines that find sponsor emails, extract the content, and write summaries to Notion pages automatically. Cross-service search that greps across Gmail, Drive, and Slack in one bash command. Large file handling that copies Drive files straight to local disk without hitting response limits. Any service with an API can be mounted as a directory. Time-Stamps 00:00 - Mirage: virtual file system for AI agents 00:50 - Why file systems beat MCP tools 01:38 - Mounting Gmail to Mirage 02:04 - Sponsor 03:09 - Reading email attachments 03:50 - Predefined tools: Notion, Slack, Drive 04:18 - Google Drive downloads vs MCP 05:01 - Installation and macFUSE setup 06:27 - Auth and mounting connectors 07:21 - Bash pipelines and code mode 08:20 - Custom file systems (Figma, Google Chat) 09:18 - Persistent workspaces with the daemon 10:14 - Self-hosting Mirage #ai #ClaudeCode #ChatGPT #vibeCoding #aiAutomation #aiAgent #Cursor #coding#cursorAI #webDevelopment #vibeCode