|
intra-mart Accel Platform IM-Copilot MCPサーバ プログラミングガイド 初版 2026-10-01
目次 1. 改訂情報 ≫
1. 改訂情報 2. はじめに 2.1. 本書の目的 2.2. 対象読者 2.3. 注意事項 2.4. サンプルコードについて 2.5. 本書の構成 3. MCPサーバ機能 概要 3.1. MCPサーバ機能 とは 3.2. MCPサーバ機能 の機能 3.3. MCPサーバのエンドポイント 3.4. クラスタ構成での利用 3.5. 対応するプロトコルバージョン 3.6. MCPサーバ機能 のモジュール構成 4. MCPサーバの作成方法 4.1. 全体の作業の流れ 4.2. 前提条件 4.3. MCPサーバクラスの作成 4.4. MCPサーバの検出設定 4.5. ツールの実装 4.5.1. 基本実装 4.5.2. 入力スキーマの定義 4.5.2.1. 共通の属性 4.5.2.2. 各アノテーション固有の属性 4.5.2.3. 使用例 4.5.3. 戻り値 4.5.4. 構造化出力を返却する 4.5.5. エラーを返却する 4.5.6. ツールをタスクとして実行する 4.5.7. ツール名の制約 4.6. プロンプトの実装 4.6.1. 引数を持つプロンプト 4.7. リソースの実装 4.7.1. 静的リソース 4.7.2. バイナリリソース 4.7.3. リソーステンプレート 4.7.4. リソースのヒント情報 4.8. 自動補完の実装 4.8.1. 補完メソッドの引数 4.8.1.1. CompleteArgument 4.8.1.2. CompleteContext 4.8.2. 補完メソッドの戻り値 4.8.3. プロンプトの引数を補完する 4.8.4. リソーステンプレートのパラメータを補完する 4.9. アイコンの指定 4.10. 表示文言の多言語化 4.11. メソッドシグネチャと戻り値の規約 4.12. 例外処理 5. MCPサーバの認証・認可 5.1. 概要 5.2. 認可権限スコープによるアクセス制御 5.3. 認可コードグラントを利用する場合の設定 5.4. IM-Authzによる認可チェック 6. 作成したMCPサーバの動作確認 6.1. エンドポイントURLの確認 6.2. APIキーの発行 6.3. Visual Studio Code から接続する 6.4. MCP Inspector から接続する 6.5. トラブルシューティング 7. MCPサーバの実装例 7.1. MCPサーバクラス 7.2. MCPサーバの検出設定 7.3. 公開される機能