the-metis-fca-handbook-ai-harness-mcp

Metis FCA Handbook AI Harness — MCP サーバー

Metis FCA Handbook AI Harness を AI ワークフローに統合する MCP（Model Context Protocol）サーバーです。MCP は Claude、OpenAI、Gemini、およびほとんどのデスクトップ／IDE MCP クライアント（Cursor、Windsurf、Cline など）でサポートされています。この README では、推奨するリモートサーバーの動作確認済みの例として Claude Code を、ローカルでの代替手段として Claude Code と Claude Desktop を使用しています。ご利用のクライアントに合わせて設定手順を調整してください。

ソースと完全なドキュメント： github.com/99blakeD99/the-metis-fca-handbook-ai-harness-mcp-files

ツール

evaluate_fca_handbook_applicability

Metis FCA Handbook AI Harness を使用して、どの FCA Handbook の項目が対象に適用されるかを評価します。単発実行で、セッションや会話状態はありません。クイックモード（60～120 秒、デフォルト）とフルモード（より長時間で詳細）に対応しています。逐語的な引用と改善案を含むコンプライアンスレポートを返します。改善案では、提供された情報に不足している点と、その補い方を示します。

Metis FCA Handbook AI Harness を選ぶ理由

• 効率性 コンプライアンスに関する助言の効果を高めます。Harness の実行ごとに、トークン料金を £80 以上節約できます。

• 「難問」に対応 LLM のトークンに関するインセンティブが学習データを優先するため、結果の信頼性が低くなる問題に対処します。

• 逐語的な引用 FCA Handbook の項目を一字一句そのまま引用します。他の AI システムでは、これを実現するのが困難です。

• 実社会のニーズに対応 調べたい項目を最初から把握している必要はありません。FCA Handbook の 33,000 件を超える項目すべてを対象に、体系的な検索を実施します。

• セキュアな設計 Harness の区画化、単発実行の構造、ステートレス性は、OWASP Top 10 for Agentic Applications 2026 など、新たに登場している AI エージェントのセキュリティ標準に自然に適合します。

• AI から利用可能 AI ワークフローやエージェントに簡単に統合できます。LLM はこれをツールとして利用できます。

Harness をライブで試す

統合する前に、Harness をインタラクティブにお試しください。

https://fcahandbookharnessimplementation.onrender.com

[email protected] にメールを送り、無料の一時アクセスコードをリクエストしてください。

自然言語でコンプライアンスに関する質問をし、推論の各ステップがリアルタイムで展開される様子をご覧ください。

設計原則

Harness は、実証済みの原則に基づいて構築されています。

• ステートレス — 各リクエストは独立しており、セッションに依存しません
• 単発実行 — 複数ターンの状態を保持せず、1 回の呼び出しで分析を完了します
• 明確な契約 — 統合しやすいよう、入出力のスキーマを明示します
• ホスト型 — 単一の正規ソースを使用し、バージョンのずれや古いデータを防ぎます

ユースケース

コンプライアンス AI プラットフォーム

FCA に関する推論をサービスとしてコンプライアンスプラットフォームに組み込みます。ユーザーが自然言語で質問すると、プラットフォームが Harness を呼び出し、構造化された推論を提示します。

AI エージェントのワークフロー

コンプライアンスのワークフローを構築するエージェントは、構成可能なツールとして FCA Handbook に基づく推論を含めることができます。外部 API の呼び出しは不要で、MCP の設定だけで利用できます。

コンプライアンスレビューの自動化

ドキュメントレビューやデューデリジェンスのパイプラインに統合します。新しい規則が FCA の適用対象となるかを自動的にスクリーニングします。

規制スクリーニング向け

MCP サーバーをスクリーニングする金融サービス企業は、次の点を確認できます。

• シンプルなモデル： ステートレスで、隠れた状態やバックグラウンドジョブはありません
• 明確な契約： 入力スキーマ、出力スキーマ、エラーの種類を明示します
• 透明性の高い更新： バージョンを固定し、自動アップグレードはありません
• 単一障害点： Harness が停止した場合は明確に把握でき、設定の問題が連鎖することはありません
• 監査に適した設計： すべての呼び出しを分散させず、中央でログに記録します

