mcpField
C
composio-connect

composio-connect

github.com/casper-studios生産性15268 回インストール8 週間前に更新
リポジトリ

composio-connect について

composio-connectは、1,000以上のアプリで操作を実行するフォールバック用スキルです。対応する専用スキルがない場合に、自然言語または明示したパラメーターで操作できます。

主な機能

  1. 011,000以上のアプリで操作を実行
  2. 02自然言語による操作実行
  3. 03アプリやカテゴリの一覧表示
  4. 04OAuthによるアプリ接続
  5. 05操作とパラメーターの指定

活用シーン

  1. 01専用スキルがない場合のNotionページ作成
  2. 02カテゴリ別の対応アプリ検索
  3. 03OAuthによるサービス認証
  4. 04指定パラメーターでの操作実行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/casper-studios/casper-marketplace --skill composio-connect

インストール後、Claude Code で/composio-connectを入力して読み込まれたか確認します。

同梱ファイルreferences/apps-catalog.mdscripts/execute_action.py

詳細

Composio Connect

概要

1,000 以上のアプリに対応するユニバーサルなアクション実行ツールです。これはフォールバック用のスキルです。リクエストされたサービスに対応する他のスキルがない場合にのみ使用してください。

このスキルを使用する場合

┌─────────────────────────────────────────────────────────────────┐
│ DECISION: Should I use Composio?                                │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ 1. Does another skill already handle this service?              │
│    ├── Gmail/Drive/Calendar → google-workspace (USE THAT)       │
│    ├── Slack → slack-automation (USE THAT)                      │
│    ├── CRM (Attio) → attio-crm (USE THAT)                       │
│    ├── GitHub issues → Use gh CLI via Bash (USE THAT)           │
│    └── YouTube downloads → youtube-tools (USE THAT)             │
│                                                                 │
│ 2. Is the service NOT covered by other skills?                  │
│    ├── Notion, Asana, Trello, Monday → USE COMPOSIO             │
│    ├── HubSpot, Salesforce, Pipedrive → USE COMPOSIO            │
│    ├── Jira, Linear, Confluence → USE COMPOSIO                  │
│    ├── Airtable, Coda, ClickUp → USE COMPOSIO                   │
│    ├── Stripe, Shopify, QuickBooks → USE COMPOSIO               │
│    ├── Zendesk, Intercom, Freshdesk → USE COMPOSIO              │
│    ├── Microsoft 365, Teams, Outlook → USE COMPOSIO             │
│    ├── Dropbox, Box, OneDrive → USE COMPOSIO                    │
│    ├── Figma, Canva, Miro → USE COMPOSIO                        │
│    ├── Zoom, Webex, Google Meet → USE COMPOSIO                  │
│    └── 900+ other apps → USE COMPOSIO                           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

環境設定

# 1. Get free API key from https://platform.composio.dev
# 2. Add to .env file
COMPOSIO_API_KEY=your_api_key_here

# 3. Install SDK
pip install composio-core

クイック判断フローチャート

What do you want to do?
│
├── Execute a single action
│   └── python scripts/execute_action.py "Send email via Gmail to [email protected]"
│
├── List available apps
│   └── python scripts/execute_action.py --list-apps
│
├── List actions for an app
│   └── python scripts/execute_action.py --list-actions notion
│
├── Check connection status
│   └── python scripts/execute_action.py --check-connection notion
│
└── Connect to a new app
    └── python scripts/execute_action.py --connect notion

一般的な使い方

アクションを実行する(自然言語)
# Let Composio figure out the right tool
python scripts/execute_action.py "Create a Notion page titled 'Meeting Notes' in my workspace"
python scripts/execute_action.py "Add a task to Asana: Review Q4 budget"
python scripts/execute_action.py "Create a Linear issue for bug in checkout flow"
python scripts/execute_action.py "Send a HubSpot email to [email protected]"
利用可能なアプリを一覧表示する
python scripts/execute_action.py --list-apps
python scripts/execute_action.py --list-apps --category crm
python scripts/execute_action.py --list-apps --category productivity
アプリに接続する(初回)
# This will provide an OAuth link to authorize
python scripts/execute_action.py --connect notion
python scripts/execute_action.py --connect hubspot
python scripts/execute_action.py --connect jira
特定のアクションを実行する
python scripts/execute_action.py --app notion --action create_page --params '{"title": "My Page", "content": "Hello world"}'

カテゴリ別の対応アプリ

