SpecLock - AI Constraint Engine
SpecLock: защита кода от нежелательных патчей и контроль спецификаций для AI-агентов
Что умеет
- Проверять патчи по правилам проекта и выдавать вердикт allow/warn/block
- Хранить цели, решения и заметки проекта в структурированном контексте
- Отслеживать дрейф кода от заданной спецификации
- Логировать изменения и события для аудита
- Формировать отчёты о соответствии и статусе проекта
Какие данные видит
Сервер работает с локальным репозиторием проекта — файлами кода, историей изменений и настройками спецификаций.
Нужен ли аккаунт
Не нужен: сервер работает без входа
SpecLock следит, чтобы правки кода от AI-ассистента не нарушали заданные ограничения проекта. Патч-шлюз выдаёт вердикты allow/warn/block, диф-ревью оценивает изменения по десяти сигналам, а компилятор спецификаций и граф кода помогают агенту держать контекст проекта. Работает с Claude Code, Cursor, Windsurf, Cline и другими средами, бесплатен и открыт.
Как подключить
Как подключить SpecLock - AI Constraint Engine к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://speclock--sgroy10.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить SpecLock - AI Constraint Engine к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://speclock--sgroy10.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить SpecLock - AI Constraint Engine к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://speclock--sgroy10.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (44)
Технические названия из tools/list. Нужны только разработчикам.
| speclock_init | Initialize SpecLock in the current project directory. |
| speclock_get_context | THE KEY TOOL. Returns the full structured context pack. |
| speclock_set_goal | Set or update the project goal. |
| speclock_add_lock | Add a non-negotiable constraint (SpecLock). |
| speclock_remove_lock | Remove (deactivate) a SpecLock by its ID. |
| speclock_add_decision | Record an architectural or design decision. |
| speclock_add_note | Add a pinned note for reference. |
| speclock_set_deploy_facts | Record deployment configuration facts. |
| speclock_log_change | Manually log a significant change. |
| speclock_get_changes | Get recent file changes tracked by SpecLock. |
| speclock_get_events | Get the event log, optionally filtered by type. |
| speclock_check_conflict | Check if a proposed action conflicts with any active SpecLock. In hard mode, blocks above threshold. |
| speclock_session_briefing | Start a new session and get a full briefing. |
| speclock_session_summary | End the current session and record what was accomplished. |
| speclock_checkpoint | Create a named git tag checkpoint for easy rollback. |
| speclock_repo_status | Get current git repository status. |
| speclock_suggest_locks | AI-powered lock suggestions based on project patterns. |
| speclock_detect_drift | Scan recent changes for constraint violations. |
| speclock_health | Health check with completeness score and multi-agent timeline. |
| speclock_apply_template | Apply a pre-built constraint template (nextjs, react, express, supabase, stripe, security-hardened). |
| speclock_report | Violation report — how many times SpecLock blocked changes. |
| speclock_audit | Audit staged files against active locks. |
| speclock_verify_audit | Verify the integrity of the HMAC audit chain. |
| speclock_export_compliance | Generate compliance reports (SOC 2, HIPAA, CSV). |
| speclock_set_enforcement | Set enforcement mode: advisory (warn) or hard (block). |
| speclock_override_lock | Override a lock with justification. Logged to audit trail. |
| speclock_semantic_audit | Semantic pre-commit: analyzes code changes vs locks. |
| speclock_override_history | Show lock override history. |
| speclock_policy_evaluate | Evaluate policy-as-code rules against proposed actions. |
| speclock_policy_manage | Policy CRUD: list, add, remove policy rules. |
| speclock_telemetry | Opt-in usage analytics summary. |
| speclock_guard_file | Add SPECLOCK-GUARD header to lock specific files. |
| speclock_auto_guard | Auto-guard files related to lock keywords. |
| speclock_add_typed_lock | Add typed constraint (numerical/range/state/temporal). |
| speclock_check_typed | Check proposed values against typed constraints. |
| speclock_list_typed_locks | List all typed constraints with current thresholds. |
| speclock_update_threshold | Update typed lock thresholds dynamically. |
| speclock_compile_spec | Compile natural language (PRDs, READMEs) into structured constraints via Gemini Flash. |
| speclock_build_graph | Build/refresh code dependency graph from imports (JS/TS/Python). |
| speclock_blast_radius | Calculate blast radius — transitive dependents, impact %, depth. |
| speclock_map_locks | Map active locks to actual code files via the dependency graph. |
| speclock_review_patch | ALLOW/WARN/BLOCK verdict — combines semantic conflict + lock-file mapping + blast radius. |
| speclock_review_patch_diff | Diff-native review — parses actual diffs for interface breaks, protected symbols, dependency drift, schema changes. |
| speclock_parse_diff | Parse unified diff into structured changes — imports, exports, symbols, routes, schema detection. |