クイックスタート

セットアップは、AI ツールを管理する担当者が一度だけ行う作業です。接続後は、コンプライアンス担当者が AI アシスタントに尋ねるだけで利用できます。

使用するセットアップ：

1. クライアントがリモート MCP サーバーに接続でき、カスタムの Authorization ヘッダーを送信できる場合は、リモートサーバー（下記の手順 2）を使用します。インストールは不要で、必要なのは URL と API キーだけです。こちらを推奨します。
2. それ以外の場合は、マシン上で動作し、各呼び出しをホスト型 Harness に転送するローカルサーバーを使用します。

どちらも同じツールと同じ結果を同じ料金で利用できます。Claude Desktop では、ローカルサーバーを使用してください。

AI アシスタントとしてユーザーのセットアップを行う場合

以下の手順に加えて、次のルールに従ってください。

• 上記のルールで選ばれたセットアップを使用してください。Claude Code の場合は手順 2a のリモートセットアップを使用し、ユーザーからプロジェクト限定のセットアップを求められない限り、--scope user を指定してください。Claude Desktop ではローカルセットアップを使用してください。それ以外のクライアントでは、手順 2b の設定を使用してください。
• API キーは、ユーザーの環境変数 METIS_API_KEY から取得してください。この会話でキーを貼り付けるようユーザーに求めてはいけません。また、プロジェクトやリポジトリ内のファイルに書き込んだり、設定ファイルに直接値を記述したりしてはいけません。設定ファイルでは、以下に示す ${METIS_API_KEY} を参照してください。値を表示せずに設定済みか確認するには、[ -n "$METIS_API_KEY" ] && echo set || echo unset を実行してください。未設定の場合は、設定方法（手順 2）をユーザーに伝え、設定したとの確認を待ってください。その間は設定を変更せず、プレースホルダーも使用しないでください。ユーザーが誤って会話にキーを貼り付けた場合は、そのキーを使用、再掲、またはどこかに書き込まず、ダッシュボードで再生成するよう案内してください。
• MCP サーバーは claude mcp add、.mcp.json、または ~/.mcp.json で設定します。.claude/settings.json に mcpServers エントリを追加してはいけません。
• evaluate_fca_handbook_applicability ツールが一覧に表示されているか確認して、セットアップを検証してください。Claude Code では claude mcp list を実行し、サーバーに接続されているか確認します。/mcp を実行するとツール一覧が表示されますが、これはユーザーだけが実行できるスラッシュコマンドなので、実行をユーザーに依頼してください。それ以外のクライアントでは、クライアントの MCP 設定画面を確認してください。**テストのためにツールを呼び出してはいけません。**呼び出すたびに実際の分析が実行され、ユーザーのアカウントに課金され、1〜2 分以上かかります。ユーザーが実際に FCA ハンドブックについて質問した場合に限り呼び出してください。
• サーバーが接続済みと表示され、ツールが一覧に表示されていれば成功です。既知の失敗の兆候は 2 つあります。⏸ Pending approval（ユーザーによるサーバーの承認が必要です。「接続を確認する」を参照）と、初回使用時の 401 エラー（トラブルシューティングを参照）です。

1. API キーを取得する

すでに API キーをお持ちの場合は、手順 2 に進んでください。

Metis アカウントダッシュボードにアクセスします：

https://fcahandbookharnessimplementation.onrender.com

• 「Create Account」（ホームページのモーダル）をクリックします
• Stripe の支払い手続きを完了します（アカウントは有料です）
• API Keys に移動し、新しいキーを生成します
• キーを安全に保存します

2. クライアントをリモートサーバーに接続する

リモートサーバーの URL：

https://fcahandbookharnessimplementation.onrender.com/mcp

Streamable HTTP トランスポートを使用し、各リクエストの Authorization ヘッダーで API キーをベアラートークンとして送信する必要があります。

