composio-mcp について
Pipa向けに、Composio MCP経由で外部アプリの操作を仲介するスキルです。ツールの検索やアカウント認証から実行、結果の出所提示までを扱います。
主な機能
- 01アプリ操作に合うツールの検索
- 02アカウント接続状態の確認
- 03必要に応じた認証案内
- 04MCP経由の操作実行
- 05結果の出所提示
- 06リスクのある書き込み前の確認
活用シーン
- 01接続アプリの記録の取得や要約
- 02外部サービスの記録の作成や更新
- 03内容確認後のメッセージ送信
- 04アプリ操作に適したMCPツールの検索
MCP 対応
実行環境で利用可能なComposio MCPツールを使い、機能検索、接続確認、アカウント認証、外部アプリ操作を行います。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/composio-mcpを入力して読み込まれたか確認します。
詳細
適用するケース
- Pipa に、Gmail、Slack、GitHub、Notion、Linear、Google Calendar などの外部アプリを操作するよう依頼された場合。
- 接続済みのサービスで、レコードの送信、作成、更新、取得、要約、監視を行いたい場合。
- 接続済みアプリの操作を依頼され、現在のエージェントランタイムで Composio MCP ツールが利用できる場合。
- Composio、Composio MCP、接続済みアカウント、外部アプリツール、または Pipa の接続済みワークフローについて明示的に言及された場合。
基本ルール
現在のランタイムで公開されている Composio MCP ツールを使用してください。MCP 以外の Composio ワークフローに切り替えたり、Composio をローカルにインストールしたり、プロジェクトを初期化したりしないでください。
Composio MCP ツールが利用できない場合は、処理を中断し、このエージェント環境で Composio MCP に接続するか、有効化するようユーザーに依頼してください。
例外：Pipa による読み取り専用の評価で、ほかに利用可能な証拠がある場合は、MCP またはアカウントにアクセスできないことを情報源の不足として記録し、処理を続けてください。ユーザーから接続を依頼されない限り、認証を開始しないでください。
ワークフロー
- 依頼が曖昧な場合は、対象アプリ、操作、ユーザーに表示される結果を確認します。
- 操作を選ぶ前に、利用可能な Composio MCP ツールを調べます。
- 依頼を完了できる、最も限定的で具体的な MCP ツールを優先します。
- 必要な接続済みアカウントまたは認証が利用可能か確認します。
- 認証が不足している場合は、MCP が提供する接続フローを完了するようユーザーに依頼し、確認を待ちます。
- 明示的なパラメーターを指定し、MCP ツール経由で操作を実行します。
- 簡潔な実行情報として、アプリ、操作、使用したツール、およびツールから返された関連レコード ID、URL、タイトル、タイムスタンプを報告します。
MCP ツールの使用パターン
Composio MCP は自己記述型です。ローカルの参照ファイルに頼らず、メタデータツールを使用してください。
- まず MCP のツール検出操作を使って、ユーザーのユースケースに合うツールを検索します。
- 返されたツールスキーマ、接続状況、推奨プラン、注意点を確認します。
- ツールキットに有効な接続がない場合は、MCP の接続管理操作を使い、返された認証リンクをユーザーに提示します。
- ツールの結果にスキーマ参照が含まれる場合は、実行前に完全なスキーマを取得します。
- 返されたツールスラッグのみを、スキーマに準拠する引数で実行します。
- 独立した操作には、利用可能な場合、MCP の一括実行操作を使用します。
このスキルに必要な機能：
- 自然言語によるタスクから、関連する外部アプリツールを検索する。
- 対象アプリのアカウントがすでに接続されているか検出する。
- アカウントが未接続の場合に、認証リンクを生成する。
- 認証が有効になった後、選択したツールを実行する。
- ツールの結果から具体的な実行情報を返す。
安全ルール
- ツール名、ツールキット名、アカウント ID、課題 ID、メールアドレス、チャンネル名、プロジェクト ID を推測しないでください。
- MCP ツールから成功結果が返されない限り、操作が完了したと主張しないでください。
- 破壊的、取り消し不可能、公開、またはユーザーに通知される操作の前には、確認を求めてください。
- 書き込み操作では、ユーザーへの通知、プロジェクト状態の変更、またはコンテンツの公開につながる可能性がある場合、実行前に対象とペイロードを正確に言い直してください。
- プロンプト、ファイル、ログ、応答に秘密情報を含めないでください。
- 現在の状態が重要な場合は、変更を加える前に読み取り専用での確認を優先してください。
Pipa での使用方法
Pipa から呼び出された場合、Composio MCP を接続済みアプリの実行レイヤーとして扱ってください。プロジェクト管理の意図は Pipa が維持し、外部アプリの操作は Composio MCP が実行します。
Pipa から適切に引き継ぐ手順：
- プロジェクト管理の意図を特定します。例：ステータス更新、チケット作成、関係者へのメッセージ送信、カレンダー調整、ドキュメント検索、自動化のサポート。
- 関連する外部アプリの MCP ツールを選択します。
- 接続済みアプリに関する操作のみを Composio MCP 経由で実行します。
- フォローアップに必要な実行情報を添えて、結果を Pipa に返します。
応答パターン
MCP アクションが成功した後は、次の内容を応答します。
- 変更した内容、または取得した内容。
- 使用した外部アプリと MCP ツール。
- ツールから返された具体的なレコード参照。
- ユーザーにまだ必要な操作がある場合は、その内容。
操作を進められない場合は、次の内容を応答します。
- 不足しているアプリ、アカウント、権限、または MCP ツール。
- 必要なユーザーの判断、または接続手順を明記します。
- Composio MCP 以外の代替手段は提示しません。