MCPサーバー

モデルコンテキストプロトコル(MCP)サーバから外部ツールをインポートし、エージェントに追加することで、エージェントのタスク遂行能力を向上させることができます。

MCPサーバーについて

MCPは、エージェントがMCPサーバーを通じて外部ツールやデータソースと安全かつ柔軟にやり取りできるようにするための標準規格です。 MCPにより、エージェントはMCPサーバーが提供する外部ツールを検出、接続、起動することができます。これらのサーバーは仲介役として機能し、さまざまな機能（ウェブ検索、データベースへの問い合わせ、電子メールの送信、ウェブコンテンツの取得など）を標準化された方法で提供する。このプロセスでは、カスタムAPIを作成したり、手動で接続を設定したりする必要がないため、エージェントが外部ツールを使用するための方法がよりシンプルで効率的になります。

MCPを使用することで、エージェントは実行中にこれらの外部ツールを検出し、使用することができ、エージェント固有の機能以上の機能を強化することができます。外部ツールとのやりとりはすべて単一のプロトコルで管理されるため、接続が簡素化され、効率が向上する。さらにMCPは、異なるベンダーやプラットフォームのエージェント間のコラボレーションやツールの共有を容易にする。

ツールは、ローカルのMCPサーバーまたはリモートのMCPサーバーのいずれかからインポートできます。 watsonx Orchestrate Nodeと MCPサーバー（通常、とコマンドを使用するサーバー）のインストールと実行を可能にします。 Python npx uvx

ローカルのMCPサーバーは、ご自身のシステムまたはネットワーク上にインストールして実行できます。通常、リポジトリ GitHub からダウンロードして、システム上で実行できます。リモートMCPサーバーは外部サーバー上でホストされ、インターネット経由でアクセス可能です。

MCPは、 OAuth、 2.0、Bearer Token、API Key、Basic Authenticationといった複数の認証方式に加え、SSOやOBOフローにも対応しています。 MCPサーバーの設定時に、[接続]ページで必要な認証タイプを選択できます。認証と接続の詳細については、「アプリ接続と認証情報の管理」を参照してください。

ローカルまたはリモートのMCPサーバーからツールをインポートする前に、次の手順に従ってください：

使用するローカルMCPまたはリモートMCPサーバーを特定します。

ローカルのMCPサーバーの場合：
1. 使用する予定のローカルMCPサーバーを見つけます。通常、ローカルのMCPサーバーは、 https://github.com/appcypher/awesome-mcp-servers や https://github.com/modelcontextprotocol/servers などの GitHub リポジトリで見つけることができます。
2. ローカルのMCPサーバーのドキュメントまたはreadmeファイルでインストール手順を確認してください。
  - 通常、Node.js または Python.NET を使用してローカル MCP サーバーを起動する方法に関する手順は、例えば、npx -y time-mcp などです。
  - 特定のローカルMCPサーバーでは、リモートサービスとの通信のためにAPIキーやその他の環境変数を設定する必要があります。例えば、 "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" APIキー。
3. 道具に説明があることを確認する。ローカルMCPサーバー内の各ツールには説明を含める必要があります。この記述は、基礎となる言語モデルがツールの目的と使用方法を理解するのに役立つ。説明文は、ツールを watsonx Orchestrate に正常にインポートするためにも必要です。ツールの説明が欠けているとエラーになります。
MCPサーバーが正規のものであり、エージェントが安全に使用できることを確認する。

環境変数が必要なMCPサーバーのインストール

環境変数を必要とするMCPサーバーをインストールするには、キーと値のペアを使用して、必要な変数を AppID/Connection。例えば、 "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" APIキーを使用するには、キーとして GITHUB_PERSONAL_ACCESS_TOKEN 、値としてあなたのパーソナルトークンを持つキーと値のペアを追加する必要があります。

MCPサーバーは起動時に環境変数を取得するため、MCPサーバーをインポートまたは起動する前に変数を設定しておくことが重要です。

MCPサーバーの追加

MCP サーバーは、 IBM watsonx Orchestrate、またはエージェント開発キット（ADK）を使用して直接追加できます。

MCPサーバーをインポートするには、「 MCPサーバーからツールをインポートする」を参照してください。

ADKを使用する場合、MCPサーバーはツールキットとしてインポートされる。詳細については、「ツールキットの管理」を参照してください。

制限

以下の機能はMCPサーバー統合ではサポートされていません：

ツール一覧の更新またはリフレッシュ：

MCPサーバーからインポートされたツールは、テナントカタログ内で自動的に更新またはリフレッシュできません。サーバーサイドのツールリストに変更を加えた場合は、ツールを手動で再インポートする必要があります。

OAuth 2.1 および動的クライアント登録：

OAuth 2.1 およびDCRはサポートされていません。サポートされている接続タイプは、 OAuth、 2.0、API Key、Basic、Bearer Token、およびSSOまたはOBOのみです。

ツールの実行をキャンセルする：

ツールの実行が開始されたら、自動的に完了しなければならない。ユーザーは実行を停止またはキャンセルできません。

MCPサーバーのリソースとプロンプトのインポート：

事前定義されたプロンプトやサーバーサイドアセットなどのリソースは、フロービルダーにインポートして使用することはできません。追加できるのはツールのみです。

Docker 画像：

Docker化されたMCPサーバーインスタンスは、フロービルダー内でのインポートまたは実行をサポートしていません。

抽出と注釈：

誘発とは、ツールの実行中にユーザーから対話的に情報を収集し、入力の精緻化や意思決定の指針とするプロセスである。アノテーションとは、さらなる分析や統合のために、ツールの出力をメタデータ、ラベル、またはコメントで補足するプロセスである。ツールは抽出と注釈付けをサポートしていません。

MCPサーバーからのインポート