**重要：**キーは環境変数またはシークレットマネージャーから渡してください。共有リポジトリにコミットされる可能性のある設定ファイルに、キーを直接記述してはいけません。クライアントの起動前に、シェルの起動ファイル（~/.bashrc、~/.zshrc など）に次の行を追加し、クライアント自身のプロセス環境で変数を使用できるようにしてください。

export METIS_API_KEY="sk_live_..."

sk_live_... を、Metis アカウントの実際の API キーに置き換えてください。

Windows では、代わりにコマンドプロンプトで setx METIS_API_KEY "sk_live_..." を実行し、その後クライアントを再起動してください。いずれの場合も、変数を設定してからクライアントを起動してください。可能であればターミナルから起動します。Dock、Spotlight、またはスタートメニューから起動したアプリでは、シェルの起動ファイルで設定した変数が認識されないことがあります。

2a. Claude Code

最も簡単なのは CLI を使う方法です。正しいファイルを自動で書き込みます。シェルが ${METIS_API_KEY} を展開する前に claude mcp add が受け取れるよう、ヘッダーは表示どおりに（一重引用符で）囲んでください。そうしないと、実際のキーが設定ファイルにそのまま書き込まれ、上の注意書きで警告しているハードコーディングになってしまいます。

claude mcp add --transport http --scope user fca-handbook-harness-mcp https://fcahandbookharnessimplementation.onrender.com/mcp --header 'Authorization: Bearer ${METIS_API_KEY}'

プロジェクト専用の設定にするには、--scope user の代わりに --scope project を使用します。ファイルを直接編集する場合は、~/.mcp.json（すべてのプロジェクトに適用）またはプロジェクトのルートにある .mcp.json（そのプロジェクトのみ）に次の内容を記述します。これらは単独のファイルであり、.claude/ 内には置きません。Claude Code は .claude/settings.json 内の mcpServers キーを拒否します。

{
  "mcpServers": {
    "fca-handbook-harness-mcp": {
      "type": "http",
      "url": "https://fcahandbookharnessimplementation.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${METIS_API_KEY}"
      }
    }
  }
}

Claude Code は起動時に、環境変数から ${METIS_API_KEY} を置き換えます。その時点で変数が設定されていない場合、Claude Code はキーとしてリテラル文字列 ${METIS_API_KEY} を送信し（警告も表示します）、実際のキーが間違っていると誤解しやすい 401 エラーが発生します。[ -n "$METIS_API_KEY" ] && echo set を実行して set と表示されるシェルから Claude Code を起動してください。サーバーを追加してもツールが表示されない場合は、Claude Code を再起動してください。

2b. その他のクライアント

Cursor、VS Code（Copilot）、Gemini CLI、Cline、およびその他の開発者向けツールやエージェントフレームワークは、URL とカスタムヘッダーを指定することで、リモート MCP サーバーに接続できます。以下の設定で動作するはずですが、こちらではテストしていません。フィールド名とファイルの場所はクライアントごとに異なり、現在も変更されています。リモート MCP サーバーの追加方法については、ご利用のクライアントのドキュメントに従ってください。

• URL： https://fcahandbookharnessimplementation.onrender.com/mcp
• トランスポート： Streamable HTTP
• ヘッダー： Authorization: Bearer <your API key>。クライアントが対応している場合は、環境変数からキーを読み込んでください。
• タイムアウト： 短い呼び出しには 60～120 秒、完全な呼び出しにはそれ以上かかります。クライアントのデフォルトのタイムアウトが短い場合は、延長してください。

環境変数の参照方法はクライアントごとに異なります。たとえば Cursor では ${env:METIS_API_KEY} が使われますが、Claude Code では ${METIS_API_KEY} が使われます。ご利用のクライアント固有の構文を使用し、キーを直接記述しないでください。

リモートサーバーへの接続で、認証なしまたは OAuth のみを受け付けるクライアントは、静的な API キーを送信できません。そのクライアントではローカルサーバーを使用してください。

3. 接続を確認する

