Плагин SanctionsKit

Создавайте интеграции SanctionsKit прямо в редакторе. Находите документацию API, проверяйте форматы запросов и тестируйте вымышленные объекты в песочнице.

Плагин включает подключение к размещённому серверу SanctionsKit MCP и навык интеграции для Codex, Claude Code и Cursor. Локальный сервер запускать не нужно, сценарий установки не требуется.

Отдельное расширение Gemini CLI подключается к четырём общедоступным инструментам для работы с документацией, схемами и проверкой запросов. Для него не нужны учётная запись SanctionsKit и API-ключ; инструменты работы с учётной записью в песочнице недоступны.

Документация · Руководство по MCP · Аутентификация · Лицензия MIT

Начало работы

Клонируйте этот репозиторий и откройте его папку. Установите плагин по инструкциям для своего клиента, затем попробуйте выполнить запрос:

Найди схему запроса для проверки в SanctionsKit и проверь вымышленный пример, не отправляя его.

Для работы с документацией, схемами и проверкой запросов учётная запись SanctionsKit не нужна. Инструменты работы с учётной записью в песочнице требуют подключения к рабочей области SanctionsKit. На размещённом сервисе необходимо настроить регистрацию OAuth для каждого клиента. См. настройку аутентификации.

Подключение к размещённому серверу MCP

Также можно подключиться напрямую из MCP-клиента по протоколу Streamable HTTP:

https://www.sanctionskit.com/mcp

Для общедоступных инструментов работы с документацией, схемами и проверкой учётные данные не нужны. Чтобы пользоваться инструментами учётной записи в песочнице, войдите через OAuth-подключение клиента после регистрации его client ID и callback URL в SanctionsKit. Запрашиваются области доступа sources:read, screenings:write, results:read и usage:read. Инструкции по настройке клиента и проверке статуса регистрации см. в разделе настройки аутентификации.

Codex

Перейдите в корневую папку репозитория и выполните:

codex plugin marketplace add .

Откройте папку плагина в Codex, выберите маркетплейс SanctionsKit и установите SanctionsKit. После установки начните новую задачу. Для установки с GitHub передайте той же команде HTTPS URL этого репозитория вместо ..

Claude Code

Запустите Claude Code из корневой папки репозитория:

/plugin marketplace add .
/plugin install sanctionskit@sanctionskit

В команду /plugin marketplace add также можно передать HTTPS URL этого репозитория на GitHub. После установки перезапустите Claude Code. Используйте /mcp, чтобы проверить подключение, и войдите в систему, если нужны инструменты работы с учётной записью.

Cursor

Для локальной установки включите в Cursor параметр Allow Local Plugin Imports, скопируйте папку плагина в локальную папку плагинов и перезагрузите Cursor. Политики организации могут требовать, чтобы администратор разрешил локальный импорт.

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

Эта команда предназначена для первой установки. При обновлении замените существующую папку sanctionskit. Используйте именно копирование: Cursor не обрабатывает внешние цели символических ссылок. Администраторы команд могут выбрать Import from Repo в маркетплейсе плагинов команды и указать URL этого репозитория на GitHub. Для размещения плагина в публичном каталоге 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 не устанавливает навык интеграции, входящий в комплект для других клиентов. Если в файле settings.json Gemini уже настроен сервер с именем 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 или определённой конечной точки.

Попробуйте также:

• «Покажи, как добавить проверку SanctionsKit в серверное приложение на TypeScript».

• «Проверь запрос sandbox@1 для вымышленной организации».

• «Запусти синтетический пример Alex Morgan, затем покажи результат и оставшийся лимит песочницы».

• «Объясни, как повторить запрос после истечения времени ожидания».

См. примеры синтетических запросов и примеры аргументов MCP.

Работа песочницы

Инструменты MCP для работы с учётной записью используются в песочнице. Ключи для production-среды отклоняются. Проверка в песочнице расходует её лимит, сохраняет материалы в соответствии с политикой хранения и может создать дело для проверки. Для каждой новой проверки используйте новый ключ идемпотентности. При повторной отправке запроса, на который не был получен ответ, не меняйте ключ и содержимое запроса.

Проверка оценивает только структуру. Записи каталога источников не влияют на синтетическое покрытие песочницы. Синтетический результат ничего не говорит о реальном человеке или организации, а отсутствие совпадений не является юридическим подтверждением благонадёжности. Для production-интеграций используйте REST API на стороне сервера и процедуры проверки, принятые в вашей организации.

Устранение неполадок

Проблема	Что проверить
Плагин не отображается	Добавьте корень репозитория как маркетплейс, установите плагин и начните новый сеанс.
Ошибка invalid_client или перенаправления	Проверьте точность client ID и зарегистрированного callback URL в разделе настройки аутентификации.
Ошибка входа или разрешений	Повторно подключите рабочую область песочницы с необходимыми областями доступа.
Порт уже используется	Закройте другой процесс входа, использующий этот порт, и повторите попытку.
Ключ production-среды отклонён	Для MCP используйте подключение к песочнице, а production-интеграцию выполняйте через REST API.
Срок действия результата истёк	Сообщите об истечении срока; создавайте новую проверку, только если действительно нужно запустить её заново.
Ошибка покрытия или лимита	Изучите полученную ошибку и текущее использование песочницы. Не переключайте покрытие без уведомления.

Разработка

Для проверок репозитория требуется Node.js версии 22 или выше. Зависимости npm отсутствуют.

npm ci
npm run check
npm run smoke

Команда check проверяет структуру пакета и запускает автономные тесты. Команда smoke проверяет общедоступную конечную точку MCP и запрос аутентификации, не выполняя вход и не создавая проверок. Успешная проверка smoke не подтверждает, что интерактивный вход работает в клиенте.

.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. Если вам нужна помощь, напишите на support@sanctionskit.com. На этот репозиторий распространяется лицензия MIT; использование размещённого сервиса регулируется условиями SanctionsKit и политикой конфиденциальности.