앱 연결하기
Composio CLI를 사용하여 Claude를 1000개 이상의 앱에 연결하세요. 이메일을 실제로 보내고, 이슈를 생성하고, 메시지를 게시하세요. 단지 텍스트를 생성하는 것이 아닙니다.
빠른 시작
1단계: Composio CLI 설치
curl -fsSL https://composio.dev/install | bash
2단계: 로그인
composio login
composio whoami
인증을 위해 브라우저가 열리며, 기본 조직과 프로젝트를 선택하라는 메시지가 표시됩니다. 스크립트에서 프롬프트를 건너뛰려면 -y를 사용하세요.
3단계: 필요한 앱 연결
composio link gmail
composio link slack
composio link github
각 명령어는 OAuth 인증을 한 번 수행하며, 연결은 유지됩니다.
4단계: 사용해보기
composio execute GMAIL_SEND_EMAIL -d '{
"recipient_email": "[email protected]",
"subject": "Composio 테스트",
"body": "CLI에서 보내는 인사"
}'
이메일이 도착하면 연결이 완료된 것입니다.
할 수 있는 작업
| Claude에게 요청... | Claude가 실행하는 명령어 |
|---|---|
| "[email protected]에게 출시 관련 이메일 보내줘" | composio execute GMAIL_SEND_EMAIL -d '{...}' |
| "GitHub 이슈 생성: 로그인 버그 수정" | composio execute GITHUB_CREATE_ISSUE -d '{...}' |
| "Slack #general에 게시: 배포 완료" | composio execute SLACK_SEND_MESSAGE -d '{...}' |
| "Notion에 회의 노트 추가" | composio execute NOTION_CREATE_PAGE -d '{...}' |
핵심 워크플로우
- 도구 슬러그를 알고 있나요? →
composio execute <SLUG> -d '{...}' - 모르나요? →
composio search "원하는 것" - 입력값이 필요하나요? →
composio execute <SLUG> --get-schema또는--dry-run - 연결되지 않았나요? →
composio link <toolkit>후 재시도 - 다단계 작업인가요? → JS/TS 워크플로우는
composio run, 원시 API는composio proxy
지원되는 앱
이메일: Gmail, Outlook, SendGrid 채팅: Slack, Discord, Teams, Telegram 개발: GitHub, GitLab, Jira, Linear 문서: Notion, Google Docs, Confluence 데이터: Sheets, Airtable, PostgreSQL 그 외 1000개 이상...
유용한 명령어
# 도구 검색
composio search "github 이슈 생성"
composio tools list gmail
composio tools info GITHUB_CREATE_ISSUE
# 실행 전 검사 / 시험 실행
composio execute GITHUB_CREATE_ISSUE --get-schema
composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"버그"}'
# 병렬 실행
composio execute --parallel \
GMAIL_FETCH_EMAILS -d '{"max_results": 2}' \
GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'
# 다단계 워크플로우
composio run '
const issue = await execute("GITHUB_CREATE_ISSUE", {
owner: "acme", repo: "app", title: "버그", body: "..."
});
console.log(issue);
'
# 전용 도구가 없을 때 원시 API 호출
composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail
설정
환경 변수:
COMPOSIO_API_KEY- 비대화형 인증 자격 증명COMPOSIO_BASE_URL- 사용자 정의 API 엔드포인트COMPOSIO_SESSION_DIR- 아티팩트 저장 위치 재정의COMPOSIO_DISABLE_TELEMETRY=true- 텔레메트리 비활성화
글로벌 플래그: --log-level <all|trace|debug|info|warning|error|fatal|none>, --help.
문제 해결
로그인되지 않음→composio login실행<toolkit> 연결 필요→composio link <toolkit>실행- 알 수 없는 슬러그 →
composio search "<목표>"또는composio tools list <toolkit> - 잘못된 입력 →
composio execute <SLUG> --get-schema후--dry-run - 작업 실패 → 대상 앱의 권한 확인
전체 참조: docs.composio.dev/docs/cli