앱 연결 (Composio)

사용자의 Google Calendar, Gmail, GitHub, Notion, Drive 등의 외부 앱을 Composio를 통해 시스템에 연결하는 단계별 가이드입니다. 사용자가 "/conectar", "내 캘린더 연결", "내 메일 연결", "내 앱 연결하고 싶어", "Composio 설정" 등을 말하거나 에이전트에게 도구 접근 권한을 부여하는 방법을 물을 때 사용하세요.

앱 연결 (Composio)란 무엇인가요?

이 스킬은 AI 에이전트(OpenCode 등)가 Composio MCP 서버를 통해 사용자의 다양한 외부 앱(Google Calendar, Gmail, GitHub, Notion, Drive 등)에 안전하게 연결되고 상호작용할 수 있도록 설정하는 완전한 워크플로우를 제공합니다. 주요 목표는 최소 하나의 앱을 성공적으로 연결하는 것입니다. 스킬은 Composio 계정 생성 및 API 키 획득(Paso 1), API 키를 사용자 컴퓨터의 환경 변수에 안전하게 저장(Paso 2), OpenCode 설정 파일(opencode.json)에서 Composio MCP를 활성화(Paso 3), 첫 번째 앱 연결 및 권한 부여(Paso 4), 그리고 완료된 연결을 기록하고 확인(Paso 5)의 다섯 단계로 진행됩니다. 또한 MCP 연결이 실패할 경우 Composio CLI를 사용한 대체 방법(Plan B)도 제공합니다. 사용자 데이터 보호가 핵심 원칙이며, API 키가 저장소에 기록되지 않도록 하고, 모든 쓰기 작업은 사용자 승인을 받아야 합니다. 연결이 완료되면 사용자에게 "/brief" 명령어로 오늘 일정을 확인하도록 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓OpenCode

npx skills add https://github.com/rtovardev/rtovar-aios/tree/HEAD/.agents/skills/conectar

문서

연결

게이트웨이 도구를 통해 시스템을 사용자의 앱에 연결합니다: 각 앱을 승인하는 단일 MCP 서버(Composio). 한 번에 한 단계씩 진행하며, 다음 단계로 넘어가기 전에 사용자가 확인할 때까지 기다립니다.

시작하기 전에

opencode.json과 memory/wiki/conexiones.md(존재하는 경우)를 읽으십시오. Composio가 이미 활성화되어 있다면 4단계로 건너뜁니다.
사용자에게 한 줄로 무엇을 할 것인지, 그리고 최소 목표가 연결된 앱 하나임을 알립니다.

1단계 · 계정 및 키

사용자에게 브라우저에서 직접 다음을 수행하도록 요청합니다:

https://composio.dev 로 이동하여 개인 Gmail(대학 이메일은 인증을 차단할 수 있음)로 계정을 만듭니다. 무료 플랜은 카드 정보가 필요 없습니다.
대시보드에서 AI Clients를 열고 consumer API key를 복사합니다.

채팅에 키를 붙여넣으라고 요청하지 마십시오. 여기에 입력된 내용은 기록에 남을 수 있습니다.

2단계 · 키를 컴퓨터에 저장하기

키는 저장소 외부의 환경 변수에 저장됩니다. 사용자 시스템에 맞는 명령어를 알려주고, 다른 터미널에서 직접 실행하도록 합니다:

# macOS / Linux (zsh); bash는 ~/.bashrc 사용
echo 'export COMPOSIO_CONSUMER_KEY="여기에-키-붙여넣기"' >> ~/.zshrc && source ~/.zshrc

# Windows (PowerShell)
setx COMPOSIO_CONSUMER_KEY "여기에-키-붙여넣기"

Windows에서는 setx가 새 터미널에만 적용되므로, 터미널을 닫고 다시 열어야 합니다.

3단계 · Composio 활성화

허가를 구하고 opencode.json에서 mcp.composio 블록의 "enabled"를 true로 변경합니다. 다른 것은 변경하지 마십시오.

그런 다음 사용자에게 OpenCode를 닫고 이 폴더에서 새 터미널로 다시 열어 다음을 실행하도록 요청합니다:

opencode mcp list

Composio가 연결되어 있어야 합니다. 그렇지 않은 경우:

opencode mcp debug composio 명령어로 오류를 확인합니다.
키가 없다고 표시되면 환경 변수가 이 터미널에 설정되지 않은 것입니다: 2단계를 반복하고 새 터미널을 엽니다.

4단계 · 첫 번째 앱 연결

사용자가 돌아오면, 먼저 연결할 앱을 묻습니다(Google Calendar 추천). Composio의 연결 관리 도구를 사용하여 인증 링크를 생성하고, 사용자에게 제공한 후, 브라우저에서 인증을 완료하고 채팅으로 돌아올 때까지 기다립니다.

간단한 읽기로 확인합니다: 오늘의 일정, 또는 메일의 최근 세 항목. 결과를 사용자에게 보여줍니다.

시간이 남는다면 두 번째 앱에 대해 반복합니다.

5단계 · 기록

memory/wiki/conexiones.md 파일을 생성하거나 업데이트하여 연결된 앱, 날짜, 사용 목적을 기록합니다. 키나 이메일은 절대 기록하지 않습니다. memory/index.md에서 이 파일을 링크합니다.

다음과 같이 마무리합니다: «/brief를 실행하여 오늘 일정을 확인해보세요.»

대체 방법 · MCP 없이

MCP가 연결되지 않는 경우, Composio CLI를 동일하게 사용할 수 있습니다:

curl -fsSL https://composio.dev/install | sh   # 그런 다음 새 터미널 열기
composio login              # 아무 일도 없으면: composio logout 후 composio login --no-wait
composio link googlecalendar
composio search "list today's calendar events"
composio execute <SLUG> --dry-run -d '{...}'

규칙

쓰기 전에 읽어야 합니다. 연결 확인은 읽기 전용입니다.
OpenCode가 이미 허가를 요청하고 있더라도, 사용자가 명시적으로 승인하지 않은 보내기, 생성, 업데이트 또는 삭제 작업을 절대 실행하지 마십시오.
저장소 파일에 키를 절대 기록하지 마십시오. 사용자가 채팅에 키를 붙여넣으면, 대시보드에서 키를 다시 생성하라고 알립니다.
어떤 작업이 두 번 실패하면, 멈추고, 무엇이 실패했는지 알린 후 대체 방법을 제시합니다. 설정을 임의로 변경하지 마십시오.

앱 연결 (Composio)