composio について
Composioは、エージェント利用者やアプリ開発者を適切なComposio製品とガイドへ導くスキルです。個人のアプリ利用とプラットフォーム連携を区別し、設定、操作、デバッグ、最新ドキュメントの確認を扱います。
主な機能
- 01For YouとPlatformへの振り分け
- 02依頼内容に応じたガイドの選択
- 03設定と連携の手順案内
- 04許可されたツール実行とトラブル対応
- 05変更される情報について最新の公式ドキュメントを確認
活用シーン
- 01個人エージェント向けのComposio設定を選択
- 02アプリにComposioを組み込む
- 03接続済みツールでアプリのワークフローを実行
- 04既存連携のデバッグや移行
MCP 対応
Composio For Youでは、個人のアプリにエージェントからアクセスするための主要な手段の一つとしてMCPを扱い、MCPクライアントの設定を案内します。MCPサーバーを提供するとは説明されていません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ composiohq/ composio --skill composioインストール後、Claude Code で/composioを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/errors.mdfor-you.mdplatform.md詳細
Composio
このスキルはルーターとして使用します。製品と作業内容を特定し、関連するガイダンスだけを読み込み、変わりやすい情報については公式ドキュメントを確認してから、ユーザーの依頼に回答するか、作業を実行します。
1. 製品を選択する
製品を混同しないでください。必要な認証情報とセットアップ手順はそれぞれ異なります。
| Composio For You | Composio Platform | |
|---|---|---|
| 使用するケース | 自分のエージェントに自分のアプリを使わせたい場合 | 開発者が、ユーザーがアカウントを接続する製品を構築する場合 |
| 主な利用面 | MCP または Composio CLI | アプリケーション内の SDK セッション |
| 認証情報 | クライアントがヘッダーを必要とする場合は、コンシューマーキー ck_... | プロジェクトキー COMPOSIO_API_KEY |
| ダッシュボード | dashboard.composio.dev → For You | dashboard.composio.dev → Platform |
コンテキストから製品を特定できない場合に限り、短い質問を一つだけします。
これは、ご自身のエージェントとアカウント向けですか。それとも、ユーザーがアカウントを接続する製品向けですか?
製品コードを伴わない、名前が明示された個人用 AI クライアントは For You として扱います。アプリケーションのコードベース、SDK、ユーザーまたはテナントの ID、バックエンド、製品のエージェントがある場合は Platform として扱います。
2. 作業内容を選択する
操作を開始する前に、求められている結果を特定します。
- 説明または調査: 質問への回答、アプローチの比較、または現在の API の確認。
- セットアップ: 認証情報、MCP クライアント、CLI、または SDK を初めて設定すること。
- 構築または変更: Composio を既存のエージェントまたはアプリケーションに統合すること。
- 操作: 実際のタスクのためにツールを見つけ、接続し、実行すること。
- デバッグまたは移行: 障害の診断、古い統合の更新、または従来の直接実行や Tool Router からの移行。
説明、ドキュメントの確認、または限定的なバグ修正をオンボーディングに置き換えないでください。
3. 関連するガイダンスだけを読み込む
- For You: Composio For You を読みます。
- Platform: Composio Platform を読みます。
- プロバイダー、接続、または実行の失敗:Errors and provider gotchas も読みます。
選択した作業を完了する
- 質問の場合は、必要に応じて最新のドキュメントを取得し、具体的に回答します。プロジェクトに変更を加えたり、ツールの呼び出しを強制したりしないでください。
- セットアップまたは統合の場合は、既存の環境を確認し、そのアーキテクチャと ID モデルを維持しながら、役立つ最小限の変更を加えます。認証情報とユーザーの許可がある場合は、安全な実際のツール呼び出しを一度行って検証します。
- 操作の依頼の場合は、タスクに必要なアプリだけを接続し、依頼されたワークフローを実行します。
- デバッグの場合は、Composio のログまたはリクエスト ID を取得して、失敗している境界を特定し、その箇所を修正します。ユーザーが実行を許可している場合は、再試行します。
安定したルール
- 認証情報、URL、SDK、コマンドを選ぶ前に、製品を特定してください。
- ダッシュボードでのオンボーディングはコンテキストとして扱い、スキルのアイデンティティとは見なさないでください。開発者が Getting Started で取得した既存の
COMPOSIO_API_KEYを持っている場合はそれを使用し、チャット内で新規作成、ローテーション、置き換え、表示、要求をしないでください。その場合はcomposio dev initを実行しないでください。 - ダッシュボードから認証情報が引き継がれていない状態で Platform を初めてセットアップする場合は、Platform ガイドに記載された現在のセットアップ手順に従ってください。
- ツールキットやツールのスラッグを推測で作らないでください。実行時または CLI で確認してください。
- プロバイダーの OAuth フローを構築しないでください。認証が必要な場合、Composio は接続リンクを返します。
- 新しい Platform 統合にはセッションを使用してください。アプリケーションの既存のユーザー ID とエージェントのアーキテクチャは維持してください。
- 認証情報をソース管理、URL、ログ、チャット、コマンド出力に含めないでください。
- ツール呼び出しの失敗を診断する前に、ログまたはリクエスト ID を取得してください。
- 現在の作業を完了できる最小限の設定を優先してください。リクエストや既存のコードで必要とされていない限り、ツールキットのフィルター、タグポリシー、サンドボックス制御、カスタム認証、プロバイダー固有の強化設定、その他の高度なオプションは最初の手順に含めないでください。
- リポジトリに関する事実を推測で作らないでください。ファイル、フレームワーク、環境ローダー、ID フィールド、エージェントのパス、依存関係が提供または確認されるまでは、それらが存在すると決して断言しないでください。コードベースのコンテキストを確認できない場合は、不明な点を伝え、アクセス権または必要な情報を 1 つ尋ねてください。
- SDK または API の例では、最新の公開ページまたはスキーマに記載された正確な識別子と呼び出し形式を使用してください。TypeScript と Python の間で名前を変換せず、要求された言語について文書化された形式をそのまま使用してください。必要な詳細が文書化されていない場合は、コードを推測で作らず、動作を説明してください。
正規の情報
安定した判断には、同梱のリファレンスを使用してください。ユーザー向けのソース一覧には、実際に参照した公開 https://docs.composio.dev/... ページのみを記載します。同梱リファレンス名、ローカルパス、file:// URL は除外します。バージョン、プロバイダーアダプター、クライアント固有のセットアップ、ツールキットの動作、変更された可能性のある API については、回答やコード編集の前に、最新の正規ドキュメントと最新の CLI またはツールスキーマを主な情報源として使用してください。
情報源の内容が一致しない場合は、Legacy と記載されたページよりも、最新の API リファレンスと実際のエンドポイントの動作を優先し、REST API のバージョンを明記してください。
https://docs.composio.dev/llms.txt
https://docs.composio.dev/docs/<page>.md
https://docs.composio.dev/toolkits/<toolkit>.md
それらの一次情報源で Composio 製品やトラブルシューティングに関する質問の答えが得られない場合は、公開されている統合ナレッジ検索 https://docs.composio.dev/api/knowledge-search?q=<question> を照会してください。
検索結果には、正規ドキュメント、KB、ツールキット、例、リファレンスのページが含まれる場合があります。返された根拠を使って質問に回答してください。公開記録から、ユーザーのアカウント、プロジェクト、接続、ツール呼び出しの実際の状態を判断することはできません。
ナレッジ検索で根拠が見つかった場合は、検索 API の URL ではなく、結果に含まれる canonicalUrl を引用してください。canonicalUrl が相対パスの場合は、引用する前に https://docs.composio.dev を先頭に付けてください。
抜粋またはページが質問に直接答えている場合に限り、その結果を根拠として扱ってください。具体的なエラーや症状を直接説明する公開ソースがない場合は、関連する別の結果から診断せず、その旨を伝えてください。ログまたはリクエスト ID、あるいは必要な実際の情報を求めてください。
ドキュメントを使ってタスクを完了してください。リンクを求められていない限り、リンクを渡すだけで済ませないでください。