6. 作成したMCPサーバの動作確認¶
作成したMCPサーバは、MCPクライアントから接続することで動作を確認できます。
ここでは、Visual Studio Code と MCP Inspector を利用した確認方法について説明します。
6.1. エンドポイントURLの確認¶
MCPサーバのエンドポイントURLは、コンテキストパスに続けて /copilot/mcp のプレフィックスと @MCPServer の path 属性を連結したものです。
http://<HOST>:<PORT>/<CONTEXT_PATH>/copilot/mcp<path>
本書では、例として次の内容を指定したMCPサーバを利用します。
ホスト名、ポート番号 localhost:8080 コンテキストパス imart path 属性 /documents
この場合のエンドポイントURLは以下の通りです。
http://localhost:8080/imart/copilot/mcp/documents
6.2. APIキーの発行¶
MCPサーバへアクセスするには、 @MCPServer の scope 属性に指定した認可権限スコープが許可されたアクセストークンが必要です。
動作確認では、APIキーを発行して利用すると簡単です。
認可権限スコープを登録します。 MCPサーバを利用するユーザでログインし、上記のスコープを許可したAPIキーを発行します。コラム
APIキーの発行については「 OAuth ユーザ操作ガイド 」-「 APIキーを発行する 」を参照してください。注意
発行したAPIキーはパスワードと同等の情報です。第三者に共有しないでください。
6.3. Visual Studio Code から接続する¶
Visual Studio Code のMCPサーバ設定(mcp.json)に、以下の内容を追加します。
{APIKey} の箇所には、発行したAPIキーを設定してください。
{ "servers": { "intra-mart-mcp-server": { "type": "http", "url": "http://localhost:8080/imart/copilot/mcp/documents", "headers": { "Authorization": "Bearer {APIKey}" } } } }
設定後、MCPサーバへ接続すると、実装したツール・プロンプト・リソースを利用できます。
コラム
Visual Studio Code のMCPサーバ設定については「 Use MCP servers in VS Code 」を参照してください。
6.4. MCP Inspector から接続する¶
MCP Inspector を利用すると、ツール・プロンプト・リソースの一覧や入出力のスキーマを画面上で確認し、実際に呼び出すことができます。
接続時には以下を指定します。
トランスポート種別 Streamable HTTP URL http://localhost:8080/imart/copilot/mcp/documents リクエストヘッダ Authorization: Bearer {APIKey}コラム
MCP Inspector については「 MCP Inspector 」を参照してください。
6.5. トラブルシューティング¶
MCPサーバへ接続できない場合や、実装した機能が表示されない場合は、以下を確認してください。
現象 確認内容 MCPサーバへ接続できない(エンドポイントが見つからない) @MCPServer を付与したクラスが検出されていない可能性があります。MCPサーバの検出設定 の設定が正しく行われているかを確認してください。また、 name 、 path 、 scope がすべて指定されているか、 path が他のMCPサーバと重複していないかを確認してください。検出に失敗した場合は、 intra-mart Accel Platform の起動時にログへエラーが出力されます。 アクセスが拒否される アクセストークン(APIキー)に、 scope 属性に指定した認可権限スコープが許可されているかを確認してください。@Authz を付与している場合は、実行ユーザに認可リソースの実行権限が付与されているかを確認してください。 ツール・プロンプト・リソースが一覧に表示されない メソッドが メソッドシグネチャと戻り値の規約 を満たしていない可能性があります。規約を満たさないメソッドは公開されず、 intra-mart Accel Platform の起動時にログへエラーが出力されます。ツールの場合は、 name がツール名の制約を満たしているかも確認してください。 ツールの入力項目が表示されない 入力のモデルクラスのフィールドに、スキーマアノテーションが付与されているかを確認してください。詳細は 入力スキーマの定義 を参照してください。 ツールがタスクとして実行できない タスクはMCPプロトコルバージョン 2025-11-25 以降で利用可能です。MCPクライアントが対応しているプロトコルバージョンを確認してください。