SanctionsKit developer MCP

SanctionsKit プラグイン

エディターから SanctionsKit の連携機能を構築できます。API ドキュメントを探し、リクエスト形式を確認し、サンドボックスで架空の対象者をテストできます。

このプラグインには、ホスト型の SanctionsKit MCP サーバーへの接続と、Codex、Claude Code、Cursor 向けの連携スキルが含まれています。ローカルでサーバーを実行する必要も、インストールスクリプトもありません。

別途提供される Gemini CLI 拡張機能は、ドキュメント、スキーマ、リクエスト検証用の4つの公開ツールに接続します。SanctionsKit アカウントや API キーは不要で、サンドボックスアカウント用ツールにはアクセスできません。

ドキュメント · MCP ガイド · 認証 · MIT ライセンス

はじめに

このリポジトリをクローンし、そのディレクトリを開きます。以下のクライアント別の手順でインストールしてから、次のように試してください。

SanctionsKit のスクリーニングリクエストスキーマを探し、送信せずに架空の例を検証してください。

ドキュメント、スキーマ、リクエスト検証は SanctionsKit アカウントなしで利用できます。サンドボックスアカウント用ツールを利用するには、SanctionsKit ワークスペースへの接続が必要です。各クライアントの OAuth 登録はホスト型サービスで設定する必要があります。認証の設定をご覧ください。

ホスト型 MCP サーバーに接続する

Streamable HTTP を使用して、次のアドレスから MCP クライアントに直接接続することもできます。

https://www.sanctionskit.com/mcp

公開されているドキュメント、スキーマ、検証用ツールの利用に認証情報は不要です。サンドボックスアカウント用ツールを利用するには、クライアント ID とコールバックを SanctionsKit に登録した後、クライアントの OAuth 接続フローからサインインしてください。要求されるスコープは sources:read、screenings:write、results:read、usage:read です。クライアントの設定と検証状況については、認証の設定をご覧ください。

Codex

リポジトリのルートから実行します。

codex plugin marketplace add .

Codex でプラグインディレクトリを開き、SanctionsKit マーケットプレイスを選択して、SanctionsKit をインストールします。インストール後、新しいタスクを開始してください。GitHub からインストールする場合は、同じコマンドの . の代わりに、このリポジトリの HTTPS GitHub URL を指定します。

Claude Code

リポジトリのルートで Claude Code を起動します。

/plugin marketplace add .
/plugin install sanctionskit@sanctionskit

このリポジトリの HTTPS GitHub URL を /plugin marketplace add に渡すこともできます。インストール後、Claude Code を再起動してください。接続を確認するには /mcp を使い、アカウント用ツールが必要な場合はサインインします。

Cursor

ローカルにインストールするには、Cursor で Allow Local Plugin Imports を有効にし、プラグインフォルダーをローカルのプラグインディレクトリにコピーしてから、Cursor を再読み込みします。エンタープライズポリシーによっては、ローカルインポートを管理者が許可する必要があります。

mkdir -p ~/.cursor/plugins/local
cp -R plugins/sanctionskit ~/.cursor/plugins/local/

このコマンドは初回インストール用です。更新時は既存の sanctionskit フォルダーを置き換えてください。Cursor は外部のシンボリックリンク先をスキップするため、実際にコピーしてください。チーム管理者は、チームのプラグインマーケットプレイスでこのリポジトリの GitHub URL を指定し、Import from Repo を使用できます。Cursor の公開ディレクトリへの掲載には、別途申請が必要です。

Gemini CLI

このリポジトリから拡張機能をインストールします。

gemini extensions install https://github.com/SanctionsKit/sanctions-kit-mcp-plugin

Gemini CLI を再起動し、/mcp を使って sanctionskit の接続を確認します。次のように試してください。

SanctionsKit のスクリーニングリクエストスキーマを探し、送信せずに架空の例を検証してください。

ルートの gemini-extension.json は Streamable HTTP を使用し、search_docs、get_doc、get_api_schema、validate_screening_request のみを許可します。認証情報、OAuth 設定、ローカル実行ファイル、バンドルされたコンテキストファイルは含まれていません。リクエストの検証では構造のみを確認し、スクリーニングの送信や実在する対象の確認は行いません。Gemini CLI 自体のアクセス要件は引き続き適用されます。

サンドボックスでのスクリーニングやその他のアカウントツールは、この拡張機能には含まれていません。他のクライアント向けにバンドルされたインテグレーションスキルは、Gemini 拡張機能にはインストールされません。Gemini の settings.json ですでに sanctionskit という名前のサーバーを設定している場合は、その設定が優先されます。この拡張機能のパブリックツール設定を使用する場合は、既存の設定を削除するか、名前を変更してください。