Claude Code の初回実行時のみ： 新規または変更されたプロジェクトスコープの .mcp.json があるプロジェクトで、初めて claude を（-p を付けずに対話形式で）起動すると、接続前に、そのサーバーに対する信頼／承認を求めるプロンプトが一度だけ表示されます。承認するまでは、サーバーは「承認待ち」の状態になり、ツールは実際には使用できません（claude mcp list を実行すると ⏸ Pending approval と表示されます）。プロンプトを承認するか、既存のセッションで /mcp を実行して承認してください。この制限は ~/.mcp.json（グローバルスコープ）には適用されません。

接続すると、エージェントのワークフローで evaluate_fca_handbook_applicability がツールとして使用可能になります。表示されない場合は、以下の「トラブルシューティング」セクションを確認してください。

ツールが一覧にあることを確認してください。接続テストのためだけにツールを呼び出さないでください。呼び出しは毎回実際の分析を実行し、アカウントに課金されます。

代替方法：サーバーをローカルで実行する（stdio）

上記のリモートサーバーにクライアントから接続できない場合は、この方法を使用してください。小規模なローカルサーバーをマシン上で実行し、同じ API キーを使って各呼び出しをホストされた Harness に転送します。Python 3.10 以降が必要です。

ローカルサーバーをインストールする

pip install fca-handbook-harness-mcp

MCP クライアントの設定（ローカル）

以下の mcpServers JSON 形式は、ほとんどのデスクトップ／IDE MCP クライアントで共通ですが、設定ファイルの場所や再起動の手順はクライアントによって異なります。使用しているクライアントに合ったものを選んでください。

重要： Harness API キーは、環境変数またはシークレットマネージャーから実行時に渡してください。共有リポジトリにコミットされる可能性がある設定ファイルに、キーをリテラル値としてハードコードしないでください。2つの方法がサポートされています。必要な MCP 設定が異なるため、どちらか一方を選んでください。

• 方法 A — シェルプロファイル。 MCP クライアント（VS Code、Claude Desktop など）を起動する前に、シェルの起動ファイル（~/.bashrc、~/.zshrc など）に export METIS_API_KEY="sk_live_..." を追加し、クライアント自身のプロセス環境に変数が設定されるようにします。この方法では、MCP 設定で置換を使って変数を参照してください。

  "env": { "METIS_API_KEY": "${METIS_API_KEY}" }
  

• 方法 B — .env ファイル。 プロジェクトディレクトリに METIS_API_KEY=sk_live_... を含む .env ファイルを作成します。サーバーは起動時に（load_dotenv() を介して）このファイルを読み込むため、MCP クライアントにキーの値を渡す必要はありません。この方法では、MCP 設定から env ブロックを完全に省略してください。 方法 A の "${METIS_API_KEY}" の記述をコピーしないでください。クライアント自身の環境にはその変数が設定されていないため、置換はエラーなく失敗し、リテラル文字列 ${METIS_API_KEY} が API キーとして渡されます。その結果、キーが無効または失効していると誤解しやすい 401 エラーが発生します。

⚠️ MCP 設定がプロジェクト内の場所（プロジェクトルートの .mcp.json）ではなくホームディレクトリ（~/.mcp.json）にある場合、その設定はマシン上のすべてのプロジェクトに適用されます。そこに誤って ${METIS_API_KEY} のプレースホルダーを置くと、設定中のプロジェクトだけでなく、すべてのプロジェクトで Harness が動作しなくなります。マシン全体で共有するキーを明確に意図している場合を除き、プロジェクト内の設定ファイルを使用してください。

Claude Code（ローカル）

Claude Code（Claude IDE 拡張機能）は、グローバル（ユーザーレベル）とプロジェクトレベルの両方の MCP 設定に対応しています。注： MCP サーバーは .mcp.json ファイルで設定してください。.claude/settings.json に設定してはいけません。このファイルは権限／環境設定専用であり、mcpServers キーを認識しません（Claude Code は Unrecognized field: mcpServers として拒否します）。

