Ebenova Scope Guard - AI Contract Scope Violation Detector

Name: Ebenova Scope Guard - AI Contract Scope Violation Detector
Author: dgtalquantumleap-ai

ローカル

github.com/dgtalquantumleap-ai法務・行政022 週間前に更新

リポジトリ

Ebenova Scope Guard - AI Contract Scope Violation Detector について

Ebenova Scope Guard は、フリーランサー、代理店、小規模事業者向けの Signova の契約範囲分析ツールです。合意範囲を超える依頼を検出し、変更注文書の作成を支援します。プラットフォームには法律文書生成や他の MCP サーバーもあります。

主な機能

01契約範囲外の依頼を検出
02変更注文書の内容を生成
03法律文書作成用 MCP ツールを提供
04事業・契約分析ツールを提供

活用シーン

01顧客の依頼が契約範囲を超えるか判定
02範囲変更に伴う変更注文書の準備
03AI エージェントから法律文書ツールを利用
04ツールで事業情報や契約情報を分析

MCP 対応

Signova は法律文書作成、事業・契約分析、範囲検出の MCP サーバーと HTTP MCP エンドポイントを提供します。Scope Guard サーバーは、AI エージェントに範囲検出と変更注文書生成のツールを公開します。

#legal #contracts #scope-creep #freelance #compliance #ai #africa

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "signova": {
      "command": "npx",
      "args": [
        "-y",
        "@ebenova/scope-guard-mcp"
      ],
      "env": {
        "EBENOVA_API_KEY": "<EBENOVA_API_KEY>"
      }
    }
  }
}

起動コマンドnpx -y @ebenova/scope-guard-mcp

設定が必要な環境変数

EBENOVA_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@ebenova/scope-guard-mcpstdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須	説明
inputSchema	object	はい
inputSchema.contract_text	string	はい	契約書の全文（50 文字以上）
inputSchema.client_message	string	はい	スコープ違反の有無を分析するクライアントのメッセージ
inputSchema.communication_channel	enum	いいえ	メッセージを受信したチャネルemail \| whatsapp \| slack \| sms \| other

詳細

Signova — AI を活用した法務文書プラットフォーム

getsignova.com · ebenova.dev · api.ebenova.dev

Signova は AI を使用して、専門的な法務文書、契約書、請求書、コンプライアンスレポートを生成します。弁護士費用をかけずに法的保護を必要とするフリーランサー、代理店、中小企業向けに構築されています。

概要

Signova は、単一のコードベースから次の 3 つのサービスを提供します。

コンシューマー向けウェブアプリ（getsignova.com） — 文書ごとの課金による生成、プロモーションコードの利用、購入者情報の取得
開発者プラットフォーム（ebenova.dev + api.ebenova.dev） — API キー、使用状況の追跡、Stripe 請求に対応したサブスクリプション API
MCP サーバー — AI エージェント（Claude Desktop、Cursor など）に同じ法務／インサイト／スコープ関連ツールを提供する Model Context Protocol サーバー

このプラットフォームは、カナダ（PIPEDA + ケベック州法 25）、米国（CCPA/CPRA + 州のプライバシー法）、英国（UK GDPR）、欧州連合（GDPR）、ナイジェリア（NDPA 2023）、南アフリカ（POPIA）、ケニア（DPA 2019）、ガーナ（DPA 2012）向けに、法域に応じた文書作成機能を備え、34 種類の文書（NDA、契約書、内定通知書、プライバシーポリシー、請求書、変更指示書など）を生成します。これらすべてにおいて、Anthropic Claude を利用した位置情報に基づく通貨検出と、ロケール固有の文書作成に対応しています。

公開 URL

サービス	URL
コンシューマー向けサイト	https://www.getsignova.com
開発者向けサイト	https://www.ebenova.dev
API ベース URL	https://api.ebenova.dev
OpenAPI 仕様（ファイル）	`openapi.yaml`

アーキテクチャ

Browser / AI Agent
      │
      ▼