できること

ツール	用途	接続
search_docs	インテグレーションガイドとドキュメントのスラッグを検索します	パブリック
get_doc	公開カタログからドキュメントを読み込みます	パブリック
get_api_schema	REST オペレーション、スキーマ、例を確認します	パブリック
validate_screening_request	送信せずにリクエストの構造を確認します	パブリック
list_sources	ソースのメタデータと利用可否を確認します	サンドボックスワークスペース
run_sandbox_screening	架空の対象を sandbox@1 に送信します	サンドボックスワークスペース
get_screening_result	保持されているサンドボックスの証跡を取得します	サンドボックスワークスペース
get_usage	サンドボックスの利用枠と予約を確認します	サンドボックスワークスペース
get_profile	接続中のプロファイルを確認します	サンドボックスワークスペース

バンドルされた sanctionskit-integration スキルでは、リクエストの設計、検証、エラー処理、再試行、サンドボックス結果の解釈を扱います。SDK やエンドポイントが存在すると仮定せず、現在のツールスキーマとドキュメントを使用します。

次の例も試してください。

• 「サーバーサイドの TypeScript アプリに SanctionsKit のスクリーニングを追加する方法を教えてください。」
• 「架空の組織について、sandbox@1 のリクエストを検証してください。」
• 「合成データの Alex Morgan の例を実行し、結果と残りのサンドボックス利用枠を表示してください。」
• 「タイムアウト後にリクエストを再試行する方法を説明してください。」

合成リクエストの例と MCP 引数の例を参照してください。

サンドボックスの動作

MCP のアカウントツールはサンドボックスで動作します。本番環境のキーは拒否されます。サンドボックスでスクリーニングを行うと、サンドボックスの利用枠を消費し、保持ポリシーに従って証跡が保存され、レビューケースが作成されることがあります。新たにスクリーニングを実行する場合は、新しい冪等性キーを使用してください。応答を受信できなかったリクエストを再試行する場合は、キーとペイロードの両方を変更せずに使用してください。

検証では構造のみを確認します。ソースカタログの項目によって、サンドボックスの合成データのカバレッジが変わることはありません。合成結果から実在する人物や組織について何かを判断することはできず、一致なしという結果も法的な確認を意味するものではありません。本番環境のインテグレーションでは、サーバーサイドの REST API と組織のレビュー手順を使用してください。

トラブルシューティング

問題	確認すること
プラグインが表示されない	リポジトリのルートをマーケットプレイスとして追加し、プラグインをインストールして、新しいセッションを開始してください。
invalid_client またはリダイレクトエラー	認証の設定で、クライアント ID と登録済みのコールバックが正確か確認してください。
サインインまたは権限エラー	必要なスコープを指定して、サンドボックスワークスペースに再接続してください。
ポートがすでに使用中	そのポートを使用している別のログインフローを閉じてから、再試行してください。
本番用キーが拒否される	MCP にはサンドボックス接続を使用し、本番環境との連携には REST API を使用してください。
結果の有効期限が切れている	有効期限切れを報告してください。新しい実行を意図している場合に限り、新しいスクリーニングを作成してください。
カバレッジまたは利用枠のエラー	返されたエラーと現在のサンドボックス利用状況を確認してください。カバレッジを黙って切り替えないでください。

開発

リポジトリのチェックにのみ、Node.js 22 以降が必要です。npm の依存関係はありません。

npm ci
npm run check
npm run smoke

check はパッケージ構造を検証し、オフラインテストを実行します。smoke はサインインやスクリーニングの作成を行わずに、公開されているホスト型 MCP エンドポイントとその認証チャレンジを確認します。スモークチェックに合格しても、クライアントの対話型サインインが機能することは確認できません。

.agents/plugins/       Codex marketplace
.claude-plugin/        Claude Code marketplace
.cursor-plugin/        Cursor marketplace
gemini-extension.json  Gemini CLI public-tool extension
plugins/sanctionskit/  Installable plugin, client configs, skill, and assets
docs/                  Authentication and release guidance
scripts/               Package validation and public connection check
tests/                 Offline verification

変更についてはCONTRIBUTING.mdを、公開についてはリリースガイドを参照してください。

SanctionsKit, LLC が保守しています。サポートが必要な場合は、[email protected]までお問い合わせください。このリポジトリには MIT ライセンスが適用されます。ホスト型サービスの利用には、SanctionsKit の利用規約とプライバシーポリシーが適用されます。