どちらのスコープも、CLI を使って追加するのが最も簡単です。CLI が適切なファイルに書き込みます。${METIS_API_KEY} の参照は、表示どおり（シングルクォートで）囲んでください。そうしないと、claude mcp add が受け取る前にシェルが展開してしまいます。そうなると、実際のキーが設定ファイルにリテラルとして書き込まれますが、これはこのセクション全体で避けようとしているハードコードです。

claude mcp add --scope user fca-handbook-harness-mcp -e 'METIS_API_KEY=${METIS_API_KEY}' -- fca-handbook-harness-mcp

これは方法 A です。以下のように、シェルプロファイルで実際のキーをエクスポートしてください。プロジェクト内に設定する場合は、--scope user の代わりに --scope project を使用します。ファイルを直接編集したい場合、または方法 B（.env）を使いたい場合は、以下を参照してください。

グローバル設定（FS 企業に推奨）

複数のプロジェクトで作業する場合は、MCP をグローバルに設定すると、どこでも利用できるようになります。このファイルはマシン全体で共有されるため、方法 A を使用してください。プロジェクトごとの .env 検索パスは、グローバル設定には適していません。

ファイルの場所： ~/.mcp.json（ホームディレクトリ。.claude/ 内ではなく、単独のファイルです）

~/.mcp.json を編集するか、新規作成して次を追加します。

{
  "mcpServers": {
    "fca-handbook-harness-mcp": {
      "command": "fca-handbook-harness-mcp",
      "env": {
        "METIS_API_KEY": "${METIS_API_KEY}"
      }
    }
  }
}

Claude Code を起動する前に、シェルのプロファイル（例：~/.bashrc、~/.zshrc、~/.fish/config.fish）にも次を追加します。

export METIS_API_KEY="sk_live_..."

sk_live_... を Metis アカウントの実際の API キーに置き換えてください。Claude Code はサーバー起動時に、この環境変数から ${METIS_API_KEY} を置換します。その時点で変数が設定されていない場合、Claude Code は文字列 ${METIS_API_KEY} のままサーバーを読み込みます（その旨の警告も表示されます）。これが、以下のトラブルシューティングで説明する紛らわしい 401 エラーの原因です。

再起動： Claude Code を再起動します。接続されると、evaluate_fca_handbook_applicability ツールがすべてのプロジェクトで利用できるようになります。

プロジェクトレベルの設定（単一プロジェクト向け）

特定の 1 つのプロジェクトでのみ MCP が必要な場合は、プロジェクト単位で設定してください。これは方法 B に適しています。

ファイルの場所： プロジェクトルートの .mcp.json（.claude/ 内ではなく、単独のファイルです）

.mcp.json を編集するか、新規作成して追加します。上記の方法 B に従い、env ブロックは不要です。

{
  "mcpServers": {
    "fca-handbook-harness-mcp": {
      "command": "fca-handbook-harness-mcp"
    }
  }
}

次に、プロジェクトルートに .env ファイルを作成し、次の内容を記述します。

METIS_API_KEY=sk_live_...

sk_live_... を Metis アカウントの実際の API キーに置き換えてください。

重要： プロジェクトレベルの .mcp.json と .env ファイルは、バージョン管理にチェックインされることがよくあります。コミットする前に METIS_API_KEY が .gitignore に含まれていることを確認してください（方法 B では env ブロックを省略するため、.mcp.json 自体に秘密情報は含まれません）。または、代わりにグローバル設定を使用してください（FS 企業に推奨）。

再起動： Claude Code は変更を検出して MCP 接続を自動的に再読み込みします（または IDE を再起動できます）。

Claude Desktop（ローカル）

ファイルの場所：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

Claude Desktop の設定は本質的にマシン全体に適用されます（プロジェクト単位の設定はありません）。そのため、方法 A のほうが一貫性のある選択肢です。ここで方法 B を使う前に、上記の ⚠️ の注意を確認してください。ファイルがすでに存在する場合は、上書きせずに mcpServers エントリを追加してください。Windows では setx で変数を設定し（上記の手順 2 を参照）、Claude Desktop を再起動してください。

