フィードバックとバグレポート

フィードバックシステム

概要

MCP サーバーには、AI エージェントセッションから直接バグレポート、機能リクエスト、一般的なフィードバックを送信するための組み込みフィードバックツールが含まれています。フィードバックはサーバーメンテナによって内部で追跡されます。

フィードバックの送信

submit_feedback ツールを以下のパラメーターと共に使用します:

パラメーター	必須	説明
type	はい	"bug"、"feature"、または "feedback"
title	はい	具体的で実行可能なタイトル（10〜200 文字）
description	はい	詳細な説明（30〜5000 文字）
severity	いいえ	"low"、"medium"、"high"、または "critical"（バグ用）
stepsToReproduce	いいえ	問題を再現する手順（バグ用）
environment	いいえ	環境情報（モード、FIX 状態など）
contact	いいえ	フォローアップ用の任意の連絡先情報（メール、Slack など）

ベストプラクティス

バグレポートの場合:

1. まず check_health を呼び出し — 出力を environment フィールドに含めてください
2. 具体的なタイトルを書いてください: “order broken” ではなく “MARKET order rejected with INVALID_SYMBOL on EURUSD”
3. エラーコードとメッセージを説明に含めてください
4. 可能であれば再現手順を追加してください

機能リクエストの場合:

• ユースケースとその重要性を説明してください
• 望ましい挙動について具体的に記述してください

フィードバックステータスの確認

submit_feedback から返された feedbackId を使用して get_feedback_status を呼び出してください。

返される内容:

• feedbackId: イシュー番号
• title: イシューのタイトル
• status: "open" または "resolved"
• categories: ラベル（例: “bug”、“feature”）
• createdAt / updatedAt: タイムスタンプ

テナント分離: 現在のセッションで送信したフィードバックのステータスのみ確認できます。他のユーザーのフィードバック ID を照会すると “Feedback not found” を返します。

レート制限

各ユーザーは1 セッションあたり最大 10 件のフィードバックを送信できます。このカウンタは各セッションでリセットされます。

制限に達した場合、ツールは現在のカウントと制限を含む FEEDBACK_LIMIT_REACHED エラーを返します。

レポーターの識別

認証済みセッションからフィードバックが送信されると、サーバーは自動的に SenderCompID（トレーディングアカウント識別子）をレポートに含めます。これにより、チームは追加入力なしでレポーターを識別できます。

また、オプションで contact 情報（メール、Slack ハンドルなど）を提供して、チームが詳細について連絡できるようにすることもできます。

送信後に何が起こるか

1. 内部フィードバックトラッカーにチケットが作成されます
2. チケットにはアカウント識別子とオプションの連絡先情報が含まれます
3. チームは受信したフィードバックをレビューし、タイプと重大度でトリアージします
4. バグ修正と機能は解決まで追跡されます
5. get_feedback_status を使用して、フィードバックが対応されたかどうかを確認します

利用可能性

フィードバックツールは、フィードバック統合経由で有効化されたときに利用できます。有効化されていない場合、両方のツールは FEEDBACK_NOT_CONFIGURED エラーを返します。

フィードバックツールは、認証済みセッションとゲストモードの両方で利用できます。