SpecPilot — MCP-сервер для Claude Code: что делает и как установить
Разворачивает спецификации проекта в каталоге .specs/ и удерживает ИИ-агента в рамках архитектуры и задач.
claude mcp add --transport http specpilot https://init.specpilot.dev/mcpЧто делает SpecPilot
SpecPilot реализует разработку на основе спецификаций (SDD) для ассистентов в редакторах кода. Сервер помогает агенту изучить структуру репозитория, составить требования и сформировать каталог .specs/. Внутри каталога хранятся архитектурные решения, правила и списки задач, чтобы агент не уходил в сторону от утверждённого плана.
Подключить инструмент можно как удалённый HTTP MCP-сервер по адресу https://init.specpilot.dev/mcp без локальной сборки и токенов. Если запускать CLI через npm, команда specpilot serve поднимет локальный сервер на порту 4321 с веб-интерфейсом для перемещения задач между спринтами и проверки готового кода.
Для базового онбординга через облачную точку локальный Node.js не нужен. Однако для валидации файлов командой validate или архивации разросшихся заметок потребуется пакет specpilot.
Какие задачи решает
- зафиксировать архитектурные требования и задачи в директории
.specs/ - провести первичный онбординг ИИ-агента в существующем репозитории
- проверить корректность файлов спецификаций командой валидации
- управлять спринтами и статусами задач через локальный веб-интерфейс
Примеры запросов агенту
- Проведи онбординг текущего проекта через SpecPilot и сформируй спецификации
- Проверь файлы в папке
.specs/на ошибки и несоответствия - Создай структуру спецификаций для нового сервиса на FastAPI
Как установить SpecPilot
Командой платформы: удалённый сервер
claude mcp add --transport http specpilot https://init.specpilot.dev/mcpКомандой платформы: удалённый сервер
codex mcp add specpilot --url https://init.specpilot.dev/mcpФайл настроек
{
"mcpServers": {
"specpilot": {
"url": "https://init.specpilot.dev/mcp"
}
}
}Файл настроек
{
"servers": {
"specpilot": {
"type": "http",
"url": "https://init.specpilot.dev/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http specpilot https://init.specpilot.dev/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о SpecPilot
Как установить SpecPilot в Claude Code?
Выполните команду: claude mcp add --transport http specpilot https://init.specpilot.dev/mcp.
Что делает MCP-сервер SpecPilot?
Он даёт агенту инструменты для анализа кодовой базы и создания структуры требований в папке .specs/. Это помогает ИИ ориентироваться на архитектуру и не нарушать правила проекта.
Нужен ли API-ключ для работы?
Удалённый сервер доступен по протоколу HTTP без ключей авторизации. Для локального веб-интерфейса достаточно установить утилиту через npm install -g specpilot.
