GoCertius MCP

GoCertius MCP サーバー

AI エージェントを通じて、認証済みの証拠、案件ファイル、通知、チャットを利用できる GoCertius 用 MCP サーバーです。

クイックスタート

npx -y @g-digital/mcp-gocertius

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

インストール先

この MCP は、g-digital MCP distribution pipelineによって、主要なすべての MCP 配布チャネルで公開されています。お使いのスタックに合ったものを選んでください。

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

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

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

インストール

Claude Desktop

{
  "mcpServers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

Claude Code（CLI）

{
  "mcpServers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

Cursor

{
  "mcpServers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

Windsurf

{
  "mcpServers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

Cline

{
  "mcpServers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

VS Code

{
  "servers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

JetBrains

{
  "mcpServers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

Zed

{
  "mcpServers": {
    "gocertius": {
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "command": "npx",
      "env": {
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io",
        "MCP_AUTH_USER_KEY": "<PASTE_MCP_AUTH_USER_KEY_HERE>"
      }
    }
  }
}

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

Claude Desktop／Claude Code

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

{
  "mcpServers": {
    "gocertius": {
      "command": "npx",
      "args": ["-y", "@g-digital/mcp-gocertius"],
      "env": {
        "MCP_AUTH_USER_KEY": "your-user-key",
        "MCP_API_BASE_URL": "https://api-gocertius.gocertius.io"
      }
    }
  }
}

Docker

docker run --rm -i \
  -e MCP_AUTH_USER_KEY=your-user-key \
  -e MCP_API_BASE_URL=https://api-gocertius.gocertius.io \
  gdigital/gocertius: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	はい	いいえ	上流 API のルートです。必須です。ユーザーキーはこのホストに対してセッショントークンと交換されるため、これを設定しないとサーバーは起動しません。
MCP_AUTH_USER_KEY	はい	はい	有効期間の長い GoCertius ユーザーキーです。短期間有効なセッショントークンと自動的に交換されます。ヘッドレスアクセスや自動化されたアクセスでは、アカウントのパスワードの代わりに使用してください。（認証情報の取得については https://www.gocertius.io を参照してください。）
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	いいえ	いいえ	このサーバーが上記のイントロスペクションエンドポイントに提示するクライアント ID（リソースサーバーの認証情報）です。MCP_SVC_INTROSPECT_URL と併用する場合にのみ必要です。GoCertius への認証には使用されません。
MCP_SVC_CLIENT_SECRET	いいえ	はい	このサーバーが上記のイントロスペクションエンドポイントに提示するクライアントシークレット（リソースサーバーの認証情報）です。MCP_SVC_INTROSPECT_URL と併用する場合にのみ必要です。GoCertius への認証には使用されません。（認証情報の取得については https://www.gocertius.io を参照してください。）
MCP_SVC_INTROSPECT_URL	いいえ	いいえ	HTTP モードで受信 Bearer を検証するための RFC 7662 トークンイントロスペクション URL です。オプトイン設定であり、MCP_HTTP_PUBLIC=true の場合は必須です。stdio（ローカル）で使用する場合は空のままにしてください。
PORT	いいえ	いいえ	ホスト型（HTTP）モードで実行する場合の HTTP ポートです。stdio モードでは無視されます。

変数	必須	説明
MCP_AUTH_USER_KEY	必須	有効期間の長いユーザーキー（セッショントークンと交換されます）
MCP_OTEL_ENABLED	任意	OpenTelemetry トレースを有効にするには、true に設定します
MCP_API_BASE_URL	必須	上流 API のルートです。ユーザーキーの交換ではこの URL に対して認証するため、これを設定しないとサーバーは起動しません

同梱スキル

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

• /getting-started — ステップごとのワークフローガイド
• /evidence-lifecycle — ステップごとのワークフローガイド
• /dossier-lifecycle — ステップごとのワークフローガイド
• /notification-lifecycle — ステップごとのワークフローガイド
• /notification-attachments — ステップごとのワークフローガイド
• /chat-lifecycle — ステップごとのワークフローガイド

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

REST API を直接使ってコーディングしますか？

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

• スキル： .claude/skills/gocertius-suite-api/SKILL.md — このリポジトリを Claude Code で開くと、そのまま利用できます。
• 参考資料： docs/api-integration-skill.md。

MCP ツールや n8n ノードとは独立しているため、統合に合った入口をお選びください。

利用可能なツール

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

ツール	説明
evidence_create	エビデンスグループ内に新しいエビデンスレコードを登録します。必要なもの：evidence_group_create → evidenceGroupId、case_file_create → caseFileId。idにはUUID v4を生成し、呼び出す前にSHA-256の16進数ハッシュを計算してください。内部フロー：custodyTypeをINTERNALにして呼び出します。レスポンスでuploadFileUrl（署名付きS3 URL）が返されます。uploadFileUrlにファイルのバイト列をそのままPUTし、evidence_get/evidence_listで確認してから、必ず最後にevidence_sealを呼び出してください。INTERNALのエビデンスファイルが1つでも未アップロードの状態でシールしないでください。外部フロー：意図的にハッシュのみのエビデンスを登録する場合に限り、custodyTypeをEXTERNALにします。エビデンスごとに新しいUUIDが必要です。以前のエビデンス作成／アップロードが失敗し、結果が不明な場合は、再試行前にevidence_listで確認してください。永続化されていないことを確認できない限り、同じidを再利用しないでください。警告：エビデンスが正常に永続化された場合でも、APIが{code:'EvidenceCreateError'}を返すことがあります。
evidence_list	特定のエビデンスグループ内のすべてのエビデンスレコードを一覧表示します。グループをシールする前にアップロード済みの文書を確認したり、特定のevidenceIdを探したりする場合に使用します。必要なもの：caseFileIdとevidenceGroupId。ID、タイトル、ステータス、タイムスタンプを含むページ分割された一覧を返します。
evidence_seal	エビデンスグループをシールし、適格TSPタイムスタンプの付与を開始します。グループ内のすべてのINTERNALエビデンスレコードが、すでにそれぞれのuploadFileUrlにアップロードされ、evidence_get/evidence_listで確認済みである必要があります。必要なもの：case_file_create → caseFileId、evidence_group_create → evidenceGroupId。evidencesCountには、グループ内のエビデンス数を設定してください。非同期：呼び出し後、グループのステータスがCLOSEDに変わるまでevidence_group_listをポーリングしてから、ドシエにリンクするか証明書を生成してください。
evidence_get	特定のエビデンスレコードを取得します。必要なもの：evidence_create → evidenceId、evidence_group_create → evidenceGroupId、case_file_create → caseFileId。ステータス（COMPLETED
evidence_group_create	ケースファイル内にエビデンスグループを作成します。必要なもの：case_file_create → caseFileId。idにはUUID v4を生成してください。evidenceTypeにはFILE、PHOTO、VIDEO、WEB_PLUGINのいずれかを設定します。evidenceGroupIdを返します。1つのグループに複数のエビデンスレコードを含めることができます。
evidence_group_list	ケースファイル内のすべてのエビデンスグループと現在のステータス（OPEN、CLOSING、CLOSED）を一覧表示します。既存のグループを探したり、シール可能なグループを確認したりする場合に使用します。必要なもの：caseFileId。
dossier_create	認証済みのエビデンスグループを改ざん検知可能な単一のPDFにまとめるドシエを作成します。必要なもの：case_file_create → caseFileId。リンクする前に、エビデンスグループのステータスがCLOSEDである必要があります。idにはUUID v4文字列を生成してください。dossierIdを返します。作成後、dossier_evidence_linkでエビデンスをリンクし、dossier_certifyで認証してください。
dossier_update	既存のドシエのメタデータ（名前、テンプレートフィールド、有効期限）を更新します。必要なもの：dossier_create → dossierId、caseFileId。ドシエのステータスがDRAFTの間のみ使用できます。
dossier_certify	ドシエを認証し、改ざん検知可能なPDFを生成して、リンクされたすべてのエビデンスをロックします。必要なもの：dossier_create → dossierId、dossier_evidence_link（エビデンスがリンク済み）、case_file_create → caseFileId。非同期：DRAFT → CERTIFYING → CERTIFIEDと遷移します。ダウンロードする前に、dossierIdのステータスがCERTIFIEDになるまでdossier_listをポーリングしてください。
dossier_list	ケースファイル内のすべてのドシエと、そのステータスおよびメタデータを一覧表示します。既存のdossierIdを探したり、認証の進行状況を確認したりする場合に使用します。必要なもの：caseFileId。ID、名前、ステータス、作成日を含むページ分割された一覧を返します。
dossier_list_by_user	ユーザーに属するすべてのケースファイルを対象に、そのユーザーのドシエをすべて一覧表示します。必要なもの：userId（session_loginまたはsession_infoから取得）。ドシエがどのケースファイルにあるかわからない場合に使用します。caseFileIdがすでにわかっている場合はdossier_listを使用してください。filter、order、pageに対応しています。{ data, meta.totalElements }を返します。
dossier_get	ステータス、リンクされたエビデンス、ダウンロードURLなど、特定のドシエの詳細をすべて取得します。現在の状態を確認したり、CERTIFIEDになった後に証明書のダウンロードURLを取得したりする場合に使用します。必要なもの：caseFileIdとdossierId。
dossier_template_list	利用可能なドシエテンプレートを一覧表示します。前提条件はありません。テンプレートIDと、各言語の翻訳を返します。返されたidをdossier_createのdossierTemplateIdとして使用してください。
dossier_preview	認証前のドシエのHTMLプレビューURLを返します。必要なもの：caseFileIdとdossierId。
dossier_document_url	認証済みドシエのPDFのダウンロードURLを返します。必要なもの：dossier_certify（CERTIFIEDステータス）、caseFileId、dossierId。
dossier_package_url	ドシエ一式（PDF＋エビデンスファイル）のダウンロードURLを返します。必要なもの：dossier_certify（CERTIFIEDステータス）、caseFileId、dossierId。
dossier_visibility	認証済みドシエの公開／非公開設定を更新します。必要なもの：dossier_certify（CERTIFIEDステータス）、caseFileId、dossierId。
dossier_delete	ドシエを削除します。DRAFTステータス（認証前に破棄する場合）またはCERTIFIEDステータス（認証済みドシエを完全に削除する場合）で使用できます。取り消しできません。必要なもの：caseFileIdとdossierId。
dossier_group_certify	シール済みの単一のエビデンスグループから、1回の呼び出しでドシエを作成して認証します（簡易フロー）。必要なもの：evidence_seal（CLOSEDステータス）、case_file_create → caseFileId、evidence_group_create → evidenceGroupId。idにはUUID v4文字列を生成してください。シール済みのエビデンスグループが1つだけで、複数グループをまとめる必要がない場合に使用します。CERTIFYINGステータスのdossierIdをすぐに返します。CERTIFIEDになるまでポーリングしてください。
dossier_evidence_link	シール済みのエビデンスグループから、エビデンスレコードをドシエにリンクします。必要なもの：dossier_create → dossierId、evidence_seal（CLOSEDステータス）、case_file_create → caseFileId。エビデンスグループは必ずCLOSEDステータスである必要があります。リンクするエビデンスUUIDのids配列を渡してください。異なるケースファイルのエビデンスをリンクするため、複数回呼び出すことができます。
dossier_evidence_list_to_link	ドシエにリンク可能なエビデンス項目（まだリンクされていないCLOSEDグループ）を一覧表示します。必要なもの：caseFileIdとdossierId。
dossier_evidence_list	ドシエ内の1つのエビデンスグループにリンクされたエビデンス項目を一覧表示します。必要なもの：caseFileId、dossierId、dossierEvidenceGroupIdの3つすべてが必須です。グループに関係なくドシエ内のすべてのエビデンス項目を取得する場合は、代わりにdossier_evidence_list_by_dossierを使用してください。filter、order、pageに対応しています。
dossier_evidence_list_by_dossier	すべてのエビデンスグループを対象に、ドシエにリンクされたすべてのエビデンス項目を一覧表示します。必要なもの：caseFileIdとdossierId。これはドシエ全体の一覧です。dossier_evidence_listはグループごとの一覧で、追加でdossierEvidenceGroupIdが必要です。filter、order、pageに対応しています。{ data, meta.totalElements }を返します。
dossier_evidence_get	ドシエにリンクされた特定のエビデンス項目の詳細を取得します。必要なもの：caseFileId、dossierId、evidenceId。
dossier_evidence_delete	ドシエからエビデンス項目を削除します。ドシエのステータスがDRAFTの間のみ使用できます。必要なもの：caseFileId、dossierId、evidenceId。
notification_document_add	通知に文書を添付します。2段階の処理です。この呼び出しでファイルを登録すると、署名付きアップロードURLである{ url }が返されます。そのURLにx-amz-checksum-sha256ヘッダーを付けて、ファイルの生バイト列をPUTします。idにはUUID v4を生成し、呼び出す前にファイルのSHA-256 16進数ハッシュを計算してください。hashに指定します。順序が重要で、間違えると送信に失敗します。受信者を追加する前にすべての文書を追加し、各文書がREADY_TO_SENDになるまで待ってから（notification_document_listをポーリング。約8秒）、notification_request_sendを呼び出してください。受信者を追加した後に添付したり、文書がPENDINGの間に送信したりすると、409/404 NOTIFICATION_NOT_FOUNDが返されます。添付ファイルの最大数は固定のAPI制限ではなく、サブスクリプションごとの設定です。数を決めつけないでください。添付ファイルは配信証明書にまとめることができます。notification_certificate_package_urlを参照してください。
notification_request_create	認証済み通知リクエストを作成します。必要なもの：case_file_create → caseFileId。idにはUUID v4を生成してください。languageにはen_GBまたはes_ESを設定します。notificationRequestIdを返します。送信前にnotification_receiver_addで少なくとも1人の受信者を追加してください。重要：contentフィールドは有効なHTMLである必要があります。HTMLタグのないプレーンテキストは、受信者のランディングページに表示されません。対応しているHTML形式は、段落（ ）、太字（）、斜体（）、順序なしリスト（ ）、順序付きリスト（ ）のみです。それ以外のHTMLタグやCSSは使用しないでください。subjectでは、特殊な書体の文字（emダッシュ、スマートクォート）を避け、標準ASCII文字（ハイフン、まっすぐな引用符）を使用してください。
notification_request_send	追加されたすべての受信者に認証済み通知を送信します。必要なもの：notification_request_create → notificationRequestId、notification_receiver_add（受信者が少なくとも1人）、case_file_create → caseFileId。非同期：配信を開始します。証明書を生成する前に、ステータスがSENTまたはそれ以降（PARTIALLY_READ、FULLY_READ）になるまでnotification_request_statusをポーリングしてください。
notification_request_status	認証済み通知の配信ステータスを確認します。必要なもの：notificationRequestId、caseFileId。ステータス（CREATING
notification_receiver_add	通知リクエストに受信者を追加します。必要なもの：notification_request_create → notificationRequestId、case_file_create → caseFileId。idにはUUID v4または任意の文字列（例：内部ユーザーID）を指定できます。receiverIdを返します。notification_certificate_getで使うため、保存してください。配信は常にメールで行われます。WhatsAppリンクにはsendWaUrl、RCS/SMSリンクにはsendSmsUrl（端末の対応状況に応じてRCSまたはSMSを選択）、ワンタイムコードによる本人確認にはotpRequiredを設定します。これら3つのいずれかを指定する場合は、phonePrefix（+を含む）とphoneNumberが必要です。notification_request_sendを呼び出す前にすべての受信者を追加してください。ただし、通知に添付ファイルがある場合は、先に添付してください（notification_document_addを参照）。
notification_certificate_get	特定の受信者について、通知の配信や開封を証明するPDF証明書を生成または取得します。必要なもの：notification_request_send、notification_receiver_add → receiverId、notification_request_create → notificationRequestId、case_file_create → caseFileId。その受信者の証明書を初めてリクエストするときにidとしてUUID v4を生成し、ポーリング時にも同じidを再利用してください。notification_request_statusがSENTまたはそれ以降になってから呼び出してください。最初の呼び出しでは証明書の生成中に{}が返ることがあります。レスポンスにpdfUrl/documentUrlまたはCERTIFIED／最終ステータスが含まれるまで、notification_certificate_getをポーリング／再呼び出ししてください。SENTの状態でバックエンドがForbidden/Unexpectedを返した場合は、証明書エンドポイントを繰り返し呼び出し続けないでください。notification_request_statusをREAD/ANSWEREDまでポーリングするか、UIで確認してから、同じ証明書idで再試行してください。ACCEPTED_OR_NOT通知の場合は、認証可能な配信／開封状態になった後に中間証明書を1回呼び出し、さらにPARTIALLY_ANSWERED/FULLY_ANSWEREDになった後に最終回答証明書を呼び出してください。
notification_request_list	ユーザーに表示される認証済み通知を一覧表示します。必要なもの：userId（session_login、session_info、profile_getのいずれかから取得）。この一覧はケースファイル単位ではなくユーザー単位で、絞り込まない場合はすべてのケースファイルが対象になります。手元にないnotificationRequestIdを探す場合に使用します。見つける方法はこれだけです。通知ごとにid、code、subject、status、type、sentAt、receiverStats、所有するcaseFileを返します。statusまたはstatuses（CREATING、DRAFT、IN_PROCESS、SENT、PARTIALLY_READ、FULLY_READ、PARTIALLY_ANSWERED、FULLY_ANSWERED）、caseFileIds、subjectに対するsearch、特定の受信者に送信された通知を探すためのreceiversSearchで絞り込めます。ページ分割されます。
notification_request_update	未送信の通知のsubject、content、type、languageを編集します。必要なもの：notificationRequestIdとcaseFileId。contentは有効なHTMLである必要があります。プレーンテキストはAPIで受け付けられますが、受信者のランディングページには表示されません。対応するタグは 、、、 、 のみです。それ以外のタグやCSSは使用できません。subjectはプレーンなASCII文字のみとし（emダッシュやスマートクォートは使用不可）、最大100文字にしてください。テスト済み：通知の送信後にこのAPIを呼び出すと403 Forbiddenで拒否されるため、編集できるのは送信前のみです。所属するケースファイルを変更するにはnotification_request_case_file_moveを使用してください。このツールでは移動できません。
notification_request_delete	通知を削除します。必要なもの：notificationRequestIdとcaseFileId。取り消しはできません。テスト済み：通知の送信後にこのAPIを呼び出すと403 Forbiddenで拒否されます。送信済み通知は配信エビデンスであり、削除できません。別の場所に移動したいだけの場合は、代わりにnotification_request_case_file_moveを使用してください。
notification_request_duplicate	既存の通知から、内容、受信者、添付ファイルを複製した新しいDRAFT通知を作成します。元の通知の状態にかかわらず動作するため、同じ人たちに再送信する場合や、送信済み通知をテンプレートとして再利用する場合に使用します。idにはUUID v4を生成し、新しいsubjectを指定してください。コピーを別のケースファイルに配置するには、本文にcaseFileIdを渡します。省略すると、元の通知と同じケースファイルに配置されます。コピーは非同期で作成されます。最初は受信者数0、文書数0のCREATING状態で始まり、その後に内容が反映されます。そのため、直後に読み取ると、空ではない通知が空のように表示されます。内容を確認したり送信したりする前に、ステータスがDRAFTになるまでnotification_request_statusをポーリングしてください。受信者も複製されるため、notification_request_sendを呼び出す前にnotification_receiver_listで確認してください。確認しないと、元と同じ受信者リストに再送信されます。
notification_request_case_file_move	通知を別のケースファイルに移動します。2つのcaseFileIdに注意してください。パス内のものは通知の現在の所属先で、本文内のものは移動先です。通知はケースファイルごとにまとめられており、複製せずにそのまとまりを変更する方法はこれだけです。
notification_receiver_list	通知の受信者と、それぞれの配信状態を一覧表示します。受信者ごとにid、firstName、lastName、email、phonePrefix/phoneNumber、status（INVALID、READY_TO_SEND、SENT、READ、ANSWERED、ERROR）、statusUpdatedAt、返信後のanswer、emailBounced、拒否されたアドレスのvalidationError（TAKEN、IS_DEFINED、IS_INVALID）を返します。notification_request_sendの前に呼び出すと、INVALIDになったアドレスがあるか確認できます。送信後に呼び出すと、誰が開封または返信したか確認できます。notification_certificate_getで必要なreceiverIdを取得する方法でもあります。ページ分割され、idで絞り込めます。
notification_receiver_update	受信者の詳細（firstName、lastName、email、phonePrefix、phoneNumber）を修正します。必要なもの：receiverId、notificationRequestId、caseFileId。入力ミスのあるアドレスを修正する場合は、削除して再追加するとreceiverIdが失われるため、このツールを使用してください。phonePrefixには+を含める必要があります（例：+34）。受信者がRCS/SMSリンク（sendSmsUrl）、WhatsAppリンク（sendWaUrl）、またはOTPチャレンジ（otpRequired）を受け取るには、電話番号が必要です。
notification_receiver_delete	通知から受信者を削除します。必要なもの：receiverId、notificationRequestId、caseFileId。プラットフォームが拒否したアドレスをすべて1回の呼び出しで削除するには、1件ずつ削除するのではなくnotification_receiver_invalid_purgeを使用してください。
notification_receiver_add_bulk	受信者ごとにnotification_receiver_addを呼び出す代わりに、複数の受信者を1回の呼び出しで追加します。receiversを配列として渡してください。各項目にはid（自分で生成）、firstName、lastName、emailが必要で、phonePrefix（+を含む）とphoneNumberも指定できます。この一括形式では、単一受信者用ツールで使用できる受信者ごとのotpRequired、sendWaUrl、sendSmsUrlフラグは受け付けません。代わりにリクエスト側で既定値（otpByDefault、sendWaUrlByDefault、sendSmsUrlByDefault）を設定してください。受信者の最大数は固定のAPI制限ではなく、サブスクリプションごとの設定です。テナントやプラットフォームによって異なるため、数を決めつけないでください。追加して、テナントの上限を超えた場合はエラーを確認してください。notification_request_sendを呼び出す前にすべての受信者を追加し、拒否されたアドレスはINVALIDステータスで表示されるため、notification_receiver_listで結果を確認してください。
notification_receiver_invalid_purge	プラットフォームが不正形式または重複として拒否した、INVALIDステータスの受信者を通知から一括削除します。必要なもの：notificationRequestIdとcaseFileId。他のステータスの受信者には影響しません。INVALIDの受信者がいると送信がブロックされるため、notification_request_sendを呼び出す前に、このツールを実行するかnotification_receiver_updateでアドレスを修正してください。そうしないと通知は送信されません。削除される受信者を確認するには、先にnotification_receiver_listを使用してください。
notification_document_list	通知に添付された文書と、その処理ステータスを一覧表示します。notification_document_addの後にポーリングするためのツールです。新たに登録された文書はPENDINGから始まり、約8秒でREADY_TO_SENDになります。文書が1つでもPENDINGの間にnotification_request_sendを呼び出すと、409/404 NOTIFICATION_NOT_FOUNDで失敗します。上限を設けた再試行（数秒おき、最大12回程度）でポーリングしてください。必要なもの：notificationRequestIdとcaseFileId。ページ分割されます。
notification_document_delete	通知から添付ファイルを削除します。必要なもの：documentId（notification_document_listから取得）、notificationRequestId、caseFileId。
notification_document_download_url	添付ファイルの一時リンクである{ downloadUrl }を返します。必要なもの：documentId（notification_document_listから取得）、notificationRequestId、caseFileId。自分が添付したファイルを取得したり、受信者が受け取ったものを確認したりする場合に使用します。URLは署名付きで有効期限があるため、保存せず、必要なときに取得してください。
notification_certificate_list	1人の受信者に対してすでに生成された配信証明書を一覧表示します。証明書を重複生成せず、既存のものを再利用できます。必要なもの：receiverId、notificationRequestId、caseFileId。証明書ごとにid、status（DRAFT、CERTIFYING、CERTIFIED）、language、createdAt、certifiedAt、partial（受信者が回答を完了する前に発行された中間証明書かどうか）、embeddedDocumentsを返します。embeddedDocumentsを「パッケージに添付ファイルが含まれているかどうか」と解釈しないでください。テストでは、通知に添付ファイルがあってもfalseでしたが、notification_certificate_package_urlはその添付ファイルを含むZIPを返しました。証明書がCERTIFIEDになったら、notification_certificate_document_url（証明書のみ）またはnotification_certificate_package_url（添付ファイルも含むZIP）でダウンロードしてください。
notification_certificate_document_url	証明書PDF単体（添付ファイルなし）の{ documentUrl }を返します。必要なもの：certificateId、receiverId、notificationRequestId、caseFileId。証明書がCERTIFIEDになるまで待ってください。生成は非同期で、CERTIFYINGの間は最初の呼び出しで404になったり空のレスポンスが返ったりすることがあります。繰り返し呼び出し続けるのではなく、回数を制限して数回ポーリングしてください。添付ファイルもまとめたい場合は、代わりにnotification_certificate_package_urlを使用してください。
notification_certificate_package_url	証明書と通知の添付ファイルを含むZIPである{ packageUrl }を返します。「添付書類付き」の形式です。API内に個別のプレビュー用フラグはありません。パッケージには添付書類が含まれ、documentは証明書のみです。必要なもの：certificateId、receiverId、notificationRequestId、caseFileId。notification_certificate_document_urlと同じ前提条件があります。CERTIFIEDになるまで待ってください。生成中は最初の呼び出しが失敗することがあります。
case_file_create	すべての関連操作（エビデンス、通知、ドシエ、チャット）の最上位コンテナーとなる新しいケースファイルを作成します。他の操作を行う前に、最初に呼び出してください。idにはUUID v4を生成してください。以降のすべての呼び出しに必要なcaseFileIdを返します。
case_file_list	GoCertiusアカウント内のすべてのケースファイルを一覧表示します。アカウントに結果を絞るには、userId（session_loginまたはsession_infoから取得）を渡してください。ID、名前、ステータスを含むページ分割された一覧を返します。
case_file_get	特定のケースファイルの詳細を取得します。必要なもの：caseFileId。エビデンスグループ、ドシエ、通知を作成する前に、ケースファイルの存在を確認する場合に使用します。
case_file_delete	ケースファイルと、その中に格納されたすべてのもの（エビデンスグループ、ドシエ、通知、証明書）を削除します。取り消しはできません。確認手順やごみ箱もありません。必要なもの：caseFileId。レスポンスボディは返しません（HTTP 204）。case_file_listで確認してください。ユーザーからそのケースファイルの破棄を依頼されていない限り、「整理」のために呼び出さないでください。
chat_create	認証済みのチャットチャンネル（Telegram）を作成します。重要：チャットを作成できるのは、ユーザーの個人ケースファイル（GoCertiusアカウントの開設時に自動作成）だけです。手動で作成したケースファイルは使用しないでください。session_info → case_file_listで個人ケースファイル（作成日時が最も古く、ユーザーが所有するもの）を探して使用してください。idにはUUID v4を生成してください。serviceにはTelegramを設定します。すぐに返りますが、チャットのステータスがcreatingの場合があります。招待URLや証明書をリクエストする前に、chat_getを呼び出し、登録済み／アクティブになるまで待ってください。
chat_get	認証済みチャットの詳細を取得します。必要なもの：個人caseFileId、chat_create → chatId。ステータス、参加者、registeredAtタイムスタンプを返します。chat_createの後、ステータスがアクティブ／登録済みになり、registeredAtが設定されるまでchat_getをポーリングしてください。証明書の作成にはcreatedAtでは不十分です。
chat_invitation_url	認証済みチャットのTelegram招待URLを返します。必要なもの：chat_create → chatId、個人caseFileId。chat_getのステータスがcreatingの間は呼び出さないでください。チャットが登録済み／アクティブになるまで待ってください。そうしないとAPIがChat not foundを返す場合があります。返されたinvitationUrlを参加者と共有し、認証済みチャンネルに参加してもらってください。
chat_certificate_create	認証済みチャットの一定範囲のメッセージについて証明書を作成します。必要なもの：chat_create → chatId、個人caseFileId、chat_get → registeredAt、Telegramチャンネルにすでに存在するメッセージ。idにはUUID v4を生成してください。registeredAtの代わりにcreatedAtを使用しないでください。registeredAtがない場合、チャットはまだ認証の準備ができていません。chatMessagesFromとchatMessagesToにはISOタイムスタンプを指定してください（chatMessagesFromはregisteredAtより後でなければなりません）。非同期：status === CERTIFIEDになるまでchat_certificate_getをポーリングしてください。
chat_certificate_get	認証済みチャットの証明書を取得します。必要なもの：chat_certificate_create → certificate id、chat_create → chatId、case_file_create → caseFileId。ステータスがCERTIFIEDになるとdocumentUrlを返します。documentUrlを使用する前に、CERTIFIEDになるまでポーリングしてください。
session_login	MCP サーバーにGoCertiusでの再認証を強制します。パラメーターは不要で、認証情報も受け付けません。サーバーは、設定済みのユーザーキー（MCP_AUTH_USER_KEY）を再交換して新しいセッショントークンを取得し、結果のuserIdと有効期限を報告します。MCP サーバーが認証を自動管理します。401エラーが発生した場合に限り呼び出してください。サーバー自身が認証情報を保持していない場合（未設定、または自分のBearerトークンを指定した場合）は、更新するセッションがないため、ツールはMCP_AUTH_USER_KEYを示すエラーを返します。
session_info	現在の認証済みセッション情報を取得します。userId、type（このMCPセッションの認証方法。サーバーで使用可能な唯一の認証フローであるUserKey）、accountLoginType（別の情報で、GoCertiusアカウント自体のログイン方法。PasswordまたはOpenId。APIが省略した場合はnull）、email、companyId、defaultCaseFileIdを返します。認証ユーザーの確認やセッションの有効性確認に使用します。ユーザーの特定はGET /profileで行われます。userIdのみが必要な場合は、正規の情報源であるprofile_getを使用してください。プロフィールの残りの情報も返されます。必須パラメーターはありません。
profile_get	認証済みユーザー自身のプロフィールを返します。セッショントークンだけから呼び出し元を特定するため、emailなどの入力は不要です。そのため、リクエストごとのBearer認証を含むすべてのデプロイ環境で動作します。idフィールドがuserId（UUID）であり、case_file_listやすべての/users/{userId}/...操作に必要な値です。userIdが必要な場合は、正規の情報源であるこのツールをsession_infoより優先してください。companyId（通知SSEストリームの利用登録に必要）とdefaultCaseFileId（個人ケースファイル。チャットで使用する必要があるもの）も返します。permitも返します。これは{ evidences, idVerifications, notifications, chats, signatures }というブール値の集合で、アカウントで使用可能なツール群を示します。falseの項目がある場合、そのグループ内のすべてのツールは入力内容にかかわらず403を返します。再試行や引数の変更では解決できません。各ツール群を初めて利用する前に確認してください。このサーバーにそのツール群のツールが存在しない場合、falseになるのは正常であり、設定ミスではありません。パラメーターはありません。
evidence_upload	ローカルファイルを1回の操作でエビデンスとしてアップロードします。SHA-256を計算し、エビデンスレコード（custodyType INTERNAL = GoCertiusがファイルを保存）を登録して、バイト列をS3にアップロードします。手動でのハッシュ計算やPUTは不要です。内部では、GoCertiusで必要な手順に従います。INTERNALエビデンスを作成 → uploadFileUrl（署名付きS3 URL）を受け取り → ファイルのバイト列をPUT → uploaded:trueを返します。必要なもの：case_file_create → caseFileId、evidence_group_create → evidenceGroupId。filePath（絶対ローカルパス。stdio／ローカルモードのみ）またはcontentBase64（Base64エンコードされたファイル内容。最大約10 MB）のどちらか一方だけを指定してください。ファイルがローカルマシンにある場合はevidence_uploadを使用してください。SHA-256ハッシュをすでに持っている場合、uploadFileUrlを手動で確認／使用する必要がある場合、または公開fileUrlがある場合はevidence_createを使用してください。このツールが成功した後、evidence_get/evidence_listで確認してからevidence_sealを呼び出してください。このツールがエビデンスIDを返す前に失敗した場合は、再試行の前にevidence_listを確認してください。手動で再試行する場合は、新しいUUIDを使ってevidence_createを呼び出してください。ローカルファイルは1 GiB未満である必要があります。
notification_send	1回の呼び出しで、1人以上の受信者に認証済み通知を送信します。通知リクエストを作成し、すべての受信者を追加して送信します。UUIDはすべて自動生成されるため、idを渡さないでください。必要なもの：case_file_create → caseFileId。contentは必ずHTMLである必要があります。プレーンテキストはAPIで受け付けられ、SENTを返しますが、受信者のランディングページには表示されません。対応するタグは 、、、 、 のみです。それ以外のタグやCSSは使用できません。subjectはプレーンなASCII文字のみとし、最大100文字にしてください。配信は常にメールで行われます。受信者ごとに、sendWaUrl（WhatsApp）、sendSmsUrl（端末の対応状況に応じてRCSまたはSMS）、otpRequired（ワンタイムコード）を追加で設定できます。いずれもphonePrefix（+を含む）とphoneNumberが必要です。受信者の最大数は固定のAPI制限ではなくサブスクリプションごとの設定のため、このツールでは制限していません。上限を超えるバッチはAPIが拒否します。このツールではファイルを添付できません。添付ファイルは受信者を追加する前に登録する必要があるため、notification_send_with_attachmentsを使用してください。一部成功はエラーとしてではなく結果として報告されます。リクエストは作成されたものの、受信者の追加または送信に失敗した場合でも、結果にはnotificationRequestIdに加えてrecipientsAdded、recipientsFailed、sent:falseが含まれます。そのため、DRAFTを放棄せずにnotification_receiver_addとnotification_request_sendで処理を完了できます。INVALIDの受信者がいると送信がブロックされるため、このツールは送信前に確認し、成功しない送信を試みる代わりにinvalidRecipientsを報告します。最初の作成に失敗した場合は、ツールがエラーを発生させます。よくある原因は、存在しないcaseFileId、100文字を超えるsubject、契約済み通知プランの上限超過です。いずれも再試行では解決しません。拒否ではなくタイムアウトの場合は、再試行の前にnotification_request_listを確認してください。リクエストがすでに作成されている可能性があります。配信の進行状況はnotification_request_statusでポーリングし、その後、受信者ごとにnotification_certificate_getを呼び出してください。
notification_send_with_attachments	1回の呼び出しで、1つ以上の文書を添付した認証済み通知を1人以上の受信者に送信します。添付ファイルがない場合は、代わりにnotification_sendを使用してください。APIが厳格に適用し、例外を認めない順序ルールが添付ファイルにあるため、このツールは別に用意されています。受信者を追加する前に文書を登録して完全にアップロードし、通知を送信する前に各文書がREADY_TO_SENDになる必要があります。そうしないと、送信時に409/404 NOTIFICATION_NOT_FOUNDで失敗します。このツールは、作成 → 各文書の登録とアップロード → READY_TO_SENDまで待機 → 受信者を追加 → 送信、という一連の処理を実行します。各添付ファイルには、ローカルファイルパス、Base64コンテンツ、HTTPS URL、またはn8nバイナリ参照を指定できます。ハッシュ計算とアップロードは内部で処理されます。UUIDはすべて自動生成されるため、idを渡さないでください。必要なもの：case_file_create → caseFileId。contentは必ずHTMLである必要があります。プレーンテキストはAPIで受け付けられ、SENTを返しますが、受信者のランディングページには表示されません。対応するタグは 、、、 、 のみです。subjectはプレーンなASCII文字のみとし、最大100文字にしてください。配信は常にメールで行われます。受信者ごとに、sendWaUrl（WhatsApp）、sendSmsUrl（端末の対応状況に応じてRCSまたはSMS）、otpRequired（ワンタイムコード）を追加で設定できます。いずれもphonePrefix（+を含む）とphoneNumberが必要です。添付ファイルと受信者の最大数は固定の制限ではなくサブスクリプションごとの設定のため、このツールではどちらも制限していません。添付ファイルが失敗すると、意図的に受信者を追加する前に処理を停止します。受信者が存在するとAPIが追加文書を受け付けなくなるため、処理を続けると、不足ファイルを添付できない通知が作成されてしまいます。結果には、再試行または削除に使えるDRAFTのnotificationRequestIdが含まれます。INVALIDの受信者がいると送信がブロックされるため、このツールは送信前に確認し、送信できないリクエストを試みる代わりにinvalidRecipientsを報告します。最初の作成に失敗した場合は、ツールがエラーを発生させます。よくある原因は、存在しないcaseFileId、100文字を超えるsubject、契約済み通知プランの上限超過です。いずれも再試行では解決しません。拒否ではなくタイムアウトの場合は、再試行の前にnotification_request_listを確認してください。リクエストがすでに作成されている可能性があります。証明書には添付ファイルをまとめられます。notification_certificate_package_urlを参照してください。

共存

この MCP サーバーは、GoCertius API 向けの現在の、積極的にメンテナンスされているインターフェースです。

セットアップ内のほかの MCP サーバーと安全に共存できます。GoCertius 名前空間のツールのみを公開し、ほかのサーバーとローカル状態を共有しません。

ライセンス

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