Ead Factory Mcp

EAD Factory MCP サーバー

EAD Factory 用の MCP サーバーです。AI エージェントを通じて、適格な証拠、署名、通知、チャットを利用できます。

クイックスタート

npx -y @g-digital/mcp-ead-factory

または、手順を追ったセットアップガイド（5 分以内）については、ONBOARDING.md をご覧ください。

インストール先

この MCP は、g-digital MCP distribution pipeline によって、主要な MCP 配布チャネルすべてで公開されています。ご利用の環境に合ったものを選択してください。

チャネル	インストールコマンド／URL
npm	npx -y @g-digital/mcp-ead-factory — npmjs.com/package/@g-digital/mcp-ead-factory
Docker Hub	docker pull gdigital/ead-factory:latest — hub.docker.com/r/gdigital/ead-factory
MCP Official Registry	io.github.g-digital-by-Garrigues/ead-factory として自動検出されます — registry.modelcontextprotocol.io
n8n community node	n8n Settings → Community Nodes で @g-digital/n8n-nodes-ead-factory をインストールします — npmjs.com/package/@g-digital/n8n-nodes-ead-factory
Smithery	smithery mcp install g-digital/ead-factory — smithery.ai/servers/g-digital/ead-factory

どのチャネルでも同じ MCP サーバーの仕様が提供されます。以下のツールと環境設定は、選択したインストール方法にかかわらず適用されます。

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

インストール

Claude Desktop