方法 A — シェルプロファイル：

{
  "mcpServers": {
    "fca-handbook-harness-mcp": {
      "command": "fca-handbook-harness-mcp",
      "env": {
        "METIS_API_KEY": "${METIS_API_KEY}"
      }
    }
  }
}

Claude Desktop を起動する前に、システム環境（例：~/.bashrc、システム環境設定、または GUI）で METIS_API_KEY を設定します。

export METIS_API_KEY="sk_live_..."

方法 B — .env ファイル： Claude Desktop の実行元ディレクトリに .env ファイルを作成し、METIS_API_KEY=sk_live_... を記述します。そのうえで、上記の設定から env ブロックを完全に省略します（${METIS_API_KEY} のプレースホルダーを残さないでください。上記の方法 B に関する警告を参照してください）。

再起動： Claude Desktop アプリを終了し、再起動します。接続されると、evaluate_fca_handbook_applicability ツールが利用できるようになります。

その他のクライアント（ローカル）

これらのクライアントは通常、上記の Claude Desktop と同じ形式の mcpServers JSON を使用します。設定ファイルの場所、再起動手順、および Claude Code や Claude Desktop のように env ブロック内の ${VAR} を置換するかどうかについては、クライアントのドキュメントを確認してください（JSON ファイルではなく GUI コネクターを使用するものや、置換をまったく行わないものもあります。方法 A に頼る前に確認してください）。

ローカル接続を確認する

上記の接続を確認するを参照してください。プロジェクトスコープの .mcp.json にも、初回実行時の同じ承認手順が適用されます。

ツールの使用方法

ツールは次の2つのパラメーターを受け取ります。

• user_input（必須、最大5000文字）：企業の種類、製品・サービス、ターゲット市場、規制に関する質問などをまとめたテキスト。
• analysis_mode（任意）："quick"（デフォルト、約60～120秒）または "full"（より長く、条件に応じた詳細な推論）。

ツールは次の内容を返します。

• summary：適用可能性の概要（2～3文）
• entry_analysis：推論を含む、取得したFCAハンドブックの項目
• obligations：信頼度の高い義務と、信頼度が低い、または関連性が薄い義務。それぞれに、適用される具体的な条件が付記される場合があります。
• refinement_suggestions：入力から分析できなかった内容とその重要性、および精度向上のために加える具体的な修正
• citations：FCAハンドブックからの引用（原文のまま）。拘束力のレベル（R＝規則、G＝ガイダンス）も示されます。
• tokens：コストや複雑さの追跡に使用する、input、output、totalのトークン数を含むオブジェクト

トラブルシューティング

リモートサーバー：ツールが「Missing API key」または「Invalid or revoked API key」を返す：

• 「Missing API key」は、クライアントがAuthorization: Bearer <key>ヘッダーを送信していないことを意味します。設定のheadersエントリーを確認してください。
• ダッシュボードで有効だと確認したキーで「Invalid or revoked API key」が表示される場合、通常はクライアントの起動時に変数が設定されていなかったため、${METIS_API_KEY}プレースホルダーが置換されなかったことを意味します。[ -n "$METIS_API_KEY" ] && echo setを実行するとsetが出力されるシェルからクライアントを起動してください。それ以外の場合は、余分なスペースや改行を入れずに、ダッシュボードからキーをもう一度コピーしてください。

リモートサーバー：ツールが一覧に表示されない：

• Claude Codeでclaude mcp listを実行してください。⏸ Pending approvalと表示される場合は、サーバーの承認が必要です（上記の「接続の確認」を参照）。サーバーを追加した後、クライアントを再起動してください。
• クライアントがStreamable HTTPトランスポートをサポートし、カスタムのAuthorizationヘッダーを送信できることを確認してください。対応していない場合は、ローカルサーバーを使用してください。

リモートサーバー：呼び出し中に接続が切断される、またはタイムアウトする：

