다중 AI 에이전트를 위한 단일 게이트웨이, Magpie 소개
yetone/magpie
GitHubMagpie는 여러 AI 에이전트와 모델을 하나의 통합된 인터페이스에서 관리하는 데스크톱 애플리케이션입니다.
- 로컬 게이트웨이를 구축하여 OpenAI, Anthropic 등 다양한 외부 API를 단일 엔드포인트로 통일하고 복잡한 통신 과정을 처리합니다.
- 사용자는 개별 서비스에 로그인하거나 키를 관리할 필요 없이, 하나의 계정으로 여러 모델을 공유하며 사용할 수 있습니다.
- 단순 연결을 넘어, 복잡한 라우팅 그룹 설정이나 다중 인증 지원 등 고급 AI 워크플로우까지 구현 가능합니다.
Magpie는 사용자의 장치에 존재하는 모든 와 해당 모델을 한 화면에서 목록화하고 선택할 수 있도록 설계된 애플리케이션입니다. 이 앱은 메뉴 바 아이콘 클릭이나 일반 창으로 접근 가능하며, 터미널 버전(`magpie tui`)과 CLI를 통해 사용할 수 있습니다. 사용자는 이를 통해 Claude Code, Codex, Gemini CLI 등 다양한 에이전트의 모델을 하나의 인터페이스에서 관리할 수 있습니다.
Magpie는 로컬 게이트웨이를 구축하여 오픈AI 채팅 완료, 오픈AI 응답 및 앤트로픽 메시지 와 같은 여러 외부 API를 단일 엔드포인트(`http://127.0.0.1:3425/v1`)로 통일합니다. 이 게이트웨이는 에이전트들이 어떤 공급자를 사용하든 관계없이 내부적으로 다양한 API 간의 변환을 처리하며, 스트리밍 및 도구 호출 기능까지 지원하여 복잡한 연결 과정을 단순화합니다.
사용자는 여러 모델을 하나의 그룹으로 묶어(예: `group/<id>`) 요청을 보낼 수 있으며, 게이트웨이는 각 멤버의 키와 계정을 사용하여 요청을 라우팅합니다. 또한, Claude Code나 Codex처럼 OAuth로 로그인된 에이전트는 Magpie를 통해 프로바이더로 제공되어, 다른 모든 에이전트가 해당 모델을 사용할 수 있게 합니다. 이 과정에서 Magpie는 에이전트 자체의 인증 정보를 읽고 을 새로 고치며 관리합니다.
용어 풀이
- AI 에이전트
- 목표를 받으면 스스로 계획을 세우고 도구를 써서 여러 단계의 작업을 해내는 AI.
- API
- 프로그램끼리 기능을 주고받는 약속된 창구. AI 모델은 보통 API로 불러 써요.
- 토큰
- AI 모델이 글을 처리하는 단위. 단어보다 작은 조각이며 사용량과 요금을 셀 때 기준이 돼요.