{
  "mcpServers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

Claude Code (CLI)

{
  "mcpServers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

Cursor

{
  "mcpServers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

Windsurf

{
  "mcpServers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

Cline

{
  "mcpServers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

VS Code

{
  "servers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

JetBrains

{
  "mcpServers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

Zed

{
  "mcpServers": {
    "ead-factory": {
      "args": [
        "-y",
        "@g-digital/mcp-ead-factory"
      ],
      "command": "npx",
      "env": {
        "MCP_SVC_CLIENT_ID": "<SET_MCP_SVC_CLIENT_ID_HERE>",
        "MCP_SVC_CLIENT_SECRET": "<PASTE_MCP_SVC_CLIENT_SECRET_HERE>",
        "MCP_SVC_TOKEN_URL": "<SET_MCP_SVC_TOKEN_URL_HERE>"
      }
    }
  }
}

認証情報が必要ですか？こちらをご覧ください：https://digitaltrust.gcloudfactory.com

Claude Desktop / Claude Code

~/.claude.json または claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "ead-factory": {
      "command": "npx",
      "args": ["-y", "@g-digital/mcp-ead-factory"],
      "env": {
        "MCP_SVC_TOKEN_URL": "https://your-idp.example.com/oauth2/v1/token",
        "MCP_SVC_CLIENT_ID": "your-client-id",
        "MCP_SVC_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Docker

docker run --rm -i \
  -e MCP_SVC_TOKEN_URL=https://your-idp.example.com/oauth2/v1/token \
  -e MCP_SVC_CLIENT_ID=your-client-id \
  -e MCP_SVC_CLIENT_SECRET=your-client-secret \
  gdigital/ead-factory:latest

環境変数

名前	必須	シークレット	説明
MCP_ALLOW_INSECURE_FILE_URL	いいえ	いいえ	evidence_create でプレーンな http:// の fileUrl ダウンロードを許可するには、"true" に設定します（デフォルトは HTTPS のみ）。プライベート／内部アドレスは、いずれの場合も拒否されます（解決時のチェックです。ホステッドデプロイのランブックに記載されている DNS TOCTOU の制限を参照してください）。
MCP_ALLOW_UNVERIFIED_BEARER	いいえ	いいえ	MCP_HTTP_PUBLIC=true で受信トークンのイントロスペクションを行わない場合の回避策です。上流ゲートウェイがすでに Bearer トークンを検証している場合に限り、"true" に設定してください。サーバーは目立つ警告をログに記録し、未検証のトークンを上流に転送します。
MCP_ALLOWED_HOSTS	いいえ	いいえ	許可する Host ヘッダーをカンマ区切りで指定します。空の場合は Host の検証を無効にします（デフォルト）。設定すると、リストにない Host を含むリクエストは拒否されます。
MCP_ALLOWED_ORIGINS	いいえ	いいえ	許可するブラウザー Origin をカンマ区切りで指定します（DNS リバインディング対策）。空の場合、Origin ヘッダーを含むリクエストはすべて拒否されます。ブラウザー以外のクライアント（CLI／SDK）は Origin を送信しないため、常に許可されます。すべてを許可するには '*' を使用します。
MCP_API_BASE_URL	いいえ	いいえ	ゲートウェイのルート URL（例：https://api.int.gcloudfactory.com）です。各マネージャーのパスプレフィックスは自動的に追加されます。ここにマネージャーのパスを含めないでください。
MCP_API_BASE_URL_CHAT	いいえ	いいえ	チャットマネージャーの完全なベース URL の上書き値です。そのまま使用されます（デフォルト：https://api.gcloudfactory.com/chat-bot-manager）。
MCP_API_BASE_URL_EVIDENCE	いいえ	いいえ	エビデンスマネージャーの完全なベース URL の上書き値です。そのまま使用されます（デフォルト：https://api.gcloudfactory.com/digital-trust）。
MCP_API_BASE_URL_NOTIFICATION	いいえ	いいえ	通知マネージャーの完全なベース URL の上書き値です。そのまま使用されます（デフォルト：https://api.gcloudfactory.com/notifications）。
MCP_API_BASE_URL_SIGNATURE	いいえ	いいえ	署名マネージャーの完全なベース URL の上書き値です。そのまま使用されます（デフォルト：https://api.gcloudfactory.com/signature-manager）。
MCP_HTTP_HOST	いいえ	いいえ	HTTP トランスポートがバインドするインターフェースです。デフォルトは 127.0.0.1（ローカルホストのみ）です。すべてのインターフェースで公開するには 0.0.0.0 に設定します（コンテナーでは自動的に設定されます）。
MCP_HTTP_MAX_BODY_BYTES	いいえ	いいえ	POST /mcp リクエストボディの最大許容サイズ（バイト単位）です（デフォルトは 16777216 = 16 MiB。ドキュメントに記載されたツールの制限内で、Base64 ファイルのアップロードが収まるよう設定されています）。サイズ超過のリクエストは、読み取りの前または読み取り中に 413 JSON-RPC エラーとなります。これにより、公開デプロイでメモリ枯渇を引き起こす DoS 攻撃の経路を塞ぎます。注：Base64 ファイルソースには、MCP_FILE_MAX_BYTES が適用される前に、この上限が適用されます。
MCP_HTTP_PUBLIC	いいえ	いいえ	公開／マルチテナント環境にデプロイする場合は、"true" に設定します。Host 検証が有効になり、（1）MCP_ALLOWED_ORIGINS または MCP_ALLOWED_HOSTS が設定され、かつ（2）受信 Bearer のイントロスペクションが構成されている（MCP_SVC_INTROSPECT_URL と MCP_SVC_CLIENT_ID/SECRET）、または MCP_ALLOW_UNVERIFIED_BEARER=true が明示的に設定されていない限り、起動を拒否します（フェイルクローズ）。
MCP_SVC_CLIENT_ID	はい	いいえ	OAuth2 client_credentials のクライアント ID です。
MCP_SVC_CLIENT_SECRET	はい	はい	OAuth2 client_credentials のクライアントシークレットです。（認証情報の取得については https://digitaltrust.gcloudfactory.com を参照してください。）
MCP_SVC_INTROSPECT_URL	いいえ	いいえ	HTTP モードで受信 Bearer を検証するための RFC 7662 トークンイントロスペクション URL です。任意設定であり、MCP_HTTP_PUBLIC=true の場合は必須です。stdio（ローカル）で使用する場合は空のままにしてください。
MCP_SVC_SCOPE	いいえ	いいえ	サービスアカウントのトークンリクエストに指定する任意の OAuth2 スコープです。
MCP_SVC_TOKEN_URL	はい	いいえ	OAuth2 client_credentials フローのトークンエンドポイント URL です。
PORT	いいえ	いいえ	ホステッド（HTTP）モードで実行する場合の HTTP ポートです。stdio モードでは無視されます。
変数	必須	説明
---	---	---
MCP_SVC_TOKEN_URL	必須	OAuth2 クライアントクレデンシャルのトークンエンドポイント URL
MCP_SVC_CLIENT_ID	必須	OAuth2 クライアント ID
MCP_SVC_CLIENT_SECRET	必須	OAuth2 クライアントシークレット
MCP_SVC_SCOPE	任意	トークンリクエストの OAuth2 スコープ
MCP_OTEL_ENABLED	任意	OpenTelemetry トレースを有効にするには true を設定します
MCP_API_BASE_URL	任意	ゲートウェイのルート URL — 各マネージャーのパスプレフィックスは自動的に追加されます。マネージャーごとの URL を完全に上書きするには MCP_API_BASE_URL_<MANAGER> を使用します（そのまま使用されます）

同梱のスキル

このパッケージには、.claude/commands/ 配下に Claude Code のスラッシュコマンドが含まれています。インストール後、Claude Code から実行できます。

• /create-internal-evidence — 手順を追ったワークフローガイド
• /create-signature-request — 手順を追ったワークフローガイド
• /create-notification-request — 手順を追ったワークフローガイド

エンドツーエンドのプロンプト例と、それによって実行されるツールの順序については、docs/agent-prompts.md を参照してください。

REST API を直接利用したコードの作成をご希望ですか？

この MCP サーバーを経由する必要はありません。このリポジトリには Claude Code スキル も含まれています。これは REST API を直接利用したプログラミングのための、独立した統合ガイドです（認証、呼び出し順序、オプション、列挙値、注意点）。

• スキル： .claude/skills/ead-factory-api/SKILL.md — このリポジトリを Claude Code で開くと、そのまま利用できます。
• リファレンス： docs/api-integration-skill.md。

MCP ツールや n8n ノードとは独立しています。統合に適したエントリーポイントを選んでください。

利用可能なツール

このサーバーでは 64 個のツールを公開しています。

ツール	説明
evidence_case_file_delete_bulk	1 回の呼び出しで複数のケースファイルを完全に削除します。破壊的な操作であり、元に戻せません。まず caseFileIds を確認し（evidence_case_file_search）、作業を終了するだけの場合は evidence_case_file_status_update でケースファイルを閉じることを優先してください。
evidence_case_file_search	任意のフィルター（名前、ステータス、日付、ページネーション）を指定してケースファイルを検索します。caseFileId が分からない場合に探すときや、evidence_case_file_create で新しいケースファイルを作成する前に既存のものを一覧表示するときに使用します。
evidence_case_file_create	新しいケースファイルを作成します。これは証拠グループ、証拠、レポートの最上位コンテナーです。他の Evidence-manager ツールを使用する前に、最初に実行してください。前提条件はありません。ほとんどの作成ツールとは異なり、id は呼び出し元が指定します（新しい UUID v4 を自分で生成してください。この API は割り当てません）。name フィールドはないため、代わりに title を使用してください。例：evidence_case_file_create({ id: '', title: 'Q1 2026 audit' }) — 同じ id を evidence_group_create の caseFileId として使用してください。
evidence_case_file_update_bulk	1 回の呼び出しで複数のケースファイルの編集可能なメタデータを更新します（各エントリーにはそれぞれの caseFileId と変更内容が含まれます）。単一のケースファイルには evidence_case_file_update を優先してください。必要なもの：更新するすべてのケースファイルの caseFileIds（evidence_case_file_search で検索してください）。
evidence_case_file_get	id を指定してケースファイルの詳細を取得します。ケースファイルが存在することの確認や、その配下に証拠グループまたはレポートを作成する前のステータス確認に使用します。必要なもの：evidence_case_file_create → caseFileId。
evidence_case_file_update	単一のケースファイルの編集可能なメタデータ（名前、説明など）を更新します。必要なもの：evidence_case_file_create または evidence_case_file_search → caseFileId。OPEN/CLOSE のライフサイクル状態を変更するには、代わりに evidence_case_file_status_update を使用してください。
evidence_case_file_relationship_assign	ケースファイルに関連付けを割り当て、追跡可能性のために外部または関連するエンティティ参照とリンクします。ワークフローで、どの案件、クライアント、またはシステムレコードに属するかを追跡する場合は、ケースファイルの作成後に使用してください。必要なもの：evidence_case_file_create → caseFileId。
evidence_case_file_report_preview	ケースファイルの証拠レポートの未署名プレビューを生成します。evidence_case_file_report_generate で署名済みバージョンを作成する前に内容を確認できます。必要なもの：evidence_case_file_create → caseFileId。配下に封印済みの証拠グループが必要です。
evidence_case_file_report_generate	ケースファイルの署名済み証拠レポート（封印済み証拠をまとめた認証文書）を生成します。reportId が返されます。ダウンロードするには、その後 evidence_case_file_report_pdf_url_get（PDF）または evidence_case_file_report_zip_url_get（完全なパッケージ）を呼び出してください。必要なもの：evidence_case_file_create → caseFileId。先に evidence_case_file_report_preview でプレビューしてください。
evidence_case_file_report_update	以前に生成したケースファイルレポートのメタデータを更新します。必要なもの：evidence_case_file_report_generate → reportId（およびそのレポートが属する caseFileId）。レポートの内容は再生成されません。証拠を更新した場合は、新しいレポートを生成してください。
evidence_case_file_report_pdf_url_get	ケースファイルレポートの署名済み PDF 文書のダウンロード URL を取得します。必要なもの：evidence_case_file_report_generate → reportId（および caseFileId）。完全な証拠パッケージ（PDF + ファイル + 検証データ）には evidence_case_file_report_zip_url_get を使用してください。
evidence_case_file_report_zip_url_get	ケースファイルレポートの完全な ZIP パッケージ（署名済み PDF と証拠ファイル、検証資料）のダウンロード URL を取得します。必要なもの：evidence_case_file_report_generate → reportId（および caseFileId）。
evidence_case_file_status_update	ケースファイルのライフサイクルステータス（OPEN または CLOSE）を変更します。ケースファイルでの作業が終了し、新しい証拠グループを受け付けないようにする場合は CLOSE を使用してください。OPEN で再開できます。必要なもの：evidence_case_file_create または evidence_case_file_search → caseFileId。
evidence_report_delete	reportId を指定して、生成済みレポートを完全に削除します。破壊的な操作です。署名済み文書とそのパッケージはダウンロードできなくなります。必要なもの：evidence_case_file_report_generate → reportId。元のケースファイルと証拠には影響しません。
evidence_group_evidence_register	グループに新しい証拠を登録します。2 段階アップロードの最初の手順です（登録後、返されたアップロード URL にファイルのバイトデータを PUT します）。OPEN な証拠グループに追加する各ファイルに使用してください。必要なもの：evidence_group_create → evidenceGroupId、evidence_case_file_create → caseFileId、ファイルの SHA-256 ハッシュ（呼び出し前に計算するか、代わりに自動で計算する複合ツール evidence_create_sealed を使用してください）。登録済みのすべての証拠のバイトデータがアップロードされるまで、evidence_group_close を呼び出さないでください。保管タイプ：INTERNAL = EAD Factory がファイルそのものを保存・保管します。
evidence_group_evidence_get	特定の証拠グループ内にある 1 件の証拠の詳細（メタデータ、ハッシュ、保管方法、アップロード状態）を取得します。必要なもの：evidence_case_file_create → caseFileId、evidence_group_create → evidenceGroupId、evidence_group_evidence_register → evidenceId。
evidence_group_evidence_delete	証拠グループから 1 件の証拠を完全に削除します。グループがまだ OPEN の間のみ実行できます（封印済みのグループは変更できません）。必要なもの：caseFileId + evidenceGroupId + evidence_group_evidence_register → evidenceId。
evidence_group_evidence_download_url_create	グループに保存された証拠ファイル（INTERNAL 保管）の一時ダウンロード URL を作成します。アップロード後に元のバイトデータを取得する場合に使用します。必要なもの：caseFileId + evidenceGroupId + evidence_group_evidence_register → evidenceId。
evidence_group_evidence_upload_url_create	グループ内の登録済み証拠に対する新しい署名付きアップロード URL を作成します。登録後にアップロードするフローの第 2 手順です（返された URL にファイルのバイトデータを PUT します）。evidence_group_evidence_register から取得した URL の有効期限が切れた場合や、紛失した場合に使用します。必要なもの：caseFileId + evidenceGroupId + evidenceId。evidence_create_sealed はこれらをすべて自動で実行します。
evidence_thumbnail_url_get	画像証拠のサムネイルについて、指定サイズの一時 URL を取得します。元のファイルをダウンロードせず、すばやく視覚的に確認できます。必要なもの：caseFileId + evidenceGroupId + evidenceId（画像タイプの証拠のみ）と、thumbnailSize パス値。
evidence_search	任意のフィルター（状態、日付、ページネーション）を指定して、テナント全体の証拠を検索します。特定のグループに限定されません。evidenceId の検索や既存証拠の監査に使用してください。1 つのグループの内容には evidence_group_get を使用します。
generate_evidence	新しい証拠を登録します（従来の最上位名です。evidence_group_evidence_register とは異なり、作成時に特定の証拠グループには限定されません）。グループベースのフロー外で単独の証拠を扱う場合や、従来の EAD-Factory-MCP 統合との互換性を維持する場合に使用します。ファイルの SHA-256 ハッシュが必要です。新しい完全な証拠グループ + 証拠 + 封印のフローには evidence_create_sealed を優先してください。保管タイプ：INTERNAL = EAD Factory がファイルそのものを保存・保管します。
evidence_update_bulk	1 回の呼び出しで複数の証拠の編集可能なメタデータを更新します（各エントリーにはそれぞれの evidenceId と変更内容が含まれます）。単一の証拠には evidence_update を優先してください。必要なもの：更新する evidenceIds（evidence_search で検索してください）。
get_evidence	id を指定して、証拠レコードの詳細とステータスを取得します（従来の最上位名です）。登録後に証拠のタイムスタンプ処理ステータス（IN_PROCESS / COMPLETED / ERROR）を確認する場合に使用します。必要なもの：generate_evidence または evidence_group_evidence_register → evidenceId。
evidence_delete	evidenceId を指定して 1 件の証拠を完全に削除します（グループのパスは不要です）。破壊的な操作です。封印済みの内容は削除しないでください。下書きまたは誤って登録した証拠にのみ使用します。必要なもの：evidence_group_evidence_register または generate_evidence → evidenceId。
evidence_update	evidenceId を指定して、単一の証拠の編集可能なメタデータ（名前、説明など）を更新します。ファイルの内容とハッシュは変更できません。ファイルを変更する場合は、新しい証拠を再登録してください。必要なもの：evidence_group_evidence_register または generate_evidence → evidenceId。
evidence_download_url_create	evidenceId のみを持っている場合に、証拠の保存済みファイルの一時ダウンロード URL を作成します（グループのパスは不要です。evidence_group_evidence_download_url_create と同じバイトデータを返します）。必要なもの：generate_evidence または evidence_group_evidence_register → evidenceId。
evidence_upload_url_create	evidenceId を指定して、登録済み証拠の新しい署名付きアップロード URL を作成します。登録後にアップロードするフローの第 2 手順です（返された URL にファイルのバイトデータを PUT します）。generate_evidence に対するこのツールの関係は、evidence_group_evidence_upload_url_create と evidence_group_evidence_register の関係と同じです。必要なもの：generate_evidence → evidenceId。
evidence_temp_file_upload_url_create	まだ証拠として登録されていない一時ファイルの署名付きアップロード URL を作成します。別の操作から参照するコンテンツの一時保存に使用してください。実際の証拠には、登録とアップロードをまとめて処理する登録後アップロードフロー（evidence_group_evidence_register）または複合ツール evidence_create_sealed を優先してください。
evidence_multipart_upload_start	大容量の証拠ファイル用にマルチパートアップロードセッションを開始します（ファイルを分割してアップロードするための座標を返します）。単一の署名付き PUT ではファイルサイズに対応できない場合に使用してください。必要なもの：登録済みの証拠（evidence_group_evidence_register または generate_evidence → evidenceId）とファイル名。
evidence_group_delete_bulk	1 回の呼び出しで、1 つのケースファイルにある複数の証拠グループを完全に削除します。破壊的な操作です。単一のグループには evidence_group_discard を優先し、発行済みレポートの根拠となる封印済みグループは決して削除しないでください。必要なもの：caseFileId + 削除する evidenceGroupIds（evidence_group_search で検索してください）。
evidence_group_create	ケースファイル内に証拠グループを作成します。従来の generate_evidence ツールを除き、証拠レコードは必ずグループ内に登録され、単独では登録されません。関連する証拠の新しいまとまり（たとえば、1 つのインシデントに関するすべてのファイル）を開始するときに使用します。evidence_case_file_create と同様に、id は呼び出し元が指定します（新しい UUID v4 を自分で生成してください）。必要なもの：evidence_case_file_create → caseFileId。例：evidence_group_create({ id: '', caseFileId, type: 'FILE' }) は { status: 'OPEN', ... } を返します。同じ id を evidence_group_evidence_register の evidenceGroupId として使用し、グループ内のすべての証拠のアップロード完了後に evidence_group_close を呼び出してください。
evidence_group_get	1 つの証拠グループの詳細（ステータス（OPEN/CLOSED）、封印情報、アップロード状態を含む証拠）を取得します。evidence_group_close の前にすべてのファイルがアップロードされたことを確認する場合や、クローズ後に封印を確認する場合に使用します。必要なもの：caseFileId + evidence_group_create → evidenceGroupId。
evidence_group_discard	OPEN な証拠グループとその登録済み証拠を破棄（削除）します。封印する予定がなくなったグループを破棄する場合に使用してください。破壊的な操作です。封印済み（CLOSED）のグループは変更できない証拠であり、破棄しないでください。必要なもの：caseFileId + evidence_group_create → evidenceGroupId。
evidence_group_update	証拠グループの編集可能なメタデータ（名前、説明など）を更新します。意味があるのはグループが OPEN の間のみです。封印済みのグループは変更できません。必要なもの：caseFileId + evidence_group_create → evidenceGroupId。
evidence_group_close	証拠グループを封印（クローズ）し、適格なタイムスタンプ処理を開始します。この後は証拠を追加できません。グループに登録したすべての証拠のファイルのバイトデータが、evidence_group_evidence_register で返された署名付き URL にアップロードされた後にのみ使用してください。必要なもの：evidence_group_create → evidenceGroupId、evidence_case_file_create → caseFileId、現在の evidencesCount。非同期処理：グループは OPEN → CLOSING → CLOSED と遷移します。レポートを生成する前に、ステータスが CLOSED になるまで evidence_group_get をポーリングしてください。新しいグループには複合ツール evidence_create_sealed を優先してください。このツールは 1 回の呼び出しで登録、アップロード、クローズを行い、CLOSED になるまで待機します。
evidence_group_search	任意のフィルター（ステータス、日付、ページネーション）を指定して、ケースファイル全体の証拠グループを検索します。evidenceGroupId の検索や封印待ちのグループの一覧表示に使用してください。1 つのグループの詳細には evidence_group_get を使用します。
evidence_group_update_bulk	1 回の呼び出しで複数の証拠グループの編集可能なメタデータを更新します（各エントリーにはそれぞれの evidenceGroupId と変更内容が含まれます）。単一のグループには evidence_group_update を優先してください。必要なもの：更新する evidenceGroupIds（evidence_group_search で検索してください）。
evidence_report_pdf_url_get	reportId のみを持っている場合に、レポートの署名済み PDF のダウンロード URL を取得します（caseFileId のパスは不要です。evidence_case_file_report_pdf_url_get が返すものと同じ文書です）。必要なもの：evidence_case_file_report_generate → reportId。
evidence_report_zip_url_get	reportId のみを持っている場合に、レポートの完全な ZIP パッケージのダウンロード URL を取得します（evidence_case_file_report_zip_url_get が返すものと同じパッケージです）。必要なもの：evidence_case_file_report_generate → reportId。
create_signature_request	新しい署名リクエストを作成します。署名フローにおける文書と署名者の最上位コンテナーです。add_document_to_signature_request の前に、最初に実行してください。前提条件はありません。例：create_signature_request({ name: 'NDA — Acme Corp', createdBy: '[email protected]' }) は { id, ... } を返します。以降の呼び出しでは、返された id を signatureRequestId として使用してください。
add_document_to_signature_request	署名リクエストに文書を追加します。2 段階アップロードの最初の手順です（追加後、返されたアップロード URL にファイルのバイトデータを PUT します）。署名が必要な文書ごとに 1 回使用してください。必要なもの：create_signature_request → signatureRequestId、文書の SHA-256 ハッシュ（呼び出し前に計算するか、複合ツール signature_request_full を使用してください）。有効化する前に add_signatory_to_document で署名者を追加してください。署名タイプ：INTERPOSITION = EAD Factory が署名者に代わって署名行為を仲介します（たとえば、WhatsApp/SMS で OTP を送信します）。署名者はソフトウェアも証明書も必要ありません。
add_signatory_to_document	署名リクエスト内の文書に、署名者（名前 + メールアドレス）を追加します。その文書への署名が必要な人ごとに 1 回使用してください。必要なもの：create_signature_request → signatureRequestId、add_document_to_signature_request → documentId。activate_signature_request を呼び出す前にすべての署名者を追加してください。有効化後に署名者を追加することはできません。
add_validator_to_signatory	文書の署名者に検証者を追加します。検証者は、署名を進める前に、その署名者の本人確認または文書を承認（検証）する必要がある人です。activate_signature_request の前に検証者を追加してください。必要なもの：add_document_to_signature_request → documentId、add_signatory_to_document → signatoryId。複合ツール signature_request_full では、検証者をインラインで指定できます。
add_observer_to_document	署名リクエストの文書にオブザーバーを追加します。オブザーバーは署名せずに、プロセスと署名済みの結果を読み取り専用で確認できます。activate_signature_request の前にオブザーバーを追加してください。必要なもの：create_signature_request → signatureRequestId、add_document_to_signature_request → documentId。
activate_signature_request	署名リクエストを有効化し、追加済みのすべての署名者に署名通知を送信します。この後は文書も署名者も追加できません（検証者やオブザーバーが必要な場合は、有効化前に add_validator_to_signatory / add_observer_to_document を使用してください）。必要なもの：create_signature_request → signatureRequestId、バイトデータのアップロードが完了した文書が少なくとも 1 件（add_document_to_signature_request）、各文書に署名者が少なくとも 1 人（add_signatory_to_document）。新しいリクエストには signature_request_full を優先してください。このツールは 1 回の呼び出しで作成、文書と署名者の追加、有効化を行います。
get_signature_request	id を指定して署名リクエストの詳細とステータスを取得します（従来の最上位名です）。有効化後に署名の進捗を確認する場合に使用します。必要なもの：create_signature_request → signatureRequestId。
signature_request_list	署名リクエストの一覧を取得します。クローズ条件などで絞り込むこともできます。id が分からないリクエストを（名前やステータスなどで）探す場合に使用します。署名リクエストのクローズ条件：ALL_REQUIRED = すべての署名者が署名した場合にのみリクエストがクローズします。
signature_request_cancel	アクティブな署名リクエストをキャンセルします。以降、署名は行えません。誤って有効化した場合や、不要になった場合に使用してください。必要なもの：create_signature_request → signatureRequestId。取り消すことはできません。
signature_certificate_generate	署名リクエストの正式な署名済み外観証明書を生成します。すべての署名者が署名した後に 1 回使用してください（get_signature_request で確認してください）。必要なもの：create_signature_request → signatureRequestId。EAD Enterprise の同等ツール（すでに生成された URL をポーリングする GET）とは異なり、このツールは生成を開始し、同じ呼び出しで結果を返します。
signature_coordinate_set	文書上で署名者の署名を配置する座標（x、y、ページ）を設定します。自動配置ではなく署名位置を明示する必要がある場合は、add_signatory_to_document の後に使用してください。必要なもの：create_signature_request → signatureRequestId、add_document_to_signature_request → documentId、add_signatory_to_document → signatoryId。
signature_document_download_url_get	最終版の正式な署名済み文書のダウンロードリンク（すべての署名者が署名した後の実際の署名済みファイル）を取得します。必要なもの：create_signature_request → signatureRequestId、add_document_to_signature_request → documentId。呼び出す前に get_signature_request を使用し、署名が完了していることを確認してください。署名済み文書そのものではなく、別個の外観証明書文書を生成する signature_certificate_generate と混同しないでください。
notification_request_create	新しい通知リクエスト（下書き）を作成します。認証付き通知フローにおける受信者と添付ファイルの最上位コンテナーです。他の Notification-manager ツールを使用する前に、最初に実行してください。前提条件はありません。autosend: true を設定すると、最初の受信者バッチの有効化時にすぐ送信されます。false のままにすると、複数回の呼び出しで受信者や文書を追加してから、自分で notification_request_send を呼び出せます。requestId と、すでにリクエストに含まれている各受信者につき 1 つの notificationId を返します（受信者がインラインで指定されている場合）。
notification_request_send	通知リクエストを有効化し、追加済みのすべての受信者に設定済みのチャネル経由で配信を開始します。MCP Task として実行されます（すべての受信者の通知が処理中状態を抜けるまで、制限付きでポーリングします。EAD Factory の上流システムはこの遷移についてイベントを発行しません）。必要なもの：notification_request_create → requestId、少なくとも 1 人の受信者（notification_receiver_add）。Task の完了を待たずに進捗を確認するには notification_request_status を使用してください。
notification_request_status	通知を検索します。requestId や配信状態で絞り込むこともできます。「リクエストのステータス確認」に最も近い機能です。リクエストは受信者ごとに 1 件の通知に分かれ、それぞれに独自の状態履歴があるため、フィルターに一致する各通知の現在の状態を返します。すべてのリクエストを検索する場合は requestId を省略してください。必要なもの：notification_request_create → requestId（特定のリクエストに絞り込む場合）。
notification_receiver_add	下書きの通知リクエストに 1 人以上の受信者を追加します。各受信者は、共有の requestId の下でチャネルごとに独立した通知になります（個別の receiverId はありません。この呼び出しが返す notificationIds で受信者を追跡してください）。notification_request_send を呼び出す前に、受信者の各バッチに対して 1 回使用します。必要なもの：notification_request_create → requestId。各受信者の形式は provider（SMTP/SMS/NOTICEMAN/WFB）によって異なります。各形式に必要なフィールドについてはスキーマを参照してください。通知配信プロバイダー：SMTP = メール配信。
notification_document_add	下書きの通知リクエストに文書の添付ファイルを 1 件以上登録します（メタデータのみ。fileName + SHA-256 ハッシュ）。有効化する前に、文書の各バッチに対して 1 回使用してください。必要なもの：notification_request_create → requestId。これはメタデータを登録するだけです。登録済みの添付ファイルごとに notification_document_upload_url_create を呼び出し、実際のファイルのバイトデータを PUT する URL を取得してください。
notification_document_upload_url_create	notification_document_add で登録済みの文書添付ファイルに対する署名付きアップロード URL を作成します。返された URL にファイルのバイトデータを PUT してください。必要なもの：notification_request_create → requestId、notification_document_add → attachmentId。
notification_document_download_url_create	通知リクエストの文書添付ファイルに対する署名付きダウンロード URL を作成します。必要なもの：notification_request_create → requestId、notification_document_add → attachmentId。
notification_certificate_generate	リクエスト内の 1 件以上の通知に対する配信証明レポートを生成します。notification_request_status で対象の通知が処理中状態を抜けたことを確認してから使用してください。必要なもの：notification_request_create → requestId、notification_request_status → notificationIds。reportId が返されます。実際のダウンロード URL を取得するには notification_certificate_pdf_url_get を呼び出してください（Evidence のレポートツールと同じ形式の 2 段階フローです）。
notification_certificate_pdf_url_get	以前に生成した通知配信証明書のダウンロード URL を取得します。必要なもの：notification_certificate_generate → reportId。
evidence_create_sealed	証拠グループを作成（または再利用）し、1 つ以上のファイルを証拠として登録・アップロードしてから、グループを封印（クローズ）します。evidence_group_create + N x (evidence_group_evidence_register + upload) + evidence_group_close の代わりに、主要な証拠フロー全体を 1 回の呼び出しで実行します。グループが CLOSED になるまで制限付きでポーリングします（EAD Factory の上流システムはこの遷移についてイベントを発行しません）。非同期 Task に対応した MCP クライアントでは非同期 Task が実行され、それ以外のクライアントには最終結果が同期的に返されます。必要なもの：case_file_create -> caseFileId。新しいグループを作成する代わりに既存の OPEN なグループに追加するには、evidenceGroupId を指定してください。各証拠のファイルには共通の FileInput コントラクト（ローカルパス、base64、https URL、または n8n バイナリーアイテム）を使用してください。専用のファイルフィールドは使用しないでください。成功すると、グループの id、最終ステータス CLOSED、各証拠の id + sha256 が返されます。各中間手順を確認または処理する必要がある場合は、代わりに個別の evidence_group_create / evidence_group_evidence_register / evidence_group_close ツールを使用してください。
signature_request_full	署名リクエストを作成し、1 つ以上の文書（それぞれに署名者を指定）を追加して有効化します。create_signature_request + N x (add_document_to_signature_request + add_signatory_to_document) + activate_signature_request の代わりに、主要な署名フロー全体を 1 回の呼び出しで実行します。各文書のファイルには共通の FileInput コントラクト（ローカルパス、base64、https URL、または n8n バイナリーアイテム）を使用してください。専用のファイルフィールドは使用しないでください。activate: false を設定すると、リクエストを下書きのままにして、自分で有効化する前に検証者またはオブザーバー（add_validator_to_signatory、add_observer_to_document）を追加できます。成功すると、リクエスト id、各文書の id、各署名者の id が返されます。各中間手順を確認または処理する必要がある場合や、有効化前に検証者またはオブザーバーが必要な場合は、代わりに個別のツールを使用してください。
ead_factory_help	EAD Factory のマネージャー（Evidence、Signature、Notification、Chat）、主要なツールと開始点、および複合ワークフローツール（evidence_create_sealed など）と個別ツールを使い分ける際のガイダンスの概要を返します。使用するツールが分からない場合は、最初に呼び出してください。認証情報は不要です。

MCP Tasks のサポート

notification_request_send は MCP Task として実行され、MCP Tasks をサポートするクライアントが必要です。それ以外のクライアントから呼び出すと失敗します。その場合は、autosend: true を指定してリクエストを作成（notification_request_create）し、自分で notification_request_status をポーリングしてください。

evidence_create_sealed はどのクライアントからでも利用できます。Task に対応したクライアントでは非同期 Task が実行され、それ以外のクライアントでは最終結果がそのまま同期的に返されます。

共存

この MCP サーバーは、EAD Factory（Digital Trust）プラットフォーム向けの現行の、積極的に保守されているインターフェースです。

セットアップ内の他の MCP サーバーとも安全に共存します。EAD-Factory 名前空間のツールのみを公開し、他のサーバーとローカル状態を共有しません。

ライセンス

MIT — LICENSE を参照してください。