Vercel Edge (vercel.json routing + redirects)
      │
      ├─ Static SPA:  Vite build of src/  →  React 19 + React Router 7
      │
      └─ Serverless:  api/*.js  (Node.js functions)
             │
             ├─ Upstash Redis        (API keys, usage, promo state, rate limits)
             ├─ Anthropic Claude     (document generation, scope analysis)
             ├─ Stripe               (consumer checkout + API subscriptions)
             ├─ Resend               (transactional email, waitlist, receipts)
             ├─ Paystack / OxaPay    (Africa + crypto payments)
             └─ Groq                 (fast previews, insight drafts)

Vercel（プロジェクト signova、所有者 ebenovasolu-5755s-projects）にデプロイされています。vercel.json で定義された cron ジョブが、/v1/insights/poll（15 分ごと）と /api/cron/ots-upgrade（2 時間ごと）を実行します。

技術スタック

レイヤー	テクノロジー
フロントエンド	React 19、Vite 7、React Router 7、Phosphor Icons
バックエンド	Vercel Serverless Functions（Node.js、ESM）
バリデーション	Zod 3
データ	Upstash Redis（サーバーレス REST）
AI	Anthropic Claude（主）、Groq（プレビュー／下書き）
決済	Stripe（主）、Paystack（NGN）、OxaPay（暗号資産）、Flutterwave
メール	Resend
アナリティクス	Vercel Analytics、Vercel Speed Insights
MCP	`@modelcontextprotocol/sdk`
テスト	Vitest、@testing-library/react、jsdom

機能

文書生成

34 種類の文書：NDA、フリーランス／サービス／コンサルティング契約書、雇用内定通知書、プライバシーポリシー、利用規約、請求書、変更指示書、スコープ分析など
カナダ、米国（州レベルの法規制にも対応）、英国、EU、ナイジェリア、南アフリカ、ケニア、ガーナの法域に応じた文書作成
Groq を利用した無料プレビュー（api/generate-preview.js）、支払い確認後に Claude でプレミアム出力を生成（api/generate.js、api/v1/documents/generate.js）
会話から文書を抽出（api/v1/extract/conversation.js）

プロモーションシステム

プロモーションコードを使用すると、支払いを省略して無料で文書を 1 件利用できます。状態は Upstash Redis に保存されます（promo_uses:CODE カウンター、IP ごとの時間単位の制限を行う promo_ratelimit:IP）。IP のレート制限：1 時間あたり 5 回。すべてのコードは api/promo-redeem.js で定義されています。

コード	説明	最大利用回数	有効期限
`SIGNOVA10`	一般割引	500	2026-12-31
`OLUMIDE`	創業者アクセス（無制限のテスト）	9,999	2027-12-31
`AFRICA`	Taryl African Founders Community	1,200	2026-12-31
`KREDO`	Kredo パートナーシップ	20	2026-12-31
`MEST2026`	MEST コホート	100	2026-12-31
`CCHUBNIG`	CcHUB Nigeria	200	2026-12-31
`BAOBAB26`	Baobab Network コホート	80	2026-12-31
`ACCLAFRICA`	Accelerate Africa コホート	50	2026-12-31
`TEF2026`	Tony Elumelu Foundation	1,000	2026-12-31
`ROSEMARY`	1 回限りのプロモーション	10	2026-12-31

請求（Stripe）

一般ユーザー向けのドキュメント単位の決済チェックアウト（api/stripe-checkout.js、api/stripe-verify.js、api/stripe-webhook.js）
API のサブスクリプションプラン：Starter $29、Growth $79、Scale $199（api/v1/billing/checkout.js）
Insights アドオンプラン：Starter $49、Growth $99、Scale $249 — 有効化された商用機能
Stripe Customer Portal（api/v1/billing/portal.js）、Webhook ハンドラー（api/v1/billing/webhook.js）
Scope Guard Pro の決済チェックアウト（api/scope-guard-checkout.js）— 有効化された商用機能

MCP サーバー

ファーストパーティの MCP サーバーが 3 つ、mcp-servers/ の下にあります。

サーバー	目的
`mcp-servers/legal-docs`	AI エージェント向けのドキュメント作成ツール（NDA、契約書、請求書、変更注文書）
`mcp-servers/insights`	ビジネスインテリジェンス／契約分析ツール
`mcp-servers/scope-guard`	スコープクリープの検出と変更注文書の作成

各サーバーは独自の package.json、server.json、Dockerfile を持ち、npm／MCP レジストリ／Smithery／Glama にそれぞれ独立して公開されます。

サイト自体も、api/mcp.js に HTTP MCP エンドポイントを公開しています。

API 認証

/v1/* の認証済みエンドポイントでは、2 種類の異なる認証情報を使用します。

Bearer API キー（Authorization: Bearer sk_live_...）— lib/api-auth.js を通じて、Upstash Redis に照合して検証されるエンドユーザーキーです。ドキュメント生成、抽出、スコープ、監視、契約書、insights、請求書に使用されます。
管理者／セットアップシークレット（EBENOVA_ADMIN_SECRET）— /v1/keys/create を保護し、オペレーターのみが新しい顧客キーを発行できるようにします。同様に、ADMIN_API_TOKEN は /v1/admin/revenue を保護します。BYPASS_ADMIN_SECRET は api/create-bypass.js を保護します。CRON_SECRET／POLL_CRON_SECRET は Vercel cron の呼び出しを認証します。

レート制限と月ごとのドキュメント上限は、Redis でキーごとに適用されます。

注：現在、稼働中の /docs HTML エンドポイントはありません。OpenAPI 仕様は openapi.yaml から直接利用してください。

ローカル開発

前提条件

Node.js 20+（ESM）
Upstash Redis データベース（無料プラン）
Anthropic API キー
Stripe アカウント（有料フローの動作確認にのみ必要）
Resend API キー（任意、メール用）

セットアップ

git clone <repo-url>
cd signova
npm install
cp .env.example .env
# edit .env with your keys

スクリプト

npm run dev            # Vite dev server
npm run build          # Production build
npm run preview        # Preview built SPA
npm run lint           # ESLint
npm test               # Vitest
npm run test:coverage  # Vitest with coverage
npm run check:css      # Validate CSS design tokens
npm run keygen         # Generate API/admin secrets

サーバーレスの api/ 関数をローカルで実行するには、Vercel CLI が必要です。

npm i -g vercel
vercel dev

環境変数

完全なテンプレートについては .env.example を参照してください。

必須（コア）

変数	目的
`ANTHROPIC_API_KEY`	主要な AI 生成
`UPSTASH_REDIS_REST_URL`	Redis REST URL
`UPSTASH_REDIS_REST_TOKEN`	Redis 認証トークン
`EBENOVA_ADMIN_SECRET`	`/v1/keys/create` の保護
`PROMO_SECRET`	署名付きプロモーショントークン用の HMAC シークレット

Stripe（有料フローに必須）

変数	目的
`STRIPE_SECRET_KEY`	Stripe API
`STRIPE_WEBHOOK_SECRET`	Webhook 署名の検証
`STRIPE_PRICE_STARTER` / `_GROWTH` / `_SCALE`	メイン API プランの価格 ID
`STRIPE_PRICE_INSIGHTS_STARTER` / `_GROWTH` / `_SCALE`	Insights アドオンの価格 ID

任意（メール、代替決済、その他）

変数	目的
`RESEND_API_KEY`	トランザクションメール
`ALERT_EMAIL`	インサイトアラートの送信先（デフォルトは `[email protected]`）
`GROQ_API_KEY`	高速なプレビューと下書き生成
`OXAPAY_MERCHANT_KEY`	暗号資産の決済チェックアウト
`PAYSTACK_SECRET_KEY` / `PAYSTACK_PUBLIC_KEY`	NGN カード決済チェックアウト
`FLUTTERWAVE_SECRET_KEY` / `FLUTTERWAVE_PUBLIC_KEY`	アフリカ向けカード決済チェックアウト
`NEXT_PUBLIC_APP_URL`	マジックリンクのベース URL（デフォルトは `https://www.getsignova.com`）
`CORS_ALLOWED_ORIGINS`	カンマ区切りの CORS 許可リスト
`LOG_LEVEL`	`DEBUG` / `INFO` / `WARN` / `ERROR`
`NODE_ENV`	`development` / `production`

管理、cron、連携（任意）

変数	目的
`ADMIN_API_TOKEN`	`/v1/admin/revenue` へのアクセスを制御します
`ADMIN_SECRET`	`api/admin/index-doc.js` へのアクセスを制御します
`BYPASS_ADMIN_SECRET`	`api/create-bypass.js` へのアクセスを制御します
`CRON_SECRET`	`/api/cron/ots-upgrade` を認証します
`POLL_CRON_SECRET`	`/v1/insights/poll` を認証します
`FIELDOPS_API_URL` / `FIELDOPS_INTERNAL_KEY`	FieldOps の予約ブリッジ
`VIGIL_API_URL`	Vigil コンプライアンスバックエンド

デプロイ

このプロジェクトは Vercel にデプロイされています。

プロジェクト：signova
オーナー：ebenovasolu-5755s-projects
vercel.json のリダイレクトでルーティングされるドメイン：apex getsignova.com → www.getsignova.com、apex ebenova.dev → www.ebenova.dev
cron ジョブは vercel.json で設定されています

vercel          # preview deploy
vercel --prod   # production deploy

Vercel → Project Settings → Environment Variables で環境変数を設定してください（上記の一覧と同じ内容）。

テスト

現状 — 提供済みの機能と予定されている機能を正確に記載してください。

領域	状況
`lib/sanitize.js`	完了
`lib/parse-body.js`	完了
`lib/cors-middleware.js`	完了
API エンドポイントの統合テスト	予定
React コンポーネントのテスト	予定

npm test（Vitest）で実行します。npm run test:coverage は v8 カバレッジレポートを出力します。

プロジェクト構成

signova/
├── api/                   # Vercel serverless functions
│   ├── v1/                # Versioned API (auth, billing, documents, insights,
│   │                      #   vigil, scope, contracts, extract, invoices, keys, admin)
│   ├── admin/             # Admin-only operator endpoints
│   ├── cron/              # Scheduled tasks (ots-upgrade)
│   ├── generate.js        # Premium document generation (Claude)
│   ├── generate-preview.js# Free preview generation (Groq)
│   ├── promo-redeem.js    # Promo code redemption (10 codes)
│   ├── stripe-*.js        # Consumer Stripe flow
│   ├── paystack-*.js      # Paystack flow
│   ├── oxapay-*.js        # OxaPay crypto flow
│   ├── mcp.js             # HTTP MCP endpoint
│   └── ...
├── lib/                   # Shared server libraries (auth, CORS, Redis, validators,
│                          #   sanitize, parse-body, logger, analytics)
├── src/                   # React SPA (pages, components, lib, styles)
├── mcp-servers/
│   ├── legal-docs/        # Legal document MCP server (publishable)
│   ├── insights/          # Insights MCP server (publishable)
│   └── scope-guard/       # Scope-guard MCP server
├── tests/                 # Vitest test suite
├── scripts/               # Dev utilities (keygen, CSS token check, etc.)
├── openapi.yaml           # OpenAPI 3.1.0 specification
└── vercel.json            # Vercel routing, redirects, cron

ライセンス

サポート

メール：[email protected]
サイト：getsignova.com

法的免責事項

Signova が生成する文書は情報提供のみを目的としており、法的助言を構成するものではありません。AI が生成した法的文書に依拠する前に、必ず資格を有する弁護士に相談してください。

Markdown 対応

ログインしてコメント

基本情報

作者: dgtalquantumleap-ai
トランスポート: stdio
掲載日: 2026年4月14日
最終更新: 22 週間前

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。