connect

接続

Composio CLI を使って、Codex をあらゆるアプリに接続できます。できることについてのテキストを生成するのはやめて、シェルから実際に実行しましょう。

このスキルを使うタイミング

次のような操作を Codex に実行させたい場合に、このスキルを使います。

• メールを送信する：下書きを作るのではなく
• イシューを作成する：説明するのではなく
• メッセージを投稿する：提案するのではなく
• データベースを更新する：方法を説明するのではなく

変更点

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. Composio CLI をインストールする

curl -fsSL https://composio.dev/install | bash

2. ログインする

composio login
composio whoami

ブラウザーが開き、認証を行ってデフォルトの組織とプロジェクトを選択できます。自動化されたフローでプロンプトを省略するには、-y を使います。

3. 必要なツールキットをリンクする

composio link github
composio link gmail
composio link slack

各コマンドで OAuth を一度実行すると、その接続は維持されます。

これで完了です。Codex は、シェルから接続済みのあらゆるアプリを操作できるようになりました。

基本的なワークフロー

1. ツールのスラッグがわかっていますか？ → composio execute
2. スラッグがわかりませんか？ → composio search
3. 入力内容の確認が必要ですか？ → composio execute --get-schema または --dry-run
4. ツールキットが未接続ですか？ → composio link <toolkit> を実行して再試行します
5. 複数の手順が必要ですか？ → ワークフローには composio run、生の API 呼び出しには composio proxy を使います

例

ツールを検索する

composio search "create a github issue"
composio search "send an email" --toolkits 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":"Bug"}'

メールを送信する

composio execute GMAIL_SEND_EMAIL -d '{
  "recipient_email": "[email protected]",
  "subject": "Shipped!",
  "body": "v2.0 is live, let me know if issues"
}'

GitHub イシューを作成する

composio execute GITHUB_CREATE_ISSUE -d '{
  "owner": "my-org",
  "repo": "repo",
  "title": "Mobile timeout bug",
  "labels": ["bug"]
}'

Slack に投稿する

composio execute SLACK_SEND_MESSAGE -d '{
  "channel": "engineering",
  "text": "Deploy complete - v2.4.0 live"
}'

呼び出しを並列実行する

composio execute --parallel \
  GMAIL_FETCH_EMAILS -d '{"max_results": 2}' \
  GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

composio run でアクションを連結する

composio run '
  const issues = await search("github issues labeled bug this week");
  const summary = issues.map(i => `- ${i.title}`).join("\n");
  await execute("SLACK_SEND_MESSAGE", {
    channel: "bugs",
    text: `This week’s bugs:\n${summary}`
  });
'

ファイルから再利用可能なワークフローを読み込みます。

composio run --file ./workflow.ts -- --repo composiohq/composio

生の API にアクセスする（proxy）

専用のツールがない場合は、認証済みの API を直接呼び出します。

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile \
  --toolkit gmail

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts \
  --toolkit gmail -X POST -H 'content-type: application/json' \
  -d '{"message":{"raw":"..."}}'

仕組み

1. Codex に依頼します
2. Codex がスラッグを選びます：composio search または既存の知識を使います
3. CLI が接続を確認します：接続がなければ composio link を促します
4. アクションを実行します：実際の API に対して実行し、JSON を標準出力に返します

設定

グローバルフラグ：

• --log-level <all|trace|debug|info|warning|error|fatal|none>
• --help でコマンドごとのドキュメントを表示します

環境変数：

• COMPOSIO_API_KEY - 認証情報（非対話型の使用時に設定します）
• COMPOSIO_BASE_URL - カスタム API エンドポイント
• COMPOSIO_SESSION_DIR - アーティファクトの保存先を上書きします
• COMPOSIO_DISABLE_TELEMETRY=true - テレメトリーを無効にします

型安全な SDK（任意）

シェルではなくアプリからツールを呼び出す場合は、型付きクライアントコードを生成します。

composio generate ts    # TypeScript types
composio generate py    # Python types

フラグ：-o <dir>、--toolkits <list>、--compact、--transpiled、--type-tools。

トラブルシューティング

• Not logged in → composio login を実行します
• Connection required for <toolkit> → composio link <toolkit> を実行します
• 不明なスラッグ → composio search "<what you want>" または composio tools list <toolkit> を実行します
• 入力に問題がある場合 → composio execute <SLUG> --get-schema を実行してから --dry-run を実行します
• アクションに失敗した場合 → 対象アプリの権限を確認します

詳細なリファレンス：docs.composio.dev/docs/cli

---

エージェントを構築し、実際にリリースしている 20,000 人以上の開発者に参加しましょう