For the complete documentation index, see llms.txt. This page is also available as Markdown.

Composio 連携

Composio 連携:Composio MCP ディレクトリから MCP Server URL を取得し、外部サービスのアカウントを接続して、Agent が使用する MCP ツールを MaiAgent で作成します。

このガイドでは、Composio から MCP (Model Context Protocol) サーバー URL を取得して設定する手順を説明します。これにより、MaiAgent の Agent が Composio の MCP Server サービスを利用できるようになります。

✅ 前提条件

  • Composio アカウントを持っていること。

  • Composio のツールを MaiAgent の Agent に統合して使用したいこと。

🌐 ステップ 1:Composio MCP ディレクトリにアクセスする

  1. Web ブラウザーを開き、リンクから Composio MCP ツールディレクトリにアクセスします:

    • このページには、Agent に統合できる Composio のツールとアプリケーションが表示されます。

Composio MCP ディレクトリページの概要
Composio MCP ディレクトリには、統合可能な多数のアプリケーションとツールが表示されます

🔑 ステップ 2:アカウントにログインする

  1. Composio MCP ディレクトリページの右上にある "Sign in" ボタンをクリックします。

  2. Composio アカウントでログインします。

    • Composio アカウントをまだ持っていない場合は、先に登録を完了する必要があります。

Composio MCP ログインボタンの位置
ページ右上の "Sign in" ボタンをクリックしてアカウントにログインします
  1. ログインすると、ページが個人用の MCP Dashboard に切り替わり、利用可能なすべてのツールとアプリケーションが表示されます。

Composio MCP ログインボタンの位置
Composio MCP Dashboard

👆 ステップ 3:必要なツール/アプリケーションを選択する

  1. Composio MCP Dashboard で、Agent に使用させたいツールやアプリケーション (Google Drive、Slack、Jira、GitHub など) を閲覧または検索します。

Google Calendar を例に説明します:

🔐 ステップ 4:Server を作成し、アカウントを接続する

  1. ツールを見つけたら、有効にする前にアカウントの接続を認可する必要があります。

「+Create Server」をクリックします

  1. Server に名前を付け、完了したら「Next」をクリックします

  1. サービスの認可ウィンドウが表示されます。Composio にアクセス権限を付与することを確認します。

  • 例えば Google サービスの場合、認可する Google アカウントを選択し、権限の範囲を確認する必要があります。

  • Composio が代理で操作するには認可が必要なため、この手順は必須です。

"Connect" をクリックします。認可が完了すると、Composio プラットフォームにリダイレクトされます

  1. 使用を許可するツールを選択し、「Create Server」をクリックして接続を作成します

  • 重要な注意事項:Configure Actions では、ユーザーが実際に使用する機能を選択できます。特別な要件がなければ、すべて選択しても構いません。

🔗 ステップ 5:MCP サーバー URL をコピーする

  1. Server の構築が完了すると、専用の MCP サーバーが生成されます。

HTTP Stream(Streamable HTTP)への切り替えを推奨します。MaiAgent は SSE にも対応していますが、URL のパスが /sse で終わる場合、パスに /sse/ が含まれる場合、またはクエリ文字列に transport=sse が含まれる場合にのみ SSE で接続します。それ以外の URL はすべて Streamable HTTP で接続します。

  1. 「MCP Server Created」ウィンドウの HTTP Stream タブで URL(形式は https://mcp.composio.dev/composio/server/<server-id>/mcp?...)をコピーし、MaiAgent のページに移動します。

💻 ステップ 6:MaiAgent で MCP ツールを作成する

MaiAgent で MCP ツールを追加し、ステップ 5 でコピーした Composio の MCP サーバー URL を「または直接入力(認証なし / Service Account)」の下にある URL 欄に貼り付けます。この URL 自体に Composio の認可情報が含まれているため、「ヘッダー (JSON)」は {} のままにします。続いて「再取得」をクリックし、「許可するツール (JSON 配列)」で各ツールの右側にあるスイッチを使って Agent に公開するツールを選択してから保存します。

詳しい操作手順と各フィールドの説明は、ユーザーマニュアルの MCP ツールの作成:MCP サーバー URLをご覧ください。

⚠️ 注意事項

  • URL の機密性:生成された MCP Server URL 自体に Composio の認可情報が含まれています。URL を入手した人は、そのアカウントでツールを呼び出せるため、漏えいさせないでください。

  • すべてのユーザーが同じアカウントを共有します:この Agent を通じて会話するすべてのユーザーは、Composio で認可したアカウントで操作します。個人アカウントに紐づくサービス(個人用メールボックスやカレンダー)は内部向け Agent でのみ使用するか、MaiAgent の OAuth コネクタで連絡先ごとの個別認可を選択してください。Remote MCP サービスの概要:制限と注意事項をご覧ください。

  • 新しいアクションは自動で有効になりません:後から Composio 側でアクションを追加した場合は、MaiAgent のツール設定に戻って「再取得」をクリックし、有効にする必要があります。その後、Agent が使用できるようになります。

  • 複数のツール:複数のアプリケーションを統合する場合(例えば Google Drive と Slack を同時に使用する場合)、Composio MCP ディレクトリでアプリケーションごとに上記のステップ 3~5 を繰り返し、それぞれの MCP サーバー URL を取得する必要がある場合があります。MaiAgent で別々のツールとして設定し、Agent に割り当ててください。

  • Composio のドキュメント:Composio のインターフェースや手順は更新される可能性があります。正確な情報を得るため、Composio の最新の公式ドキュメントを随時参照してください。

最終更新

役に立ちましたか?