MCP ツールの作成

本ガイドでは、プラットフォーム上で新しい MCP ツールを作成する手順をご案内します。

MCP とは？

MCP は正式名称を Model Context Protocol といい、マルチクラウドプラットフォームのサービスを統合したり、ローカルのクライアントアプリケーションを実行したりするために利用できます。

ツールの利用はプラグにたとえることができます。プラグを差し込んで通電してはじめてサービスを利用できるのと同じです。従来は、各 LLM がそれぞれ独自のツール利用方式を開発しており、規格の異なるプラグのように、利用するには複数のコンセントが必要でした。OpenAI と Claude の両方で Google Calendar のサービスを利用できるようにしたい場合、開発者は異なる AI 向けに複数のスクリプトを設計する必要がありました。

Google Calendar が更新された際、開発者は次のような対応を迫られる場合があります。

3 つの異なるバージョンの統合を同時に更新する必要がある
3 種類の異なる技術文書を保守する必要がある

その結果、開発期間が長期化し、コストも高額になっていました。

MCP によるソリューション

MCP は、まさにこの課題を解決するために設計された標準化プロトコルです。次の仕組み

標準化されたツール定義フォーマット
統一された通信プロトコル
一貫したエラー処理メカニズム

によって、開発フローを簡素化します。

MCP を利用すれば、1 つのツールを開発するために必要なのは次のステップだけです。

MCP Server を構築する（一度だけ開発）
標準化されたツール仕様を定義する
統一されたビジネスロジックを実装する
MCP に対応するすべての AI プラットフォームで利用できる

MCP は本質的に、AI ツール統合の標準化のために設計されたプロトコルであり、開発チームが「一度開発すれば、どこでも利用できる」状態を実現します。これにより、AI アシスタントのツールエコシステムの複雑さと保守コストを大幅に低減します。

MCP ツールをすばやく作成する

1. ツール管理画面に入る

まず、左側のナビゲーションバーから「AI 機能」セクションに入り、「🔧 ツール」をクリックします。ツール一覧ページに入ったら、右上の「➕ ツールを追加」ボタンをクリックします。

2. ツールタイプを選択する

ツールタイプは MCP を選択してください。

3. 表示名を設定する

ツールにわかりやすい表示名を設定します。ここでは Composio mcp for google calendar と設定します。

用途：この名前はプラットフォームの画面に表示され、すべてのユーザーが閲覧できます。
推奨：ツールの主な機能を明確に表現できる名前を選び、ユーザーが理解しやすいようにしましょう。この名前には厳密なフォーマットの制限はありません。

4. MCP 設定を入力する

a. 🔗MCP サーバーの URL

用途：MaiAgent は現在、外部の MCP サーバーを受け付けています。MCP サーバーのサービスアドレス（URL）を指定することで、AI アシスタントが MCP サービスを呼び出し、外部アプリケーションと連携できるようになります。
フォーマット：
- 完全な URL を入力してください（例：https://mcp.dev/maiagent/mcp_service）。
注意：この項目は必須です。

MCP の URL の取得方法については、技術者向けマニュアル—Remote MCP サービス概要をご参照ください。

ここにご自身の MCP server の URL を貼り付けると、システムが自動的にその server に接続済みのツール一覧を取得します。

b. 🎛️ MCP コマンド引数 (mcp_args)

特定の環境変数を設定する必要がない場合、この項目は空欄のままで構いません。

用途：MCP コマンドを実行する際、または MCP サービスを呼び出す際に渡す必要のある引数名を定義します。内容は AI アシスタントが自動的に生成します。
フォーマット：JSON 配列（Array）形式の利用を推奨します。各要素は 1 つの引数を表す文字列です。
- 例（JSON 配列）：
  [ "--user", "admin", "--config", "/path/to/config.yaml" ]
- 実際の実行時：AI アシスタントがこれらの引数を順番に MCP ツールへ渡します。
- カンマ区切りの文字列（例：arg1,arg2,arg3）を入力した場合、システムはそれを引数リストとして解析しようとします。あいまいさを避けるため、JSON 配列の利用を推奨します。

c. 🌳 MCP 環境変数 (mcp_env)

特定の環境変数を設定する必要がない場合、この項目は空欄のままで構いません。

用途：MCP コマンドの実行環境に必要な環境変数を設定します。
フォーマット：有効な JSON オブジェクトである必要があります。キー（Key）は環境変数の名前、値（Value）は環境変数の内容（文字列）です。
- 例：
  { "API_KEY": "{{SECRET_MCP_API_KEY}}", "REGION": "us-west-1", "DEBUG_MODE": "true" }

5. 「許可するツール（JSON 配列）」を見つけ、再取得をクリックする

用途：この MCP クライアントのもとで、AI アシスタントが利用を許可される具体的なサブツールのリストを指定します。1 つの MCP クライアントが複数の異なる機能やサブツールを提供する場合があります。
自動検出/空欄：この項目を空欄にするか指定しない場合、システムは MCP クライアントへの初回接続時に、利用可能なすべてのサブツールの自動検出を試み、検出されたすべてのサブツールをデフォルトで許可します。AI アシスタントが特定のサブツールのみを利用できるように制限したい場合は、ここに明示的にリストアップしてください。

クリックすると、システムが自動的にその server に接続されたツールの内容を取得し、一覧に表示します。