Connect (연결)은(는) 무엇을 하나요?
Claude를 모든 앱에 연결하세요. 할 수 있는 일에 대한 텍스트 생성을 멈추고 실제로 실행하세요.
이 스킬을 사용해야 할 때
다음과 같은 경우 이 스킬을 사용하세요:
- 이메일 보내기 (초안 작성 대신)
- 이슈 만들기 (설명 대신)
- 메시지 게시하기 (제안 대신)
- 데이터베이스 업데이트 (설명 대신)
무엇이 달라지나
| Connect 없음 | Connect 있음 |
|---|---|
| "이메일 초안입니다..." | 이메일 전송 |
| "이슈를 만들어야 합니다..." | 이슈 생성 |
| "Slack에 게시하세요..." | 게시 수행 |
| "Notion에 추가하세요..." | 추가 수행 |
지원 앱
1000개 이상의 통합 포함:
- 이메일: Gmail, Outlook, SendGrid
- 채팅: Slack, Discord, Teams, Telegram
- 개발: GitHub, GitLab, Jira, Linear
- 문서: Notion, Google Docs, Confluence
- 데이터: Sheets, Airtable, PostgreSQL
- CRM: HubSpot, Salesforce, Pipedrive
- 스토리지: Drive, Dropbox, S3
- 소셜: Twitter, LinkedIn, Reddit
설정
1. API 키 받기
platform.composio.dev에서 무료 키를 받으세요.
2. 환경 변수 설정
export COMPOSIO_API_KEY="your-key"
3. 설치
pip install composio # Python
npm install @composio/core # TypeScript
완료되었습니다. 이제 Claude가 모든 앱에 연결할 수 있습니다.
예시
이메일 보내기
[email protected]에 이메일 보내기 - 제목: "배포 완료!" 본문: "v2.0이 출시되었습니다. 문제가 있으면 알려주세요."
GitHub 이슈 만들기
내-조직/저장소 에 이슈 만들기: "모바일 타임아웃 버그" with label:bug
Slack에 게시하기
#engineering 채널에 게시: "배포 완료 - v2.4.0 출시"
체인 액션
이번 주에 "bug" 레이블이 있는 GitHub 이슈를 찾아서 요약한 후 #bugs Slack 채널에 게시해줘.
작동 방식
Composio Tool Router 사용:
- 요청 - Claude에게 작업을 요청합니다.
- 도구 라우터가 올바른 도구를 찾습니다 (1000개 이상 옵션).
- OAuth가 자동으로 처리됩니다.
- 액션 실행 후 결과를 반환합니다.
코드
from composio import Composio
from claude_agent_sdk.client import ClaudeSDKClient
from claude_agent_sdk.types import ClaudeAgentOptions
import os
composio = Composio(api_key=os.environ["COMPOSIO_API_KEY"])
session = composio.create(user_id="user_123")
options = ClaudeAgentOptions(
system_prompt="외부 앱에서 작업을 수행할 수 있습니다.",
mcp_servers={
"composio": {
"type": "http",
"url": session.mcp.url,
"headers": {"x-api-key": os.environ["COMPOSIO_API_KEY"]},
}
},
)
async with ClaudeSDKClient(options) as client:
await client.query("Send Slack message to #general: Hello!")
인증 흐름
앱을 처음 사용할 때:
이메일을 보내려면 Gmail 액세스 권한이 필요합니다.
여기에서 인증: https://...
완료되면 "연결됨"이라고 말해주세요.
연결은 이후에도 유지됩니다.
프레임워크 지원
| 프레임워크 | 설치 명령어 |
|---|---|
| Claude Agent SDK | pip install composio claude-agent-sdk |
| OpenAI Agents | pip install composio openai-agents |
| Vercel AI | npm install @composio/core @composio/vercel |
| LangChain | pip install composio-langchain |
| 모든 MCP 클라이언트 | session.mcp.url 사용 |
문제 해결
- 인증 필요 → 링크 클릭, 인증, "연결됨"이라고 말하기
- 액션 실패 → 대상 앱의 권한 확인
- 도구를 찾을 수 없음 → 구체적으로 지정: "메시지 보내기" 대신 "Slack #general"