Composio
천 개 넘는 앱을 에이전트 도구로 붙이는 플랫폼
npm install @composio/core에이전트에 외부 SaaS 도구를 붙이는 플랫폼입니다. 사용자별 인증 세션을 만들어 두면 에이전트가 그 권한으로 앱을 조작합니다. OAuth 처리와 도구 검색, 스키마 정리를 대신 맡아 통합 코드를 줄입니다.
판단
이럴 때 씁니다
- 에이전트가 여러 SaaS 앱을 조작해야 하는데 OAuth 처리를 직접 만들기 부담될 때
- 사용자마다 다른 계정 권한으로 도구를 실행해야 할 때
- 붙일 앱이 계속 늘어나 통합 코드가 감당이 안 될 때
- 여러 에이전트 프레임워크에서 같은 도구 집합을 쓰고 싶을 때
이럴 땐 쓰지 마세요
- 붙일 앱이 한둘뿐이라 직접 만드는 편이 빠를 때
- 외부 플랫폼에 인증 세션을 맡기기 어려운 보안 정책이 있을 때
- 완전한 오프라인 환경일 때
차별점
- 천 개 넘는 앱 연동을 준비된 도구로 제공합니다.
- 사용자별 인증 세션을 만들어 그 권한으로 도구를 실행합니다.
- 도구 검색과 컨텍스트 관리 기능을 함께 제공합니다.
- 여러 에이전트 프레임워크용 어댑터를 갖췄습니다.
워크플로
- 01npm 으로 코어 패키지와 쓰는 프레임워크용 어댑터를 설치합니다.
- 02대시보드에서 API 키를 받고 사용할 앱 연결을 설정합니다.
- 03사용자별 세션을 만들어 그 권한으로 도구 목록을 가져옵니다.
- 04가져온 도구를 에이전트에 넘겨 실제 작업을 실행하게 합니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install @composio/core | 코어 패키지를 설치합니다. 프레임워크별 어댑터는 따로 설치합니다. |
함정
설치 전에 확인하세요
- 핵심 기능이 호스팅 플랫폼과 API 키에 묶여 있습니다. 저장소가 오픈소스라고 해서 전부 자체 운영할 수 있는 것은 아닙니다.
- 패키지가 여러 개로 나뉘어 있고 릴리스 태그가 패키지별로 붙습니다. 저장소 릴리스 목록만 보면 버전을 오해하기 쉽습니다.
- 도구를 많이 붙일수록 모델에 넘기는 스키마가 커집니다. 필요한 도구만 골라 넘기는 편이 좋습니다.
비교
MCP 서버를 앱마다 붙이는 방식과 목적이 겹칩니다. MCP 는 프로토콜 표준을 따르고 자체 운영이 쉬운 대신 앱별 서버를 각각 챙겨야 합니다. Composio 는 인증과 카탈로그를 대신 맡아 주는 대신 플랫폼 의존이 생깁니다. 붙일 앱 수가 판단 기준입니다.
최근 변경
저장소는 여러 패키지를 한곳에서 관리하며 changesets 로 배포합니다. 코어 패키지의 현재 버전은 0.18.1 이고, 저장소 릴리스 목록에는 예제 패키지 태그가 함께 올라와 최신 태그가 코어 버전과 다르게 보일 수 있습니다.