• クイック呼び出しには60～120秒、フル呼び出しにはそれ以上かかります。クライアントのデフォルトのタイムアウトが短い場合は、長く設定してください。クライアントやネットワークがその時間接続を維持できない場合は、代わりにローカルサーバーを使用してください。

Claude Code：「Settings validation failed: Unrecognized field: mcpServers」：

• これは、.claude/settings.json（または~/.claude/settings.json）にmcpServersを追加したことを意味します。このファイルはmcpServersに対応していません。上記のローカル Claude Code のセクションに従って、mcpServersブロックを.mcp.json（プロジェクトローカル）または~/.mcp.json（グローバル）に移動するか、claude mcp add --scope project|user ...を実行してClaude Codeに設定を書き込ませてください。

Claude Code：モデルが「MCP」が存在することを漠然と認識しているようだが、名前や機能がわからず、呼び出しもしない：

• これは初回実行時の承認ゲートの問題であり（上記の「接続の確認」を参照）、ツールの説明の問題ではありません。承認されていないプロジェクトスコープの.mcp.jsonサーバーは実際には接続されないため、モデルは実際の名前、説明、スキーマを受け取らず、汎用的なMCPリソースツールだけを受け取ります。claude mcp listを実行して確認してください（⏸ Pending approvalと表示される場合はこれが原因です）。次に、/mcpを実行するか、claudeを対話形式で再起動して承認してください。

ツールが表示されない（Claude Desktop。同種の問題はほとんどのデスクトップ MCP クライアントでも発生します）：

• 設定ファイルのパスを確認してください（プラットフォーム固有です。上記を参照）。
• コマンドラインでfca-handbook-harness-mcpが解決されることを確認してください（which fca-handbook-harness-mcp／where fca-handbook-harness-mcp）。デスクトップ MCP クライアントは通常、最小限の環境で起動するため、シェルと同じPATHが参照されないことがあります。コマンドが解決されない場合は、"command": "fca-handbook-harness-mcp"を、その確認で得られた絶対パスに置き換えてください。
• MCP クライアントを再起動してください（再読み込みだけでは不十分です）。

ダッシュボードで有効だと確認したキーを使っているのに401 Unauthorizedになる：

• MCP設定に、置換されないままの${METIS_API_KEY}（または同様の）プレースホルダーが残っていないか確認してください。これは、Method B（.env）を使用しているのに、設定にMethod A用のenvブロックが残っている場合に発生します。実際に起動したサーバープロセスの環境を調べ（例：Linuxでは/proc/<pid>/environ）、実際に受け取っている値を確認してください。
• METIS_API_KEYが設定されていることを確認してください。設定のenv（Method A）またはサーバーが見つけられる.envファイル（Method B）のどちらか一方に設定します。両方にも、どちらにも設定しない状態にもならないようにしてください。
• キーが正しいことを確認してください（ダッシュボードからもう一度コピーしてください）。
• キーに余分なスペースや改行がないことを確認してください。

接続タイムアウト：

• 分析には、クイックモードで60～120秒、フルモードではそれ以上かかることがあります。
• fcahandbookharnessimplementation.onrender.comにインターネット経由でアクセスできることを確認してください。

ファイル

• mcp_server.py — MCP サーバーの実装（メインエントリーポイント。ツールのスキーマの正式な情報源は docstring です）
• pyproject.toml — PyPI パッケージマニフェスト
• server.json — MCP レジストリマニフェスト（registry.modelcontextprotocol.io 形式）
• manifest.json — MCPB/Smithery バンドルマニフェスト
• requirements.txt — Python の依存関係（mcp、requests）
• uv.lock — 再現可能な uv run のために固定された依存関係の解決結果
• __init__.py — Python パッケージマーカー
• README.md — このファイル
• LICENSE — MIT ライセンス
• .gitignore — Git の無視ルール
• .mcpbignore — MCPB バンドルから除外されるファイル

サポート

ご質問や問題については、次のアドレスまでお問い合わせください：[email protected]

---

製品： Metis FCA Handbook AI Harness
ライセンス： MIT