1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

wxO から公式ドキュメントをリモート MCP で検索する(Streamable HTTP)

1
Last updated at Posted at 2026-04-21

IBM watsonx Orchestrate(wxO)のエージェントから、インターネット上の公開 MCP サーバーに接続する方法を試しました。

今回は Streamable HTTP を使い、IBM が公式公開している ADK ドキュメントサーバーに接続して「日本語で質問 → 英語ドキュメントを検索 → 日本語で回答」するエージェントを作ります。

コードは wxo-mcp-lab/03_remote-mcp/track-a に置いています。


ローカル MCP との違い

これまでの記事(Track A: PostgreSQL 接続 / Track B: FastMCP)では「ローカル MCP」を使っていました。ローカル MCP は wxO クラウド上で npx や python コマンドを起動する方式です。

リモート MCP は全然違います。

ローカル MCP リモート MCP
サーバーの用意 必要(npm / Python ファイル) 不要(公開サーバーを使う)
YAML の書き方 command: transport: + server_url:
認証 connections: で環境変数を注入 サーバー次第(公開なら不要)
通信方式 STDIO Streamable HTTP or SSE

リモート MCP はサーバーを自分で用意する必要がなく、URL を指定するだけで接続できます。


接続先:IBM ADK 公式ドキュメントサーバー

https://developer.watson-orchestrate.ibm.com/mcp

IBM が公式に公開しているパブリック MCP サーバーです。このサーバーは ADK(ibm-watsonx-orchestrate-adk) の開発者向けドキュメントを MCP ツールとして提供しています。

  • 認証不要
  • GitHub サインアップ不要
  • Connection 設定不要

公開しているツールは search_ibm_watsonx_orchestrate_adk 1本で、キーワードで関連ドキュメントを検索して返してくれます。


設定方法:UI と CLI の両方に対応

UI(画面操作のみ) と CLI + YAML ファイル の両方で設定できます。

UI は「まず動かしてみたい」人向け。CLI は「YAML でコード管理したい・CI/CD に組み込みたい」人向けです。

詳しい手順は GitHub の README にまとめています。

UI の場合(概要)

「ツールの作成 +」→「MCPサーバー」→「リモートMCPサーバー」を選択し、URL とトランスポートタイプを入力するだけです。

リモートMCPサーバーの設定フォーム

エージェント編集画面(動作タブ+プレビュー)

トランスポートタイプの選び方:サービスのドキュメントを確認するのが基本。IBM ADK サーバーは Streamable HTTP(ストリーム可能HTTP)と明記されています。わからなければ Streamable HTTP を先に試してみてください。

CLI の場合(YAML ファイル)

Toolkit(toolkits/m-adk-docs.yaml)

spec_version: v1
kind: mcp
name: m-adk-docs
description: >
  IBM watsonx Orchestrate ADK 公式ドキュメントを検索するリモート MCP ツールキット。
  Streamable HTTP でパブリックサーバーに接続する。認証不要。
transport: streamable_http
server_url: https://developer.watson-orchestrate.ibm.com/mcp
tools:
  - "*"

ローカル MCP では command: を書いていたところが transport: streamable_http と server_url: に変わるだけです。シンプル。

Agent(agents/M-adk-docs-agent.yaml)

spec_version: v1
kind: native
name: M_adk_docs_agent
description: >
  IBM watsonx Orchestrate ADK の公式ドキュメントを自然言語で検索するエージェント。
  リモート MCP ツールキット m-adk-docs を通じてドキュメントサーバーに接続する。
instructions: |
  あなたは IBM watsonx Orchestrate(wxO)の専門アシスタントです。
  ユーザーの質問に応じて、以下のツールを使って ADK 公式ドキュメントを検索し、日本語で回答してください。

  ツールの使い方:
  - search_ibm_watsonx_orchestrate_adk: キーワードやフレーズで関連ドキュメントを検索する
    重要1: ドキュメントは英語のため、検索クエリは必ず英語で入力すること。
    例: ユーザーが「MCP の接続方法」と聞いたら "MCP toolkit connection" で検索する。
    重要2: version パラメータは絶対に指定しないこと。常に query のみで呼び出すこと。

  回答ルール:
  1. 必ず日本語で回答すること
  2. 参照したドキュメントのページ名・URL を明示すること
  3. 複数の関連ページがある場合はまとめて紹介すること
  4. わからない場合は「ドキュメントに記載が見つかりませんでした」と正直に伝えること
llm: groq/openai/gpt-oss-120b
style: react
tools:
  - m-adk-docs:search_ibm_watsonx_orchestrate_adk

エージェントの tools: には toolkit名:tool名 形式で書きます。


手順

# 1. Toolkit をインポート
orchestrate toolkits import -f toolkits/m-adk-docs.yaml

# 2. インポートされたツール名を確認
orchestrate tools list | grep m-adk-docs

# 3. エージェントをインポート
orchestrate agents import -f agents/M-adk-docs-agent.yaml

Toolkit のインポート時に wxO がリモートサーバーに接続してツール一覧を取得します(30 秒タイムアウト)。


ハマりポイント

実際に動かすまでに 2 つハマりました。

1. 検索クエリを英語にしないとヒットしない

ドキュメントが英語のため、日本語のまま search_ibm_watsonx_orchestrate_adk を呼び出してもヒットしません。

エージェントへの質問は日本語でも、ツールへのクエリは英語に変換するよう instructions に明記することで解決します。

重要1: ドキュメントは英語のため、検索クエリは必ず英語で入力すること。
例: ユーザーが「MCP の接続方法」と聞いたら "MCP toolkit connection" で検索する。

2. LLM が version パラメータを勝手に付ける

このツールには省略可能な version パラメータがあります。LLM が「丁寧に」version: "v0.7" などを自動付与すると、そのバージョンにしか存在しないドキュメントしかヒットしなくなり、結果が激減します。

instructions に「version パラメータは絶対に指定しないこと」と書いておくだけで防げます。

重要2: version パラメータは絶対に指定しないこと。常に query のみで呼び出すこと。

動作確認

wxO チャットで M_adk_docs_agent に話しかけると、日本語で回答してくれます。

Q: MCP ツールキットの接続方法を教えて
A: 以下のドキュメントが見つかりました…
   - MCP Servers | watsonx Orchestrate(URL)
   …(日本語でまとめて回答)

まとめ

  • リモート MCP は transport: + server_url: を書くだけ。command: 不要
  • IBM 公式の ADK ドキュメントサーバーは認証不要で即使える
  • 英語ドキュメントを日本語で検索するには、instructions で「クエリは英語で」と明記する
  • version パラメータを LLM が自動付与するのを防ぐため、使わないよう instructions に書く

次の Track B では SSE を使い、GitMCP で GitHub リポジトリを MCP サーバー化する方法を紹介します。


シリーズ


(本記事は、執筆にあたりAnthropic Claudeを利用し、その出力を参考にしています。)

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?