MCP ツールの作成

このガイドでは、プラットフォームで新しい MCP ツールを作成する手順を説明します。

MCP とは？

MCP は Model Context Protocol の略で、複数のクラウドプラットフォームのサービスを統合したり、ローカルのクライアントアプリケーションを実行したりするために使用できます。

ツールの利用はプラグに例えられます。プラグを差し込んで電源を供給すると、サービスを利用できます。従来、各 LLM は独自のツール利用方法を開発していました。規格の異なるプラグにそれぞれ対応するコンセントが必要なように、OpenAI と Claude の両方で Google Calendar を利用するには、開発者が各 AI に対応する複数のスクリプトを設計する必要があります。

Google Calendar が更新されると、開発者は次の対応が必要になる場合があります。

3 つの異なるバージョンの連携を同時に更新します
3 組の異なる技術ドキュメントを保守します

その結果、開発期間が長くなり、コストが増加します。

MCP による解決策

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

標準化されたツール定義形式
統一された通信プロトコル
一貫したエラー処理の仕組み

これらによって、開発プロセスを簡素化します。

MCP を使用すると、ツールの開発に必要な作業は次のとおりです。

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 サーバーで「現在の会話のユーザー」を識別する必要がある場合：訪問者が Keycloak で Web Chat にログインするときに、会話プラットフォームで Keycloak のログイン ID を使用してツールを呼び出すを有効にし、この MCP サーバーのホストを許可リストに追加してください。プラットフォームは Authorization ヘッダーに訪問者本人の Keycloak 認証情報を付けて送信します。

ここに MCP server の URL を貼り付けると、その server に接続されているツール一覧が自動的に取得されます。

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

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

用途：MCP コマンドの実行時や MCP サービスの呼び出し時に渡す引数の名前を定義します。内容は AI アシスタントが自動的に生成します。
形式：各要素を引数を表す文字列とする JSON 配列 (Array) の形式を推奨します。
- 例 (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 に接続されているツールの内容が自動的に取得され、一覧に表示されます。