intra-mart Accel Platform IM-Copilot MCPサーバ プログラミングガイド 初版 2026-10-01

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キーを発行して利用すると簡単です。
  1. 認可権限スコープを登録します。
  2. 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クライアントが対応しているプロトコルバージョンを確認してください。