Schematic

Schematic MCP サーバー

警告

非推奨です。 Schematic は現在、https://api.schematichq.com/mcp で MCP サーバーをホストしています。接続方法については、Schematic MCP ドキュメントをご覧ください。このローカルの stdio サーバーは引き続き動作しますが、新しいツールの追加や修正は今後行われません。

AI アシスタントを、請求、プラン、機能、エンタイトルメントを管理するプラットフォームである Schematic に接続する MCP サーバーです。

このサーバーを使うと、Claude、Cursor、または MCP 対応クライアントが、自然言語を通じて企業の検索、プランのエンタイトルメントの管理、オーバーライドの設定、機能の作成などを行えます。

クイックスタート

前提条件

1. Schematic のシークレット API キーを取得する：Schematic アカウントに登録し、Schematic ダッシュボードからシークレット API キーを取得します。注：パブリッシャブルキーではなく、シークレット API キーを使用してください。

インストール

オプション 1：Claude CLI を使用する（推奨）

1. npm からパッケージをインストールします：

   npm i @schematichq/schematic-mcp
   

2. MCP サーバーを Claude に追加します：

   claude mcp add --transport stdio --scope project schematic --env SCHEMATIC_API_KEY=your-secret-api-key-here -- npx @schematichq/schematic-mcp
   

   your-secret-api-key-here を実際の Schematic API キーに置き換えてください。

オプション 2：手動で設定する

Claude Desktop / Claude Code

Claude の設定（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-secret-api-key-here"
      }
    }
  }
}

Cursor

Cursor の MCP 設定（Settings > MCP Servers、またはファイルを直接編集）に追加します：

• macOS：~/.cursor/mcp.json
• Linux：~/.cursor/mcp.json
• Windows：%USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-secret-api-key-here"
      }
    }
  }
}

設定を追加したら、サーバーを認識させるために Cursor を再起動してください。

設定

このサーバーには、Schematic のシークレット API キーが必要です（パブリッシャブルキーではありません）。次の2つのソースを順番に確認します：

1. 環境変数（推奨）：SCHEMATIC_API_KEY
2. 設定ファイル（フォールバック）：~/.schematic-mcp/config.json

{
  "apiKey": "your-secret-api-key-here"
}

シークレット API キーは、Schematic ダッシュボードで確認できます。

カスタム API ベース URL（任意）

デフォルトでは、サーバーは本番環境の Schematic API を使用します。ローカルまたは本番以外の API を指定するには、SCHEMATIC_API_URL を設定します：

{
  "command": "npx",
  "args": ["@schematichq/schematic-mcp"],
  "env": {
    "SCHEMATIC_API_KEY": "your-secret-api-key-here",
    "SCHEMATIC_API_URL": "http://localhost:8080"
  }
}

未設定の場合は、SDK の本番環境向けデフォルト値が使用されます。

ツール

企業の検索

ツール	説明
get_company	ID、名前、Stripe 顧客 ID、またはカスタムキーで企業を検索します。詳細、プラン、トライアルの状態、リンクを返します。
create_company	キー（keyName/keyValue）で識別される企業を作成（アップサート）します。name と traits は任意です。キーがすでに存在する場合は、企業を更新します。
get_company_plan	企業が現在利用しているプランを取得します。
get_company_trial_info	企業がトライアル中かどうか、および終了日時を確認します。
count_companies_on_plan	特定のプランを利用している企業の数をカウントします。
link_stripe_to_schematic	Stripe 顧客 ID に対応する Schematic の企業、またはその逆を検索します。

企業のオーバーライド

ツール	説明
list_company_overrides	企業または機能ごとにオーバーライドを一覧表示します。
set_company_override	特定の機能について、企業のオーバーライドを設定または更新します。ブール値（on/off）、数値、unlimited の値に対応しています。
remove_company_override	オーバーライドを削除し、企業がプランのエンタイトルメントに戻るようにします。

プラン管理

ツール	説明
list_plans	すべてのプランを一覧表示します。
create_plan	新しいプランを作成します。
add_entitlements_to_plan	プランに機能のエンタイトルメントを追加します。機能の種類を自動検出し、適切な値の型を設定します。

機能管理

ツール	説明
list_features	すべての機能を一覧表示します。
create_feature	新しい機能フラグを作成します。ブール値（オン／オフ）、イベントベース（従量制）、トレイトベースのタイプに対応しています。関連するフラグも自動的に作成します。

フラグ管理

ツール	説明
list_flags	ターゲティングの概要とともに、すべてのフラグを一覧表示します。各フラグについて、キー、デフォルト値、関連付けられた機能、および常にオン、常にオフ、ターゲティング済みのいずれに解決されるかを確認できます。常にオンのフラグ（コード内で確認する必要がなく冗長）や未使用のフラグ（削除候補）の監査に役立ちます。
get_flag	キーを指定して、1つのフラグのターゲティングの詳細を取得します。デフォルト値、各ルール（タイプ、値、優先度、条件の数）、最終確認時刻、および常にオン／常にオフ／ターゲティング済みの判定を確認できます。

プロンプトの例

設定が完了したら、AI アシスタントに次のように尋ねてみてください。

• 「Acme Corp はどのプランを利用していますか？」
• 「すべてのプランと、その機能を一覧表示して」
• 「『Advanced Analytics』というブール値の機能を作成して」
• 「Acme Corp の API 呼び出し数を無制限にするオーバーライドを設定して」
• 「Pro プランを利用している会社はいくつありますか？」
• 「Stripe の顧客 cus_abc123 にリンクされている Schematic の会社を探して」
• 「すべてのフラグを一覧表示して、常にオンのものを教えて」
• 「billing.credits フラグのターゲティングルールを表示して」

開発

# Install dependencies
yarn install

# Build
yarn build

# Run in development mode (auto-recompile on changes)
yarn dev

# Run tests
yarn test

ライセンス

MIT