SignaTrust

@signatrust/mcp-server

Claude から電子署名を送信・検証できます。署名ごとに独立して検証可能な暗号学的証拠を備えた、ゼロカストディ方式です。

SignaTrust の文書署名 API 用 Model Context Protocol（MCP）サーバーです。Claude などの AI アシスタントが、自然言語でエンベロープの作成、テンプレートの管理、署名状況の確認、ブロックチェーンアンカーの検証を行えるようにします。

クイックスタート

Claude Code

claude mcp add signatrust -- npx -y @signatrust/mcp-server

続いて、MCP サーバーの環境変数に API キーを設定します。

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": {
        "SIGNATRUST_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）に追加します。

{
  "mcpServers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": {
        "SIGNATRUST_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加します（トップレベルのキーは mcpServers ではなく servers です）。

{
  "servers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": {
        "SIGNATRUST_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

キーをファイルに記載しないようにするには、env の代わりに入力プロンプトを使用します。

{
  "inputs": [
    { "id": "signatrust-key", "type": "promptString", "description": "SignaTrust API key", "password": true }
  ],
  "servers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": { "SIGNATRUST_API_KEY": "${input:signatrust-key}" }
    }
  }
}

利用可能なツール

ツール	説明	必須スコープ
list_envelopes	ステータスフィルターとページネーションを指定してエンベロープを一覧表示します	envelopes:read
get_envelope	エンベロープの詳細（署名者、文書、ブロックチェーン）を取得します	envelopes:read
create_envelope	署名用のエンベロープを作成して送信します。documentIds（upload_document の実行後）または templateId（バックエンドがテンプレートをコピー）を指定できます。3 段階の securityLevel に対応しています。	envelopes:write
list_templates	利用可能な文書テンプレートを一覧表示します	templates:read
upload_document	ローカルファイルを読み込んで SignaTrust にアップロードし、create_envelope 用の文書 ID を返します	documents:write
download_document	文書（署名済み PDF など）をダウンロードするための有効期限付き署名済み URL を取得します	documents:read
analyze_document	エンベロープの AI 契約分析を実行します（Gemini を活用したリスク／センチメント評価。プランによる制限あり）	ai:analyze
verify_blockchain	Solana アンカーを検証し、複合ハッシュ、ファイルハッシュ、エクスプローラー URL を返します	envelopes:read
get_evidence	裁判での提出に適した証拠一式（エンベロープ、署名者、監査証跡、ブロックチェーン検証）を取得します	envelopes:read

3 段階のセキュリティ。 create_envelope では securityLevel を指定できます。STANDARD（ベアラートークンのみ）、VERIFIED（SMS／メール OTP を追加。雇用、ベンダー、医療の同意に推奨）、または CERTIFIED（WebAuthn 生体認証とデバイスバインディングを追加。不動産、高額取引、規制対象の署名に推奨）です。

API キーのスコープ

SignaTrust ダッシュボードの Settings > API Keys で API キーを作成します。必要なツールに応じてスコープを割り当ててください。

スコープ	有効になるツール
envelopes:read	list_envelopes, get_envelope, verify_blockchain, get_evidence
envelopes:write	create_envelope
templates:read	list_templates
documents:write	upload_document
documents:read	download_document
ai:analyze	analyze_document

環境変数

変数	必須	デフォルト	説明
SIGNATRUST_API_KEY	はい	-	sk_live_ で始まる API キー
SIGNATRUST_API_URL	いいえ	https://app.signatrust.io	API のベース URL

自然言語での使用例

接続すると、AI アシスタントに次のようなことを尋ねられます。

• 「保留中の封筒をすべて一覧表示してください」
• 「~/Documents/nda.pdf をアップロードして、VERIFIED セキュリティで [email protected] に送信してください」
• 「利用可能なテンプレートを表示してから、住宅用テンプレートを使って John Doe の賃貸契約書を作成してください」
• 「封筒 env_abc123 のブロックチェーン検証を確認して、複合ハッシュを表示してください」
• 「封筒 env_xyz を AI で分析してください。署名者が確認する前に、リスクのある条項がないか知りたいです」

開発

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Type check
npm run typecheck

# Local smoke test
SIGNATRUST_API_KEY=sk_live_xxx SIGNATRUST_API_URL=http://localhost:3000 node dist/server.js

アーキテクチャ

src/
  server.ts                      # Entry point — env validation, MCP server setup, stdio transport
  handlers.ts                    # Tool definitions and handler dispatch (testable)
  errors.ts                      # RFC 7807 ProblemDetails -> MCP tool error mapping
  vendor/signatrust-sdk/         # Vendored HTTP client + types (zero external runtime deps)
  *.test.ts                      # Co-located test files

HTTP クライアントと API 型は src/vendor/signatrust-sdk/ にベンダー提供のものを格納しているため、 このパッケージには @modelcontextprotocol/sdk 以外の外部ランタイム依存関係はありません。