fusion-mcp

Fusion MCP セットアップガイド

使用する場面

ユーザーから次のことを尋ねられた場合に使用します。

• Fusion MCP とは何か
• 何ができるか
• インストール方法や設定方法
• 正常に動作しているか確認する方法
• Fusion MCP のセットアップが失敗した場合のトラブルシューティング

よくあるきっかけ：

• 「fusion mcp とは何ですか」
• 「fusion mcp のセットアップを手伝ってください」
• 「copilot で fusion mcp を使うにはどうすればよいですか」

使用しない場面

• MCP のセットアップとは関係のない製品機能の実装
• ユーザーの確認なしで破壊的な環境変更を行う場合
• 確認できない非公開リポジトリの詳細を推測する場合
• Fusion Framework API、EDS コンポーネント、スキルカタログに関するソースに基づく質問への回答 — MCP の起動後は、代わりに fusion-research を使用してください

必要な入力情報

セットアップ手順を提案する前に、次の情報を確認します。

• ユーザーの環境（OS、エディター／ランタイム）
• MCP を実行する対象クライアント（主な対象は VS Code）
• ユーザーが Equinor Entra アカウントを利用できるか

情報が不足している場合は、まず簡潔な追加質問をしてください。

手順

1. この MCP サーバーが提供する内容を説明します。
   • Fusion 向けの、検索とワークフロー支援の MCP 機能
   • マネージドサービスとしてホストされており、ほとんどの開発者にはローカルのインフラストラクチャーは不要です
   • 検索ツール：search、search_framework、search_docs、search_eds、search_indexes、search_backend_code
   • ツールの構成は今後変更される可能性があります
2. ホスト型の本番サーバーをセットアップするよう案内します。推奨する方法はこれのみです。
   • Docker、API キー、ローカルへのクローンは不要です
   • VS Code は Microsoft Entra（Equinor アカウント）で認証します
   • ワンクリックの本番環境用インストールリンクを使用します（references/vscode-mcp-config.md を参照）
   • または、"type": "http" とサーバー URL を指定して手動で設定します（references/vscode-mcp-config.md を参照）
   • ユーザーに明確な運用上の必要性がない限り、ローカル Docker、GHCR、セルフホスト型の代替手段は提案しないでください
3. 認証フローを説明します。
   • 初めてツールを呼び出すときに、VS Code から Equinor Entra アカウントでのサインインを求められます
   • トークンは自動的に管理され、可能な場合はサイレント更新されます。必要に応じて対話型のプロンプトが表示されます
   • アクセスは既存の Fusion ロール割り当てによって制御されます
4. 簡単な MCP 動作確認を案内します。
   • initialize を実行し、応答が成功したことを確認します
   • tools/list を実行し、少なくとも 1 つのツールが返されることを確認します
   • 利用可能なツールに対して、破壊的でない tools/call を 1 つ実行します
   • 合格基準：呼び出しの応答が空でないこと（content または structuredContent にデータが含まれていること）
   • 注意：固定のツール一覧をハードコードしないでください。ツールの構成はバージョン間で変わる可能性があります
5. ドキュメントに記載された順序でトラブルシューティングを行います。
   • Entra のサインインプロンプトが表示されない → 設定の oauth.clientId と、VS Code に Equinor アカウントでサインインしていることを確認します
   • 401 Unauthorized → VS Code のアカウント設定から再認証し、Equinor Entra アカウントが有効であることを確認します
   • tools/list が空を返す、またはツールの呼び出しが失敗する → VS Code で MCP サーバーの項目が選択され、有効になっていることを確認してから、再読み込み後に再試行します
   • ツールの動作が一部に限られる → VS Code の「出力」>「Copilot」でエラーの詳細を確認し、MCP サーバーを再起動します
6. MCP のセットアップが失敗した場合、またはユーザーがバグ報告の作成を求めた場合は、assets/bug-report-template.md を使ってバグ報告の下書きを作成します。
   • 既定の対象リポジトリ：equinor/fusion-mcp
   • 具体的な再現手順、期待される動作と実際の動作、すでに試したトラブルシューティングを含めます
   • 機密情報ではない環境の詳細（OS、VS Code のバージョン、MCP サーバーの URL、Entra アカウントの種類）を含めます
   • シークレット、トークン、生の認証情報は絶対に含めないでください
7. 不確実な点やリポジトリ固有の制約がある場合は、前提を明示し、推測する代わりに信頼できるドキュメントへのリンクを示します。

期待される出力

以下を返します。

• Fusion MCP の簡単な説明と、利用する場面
• ユーザーの環境に合わせた、ホスト型本番環境のセットアップ手順
• 検証チェックリスト：initialize を実行する（成功応答を期待）、tools/list を実行する（少なくとも1つのツールを期待）、tools/call を1回実行する（空でない content または structuredContent を期待）
• 観測されたエラーの症状に対応するトラブルシューティング手順
• セットアップに失敗した場合、動作に問題がある場合、またはユーザーから依頼された場合のバグ報告の下書き。assets/bug-report-template.md を使用し、デフォルトの対象は equinor/fusion-mcp とします
• ユーザーからコピペ可能な自動化支援を求められた場合のスクリプト例
• 前提条件と不足している情報の明示
• 使用した上流ドキュメントへの正確なリンク

参考資料

• references/README.md
• assets/bug-report-template.md

安全性と制約

以下は決して行わないでください。

• シークレット、トークン、認証情報を要求または公開する
• プロジェクトのドキュメントで裏付けられていないセットアップコマンドを作り出す
• 検証結果がないのに、セットアップが成功したと主張する
• ユーザーの明示的な確認なしに、破壊的なコマンドを実行する

以下は必ず守ってください。

• 公式リポジトリのドキュメントを情報源として優先する
• ユーザーをホスト型本番サーバーに案内し、ローカルの Docker やセルフホスト型の代替案は提案しない
• 最小権限で変更を最小限に抑えたセットアップ手順を優先して提示する
• 確認済みの事実と前提条件を区別する