生産性向上・ドキュメント
アプリ一般的なアクション
Notionページを作成、データベースにエントリーを追加、検索
Asanaタスクを作成、プロジェクトを更新、担当者を割り当て
Trelloカードを作成、カードを移動、コメントを追加
Mondayアイテムを作成、列を更新、通知
ClickUpタスクを作成、ステータスを更新、コメントを追加
Codaドキュメントを作成、テーブルを更新、自動化を実行
Airtableレコードを作成、フィールドを更新、ベースをクエリ
CRM・営業
アプリ一般的なアクション
HubSpotコンタクトを作成、取引を更新、メールを送信
Salesforceリードを作成、商談を更新、通話を記録
Pipedrive取引を作成、人物を更新、アクティビティを追加
Zoho CRMレコードを作成、モジュールを更新、メールを送信
Closeリードを作成、通話を記録、メールを送信
開発・DevOps
アプリ一般的なアクション
Jira課題を作成、ステータスを更新、コメントを追加
Linear課題を作成、担当者を割り当て、優先度を更新
Confluenceページを作成、スペースを更新、コメントを追加
GitLab課題を作成、マージリクエストを作成、パイプラインを実行
BitbucketPR を作成、コメントを追加、課題を更新
カスタマーサポート
アプリ一般的なアクション
Zendeskチケットを作成、ステータスを更新、メモを追加
Intercomメッセージを送信、会話を作成、ユーザーにタグを付ける
Freshdeskチケットを作成、返信、優先度を更新
Help Scout会話を作成、返信を送信、タグを付ける
金融・Eコマース
アプリ一般的なアクション
Stripe請求書を作成、支払いを確認、返金
Shopify注文を作成、商品を更新、在庫を確認
QuickBooks請求書を作成、支払いを記録、経費を追加
Xero請求書を作成、照合、コンタクトを追加
Square支払いを作成、カタログを更新、領収書を送信
コミュニケーション
アプリ一般的なアクション
Microsoft Teamsメッセージを送信、チャネルを作成、会議をスケジュール
Zoom会議を作成、招待を送信、録画を取得
Discordメッセージを送信、チャネルを作成、ロールを管理
TwilioSMS を送信、電話をかける、WhatsApp を送信
デザイン・クリエイティブ
アプリ一般的なアクション
Figmaファイルを取得、アセットをエクスポート、コメントを追加
Canvaデザインを作成、エクスポート、共有
Miroボードを作成、付箋を追加、エクスポート
ストレージ・ファイル
アプリ一般的なアクション
Dropboxファイルをアップロード、リンクを共有、フォルダーを作成
Boxアップロード、共有、権限を管理
OneDriveアップロード、共有、同期

初回認証の流れ

新しいアプリに初めて接続するとき:

  1. 接続コマンドを実行します:

    python scripts/execute_action.py --connect notion
    
  2. OAuth URL が表示されます:

    Please authorize Composio to access Notion:
    https://app.composio.dev/authorize/notion?token=xxx
    
  3. リンクをクリックし、ブラウザーで認証します

  4. ターミナルに戻って確認します:

    Authorization complete? (y/n): y
    
  5. 接続が保存されます - 以降のリクエストは自動的に実行されます

費用

  • Composio API: 無料プランを利用できます(利用上限については platform.composio.dev を確認してください)
  • ほとんどの操作にアクションごとの費用はかかりません
  • プレミアムアプリでは、有料の Composio プランが必要になる場合があります

セキュリティに関する注意事項

認証情報の取り扱い
  • COMPOSIO_API_KEY を .env に保存します(絶対にコミットしないでください)
  • OAuth トークンは Composio によって安全に保存されます
  • platform.composio.dev からいつでもアクセスを取り消せます
権限
  • 各アプリが要求する OAuth スコープは必要最小限です
  • 認証する前に権限を確認してください
  • 接続は個別に削除できます
データプライバシー
  • Composio はリクエストを処理しますが、データは保存しません
  • アクションは接続先のサービス上で直接実行されます
  • 詳細については Composio のプライバシーポリシーを確認してください

トラブルシューティング

問題:「App not connected」

解決策: --connect <app> を実行し、OAuth フローを完了します

問題:「Invalid API key」

解決策: .env の COMPOSIO_API_KEY を確認し、必要に応じて再生成します

問題:「Action failed」

原因: 権限が不足しているか、パラメーターが無効です 解決策: 正しいアクション形式を確認するには、--list-actions <app> を確認します

問題:「Rate limited」

解決策: 待ってから再試行するか、Composio のプランをアップグレードします

他のスキルとの連携

フォールバックパターン

ユーザーから依頼された内容がスキルにない場合:

  1. Composio がそのアプリに対応しているか確認します
  2. Composio を使ってアクションを実行します
  3. 結果をユーザーに返します
アクションの連鎖
# Research → Create Notion summary
# 1. Use parallel-research for research
# 2. Use composio to create Notion page with results

# Scrape → Update CRM
# 1. Use apify-scrapers to get company data
# 2. Use composio to update HubSpot contact

リソース

コメント