接続する
システムをユーザーのアプリに ツールゲートウェイ 経由で接続します。これは、各アプリを認可する単一の MCP サーバー（Composio）です。ステップごとに進め、次のステップに移る前にユーザーの確認を待ちます。
始める前に
opencode.jsonとmemory/wiki/conexiones.md（存在する場合）を読んでください。Composio が既に有効になっている場合は、ステップ 4 に進んでください。- 次に何を行うか、そして最小目標は 1つのアプリを接続すること であることを、1行で伝えてください。
ステップ 1 · アカウントとキー
ユーザー自身にブラウザで以下の操作を行ってもらいます。
- https://composio.dev にアクセスし、個人のGメール（大学のメールだと認証がブロックされる可能性があります）でアカウントを作成します。無料プランではクレジットカードは不要です。
- ダッシュボードで AI Clients を開き、consumer API key をコピーします。
チャットにキーを貼り付けないように伝えてください。 ここに書き込まれた内容は履歴に残る可能性があります。
ステップ 2 · キーをコンピューターに保存する
キーはリポジトリ外の環境変数に保存します。ユーザーのOSに応じたコマンドを伝え、別のターミナルで実行してもらいます。
# macOS / Linux (zsh); bash の場合は ~/.bashrc を使用
エクスポート 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 カレンダーを提案します）。Composio の接続管理ツールを使用して認証リンクを生成し、ユーザーに渡します。ユーザーがブラウザで認可し、チャットに戻ってくるのを待ちます。
簡単な読み取り操作 で確認します。今日のイベント、またはメールの最新 3 件を取得し、結果を表示します。
時間があれば、2 つ目のアプリでも繰り返します。
ステップ 5 · 記録する
memory/wiki/conexiones.md を作成または更新し、接続したアプリ、日付、使用目的を記録します。キーやメールアドレスは含めません。 memory/index.md からリンクします。
最後に次のように締めくくります：「/brief を実行して今日の概要を確認してください。」
プラン B · 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 が既に許可を求めている場合でも、ユーザーが明示的に承認するまでは、送信、作成、更新、削除を行うアクションを決して実行しないでください。
- リポジトリ内のファイルにキーを書き込まないでください。ユーザーがチャットにキーを貼り付けた場合は、ダッシュボードで再生成するよう伝えてください。
- 何かが 2 回失敗したら、止めて、何が失敗したかを伝え、プラン B を提案します。設定を場当たり的に変更しないでください。