Overture MCP
MCP-сервер рисует план агента интерактивной схемой в браузере и не пускает его писать код, пока вы не нажмете «Одобрить»
- 642 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер запускает локальный веб-интерфейс и WebSocket на портах 3031 и 3030
- История планов в `~/.overture/history.json` хранит все значения полей, а среди типов полей есть секретные, под ключи API
- Прикрепленные к узлам файлы и инструкции попадают в контекст агента перед выполнением шага
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/overtureОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер запускает локальный веб-интерфейс и WebSocket на портах 3031 и 3030
- История планов в `~/.overture/history.json` хранит все значения полей, а среди типов полей есть секретные, под ключи API
- Прикрепленные к узлам файлы и инструкции попадают в контекст агента перед выполнением шага
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Overture перехватывает этап планирования у ИИ-агента и показывает его в виде схемы на локальной странице. Агент отправляет план через инструмент submit_plan, шаги появляются на холсте по мере генерации, а инструмент get_approval держит агента в ожидании, пока вы не одобрите план. На странице шаги можно открывать и дополнять. У каждого узла видны сложность, ожидаемый результат, возможные проблемы и крайние случаи. К узлу прикрепляют файлы, пишут собственные инструкции («используй паттерн авторизации из src/auth.ts»), а там, где агент предлагает несколько путей, сравнивают варианты с плюсами и минусами и выбирают один. Узлы могут запрашивать значения: строку, число, переключатель, список, файл или секретное поле для ключа API. Кнопка одобрения остается неактивной, пока не заполнены обязательные поля и не выбраны развилки. После одобрения узлы подсвечиваются по ходу выполнения, а результат каждого шага собирается в структуру: измененные и созданные файлы, установленные пакеты, поисковые запросы, вызовы инструментов. Пробел ставит выполнение на паузу, упавший узел или всю цепочку с выбранного шага перезапускают кнопкой, а шаги вставляют и удаляют прямо во время работы. Планы сохраняются в `~/.overture/history.json`, и любой прошлый план можно открыть и продолжить.
Для кого. Разработчикам, которые работают с Claude Code, Cursor, Cline или GitHub Copilot и хотят проверить план агента до того, как он потратит токены на код.
Подходит, если
- Большая задача вроде «собери REST API с авторизацией», и вы хотите увидеть шаги и их зависимости до первой строки кода
- Агент предлагает несколько подходов, и вы хотите сравнить плюсы и минусы рядом, а выбрать самому
- Шагу нужны ключ API, файл или имя проекта, и их удобнее ввести в форму узла, чем писать в чат
- Один узел упал, и нужно перезапустить его или всю цепочку с этого места, не начиная заново
- Над несколькими проектами работают одновременно: Overture держит вкладку на каждый и показывает, где появились обновления
Не подходит, если
- Задача на одну правку в одном файле: план на схеме займет больше времени, чем сама правка
- Агент не подключает MCP-серверы: Overture работает только через MCP
- Нужна работа на удаленной машине без браузера: интерфейс открывается на локальном порту 3031
- Вам достаточно текстового плана в чате: схема нужна, когда много зависимостей, развилок или входных данных
Пример запроса к агенту
Собери REST API с авторизацией. Сначала отправь план в Overture и жди моего одобрения, код начинай только после негоMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
OVERTURE_HTTP_PORT- Порт веб-интерфейса, по умолчанию 3031
OVERTURE_WS_PORT- Порт WebSocket, по умолчанию 3030
OVERTURE_AUTO_OPEN- Открывать браузер при запуске, по умолчанию true
Ограничения
Нужен Node.js, сервер запускается через `npx overture-mcp`. Веб-интерфейс по умолчанию открывается на порту 3031, WebSocket работает на 3030, браузер при старте открывается сам. Порты и автооткрытие меняют переменные OVERTURE_HTTP_PORT, OVERTURE_WS_PORT и OVERTURE_AUTO_OPEN.
Для GitHub Copilot нужен VS Code 1.99 или новее, конфигурация лежит в `.vscode/mcp.json` и использует ключ servers вместо mcpServers.
Для каждого агента в пакете лежит отдельный набор инструкций, и схема появляется, когда агент им следует. Пакет вышел в версии 0.1.8.
Как отключить. В Claude Code выполните `claude mcp remove overture-mcp`. В Cursor, Cline и Sixth AI уберите блок overture из файла настроек MCP, в Copilot из `.vscode/mcp.json`. Если ставили пакет глобально, снимите его командой `npm uninstall -g overture-mcp`. История планов остается в `~/.overture/history.json`, ее можно удалить вручную.
Частые вопросы
Как поставить Overture в Claude Code?
Выполните `claude mcp add overture-mcp -- npx overture-mcp`. Затем дайте агенту любую задачу: Overture откроет страницу `http://localhost:3031` с планом, который ждет одобрения. Переменные окружения передаются флагом -e, например `-e OVERTURE_HTTP_PORT=4000`.
Как подключить Overture к Cursor или Cline?
Добавьте в `~/.cursor/mcp.json` блок overture с command npx и args overture-mcp. Для Cline такой же блок вставляется в настройки MCP в VS Code. GitHub Copilot использует `.vscode/mcp.json` и ключ servers, Sixth AI читает свой файл настроек sixth-mcp-settings.json.
Какие инструменты MCP дает Overture агенту?
Одиннадцать: submit_plan, get_approval, update_node_status, plan_completed, plan_failed, check_rerun, check_pause, get_resume_info, request_plan_update, create_new_plan и get_usage_instructions. Первые три нужны для главной петли: агент отправляет план, ждет одобрения и сообщает статус шагов.
Что будет, если порт WebSocket уже занят?
Overture включится в режиме relay и перешлет сообщения через уже запущенный сервер. Так несколько экземпляров агента делят один интерфейс.
Можно ли менять план после начала выполнения?
Да. Через инструмент request_plan_update агент вставляет, удаляет и заменяет узлы, а страница показывает разницу цветом: зеленым новые узлы, красным удаленные, желтым измененные, со сравнением до и после.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСкилл держит план задачи в файлах на диске и переносит его в контекст на каждом шаге, чтобы работа переживала очистку контекста, компактизацию и сбои
Планировщик для Claude Code, Codex и OpenCode: цель превращается в план задач, независимые идут параллельно
MCP-сервер самостоятельной ИИ-платформы Synaplan: семантический поиск по вашим документам, долговременная память и чат
Агенты и скиллы для структурной разработки с ИИ в OpenCode, Codex и Claude Code: документация, планы, ревью, контрольные точки
CLI запускает параллельные сессии Claude Code по вашему плану: каждая в своем git worktree, с проверкой этапов и базой знаний
Хранилище шаблонов промптов с поиском и подстановкой переменных, плюс скрипт, который запускает агентов Claude по всему проекту.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Overture (эта карточка) | нет | не нужна | 642 | |
| Plannotator | нет | 10 168 | размечает готовый план агента и дифы в браузере и возвращает замечания агенту | |
| MCP Shrimp Task Manager | нет | не нужна | 2 151 | разбивает задачу на шаги с зависимостями и держит контекст между сессиями без визуального холста |
Коротко о README
README начинается с проблемы: агенты вроде Cursor и Claude Code сразу пишут код, а текстовый план в чате не показывает зависимости, развилки и сложность. Решение описано как визуальный слой между запросом и кодом, затем идут установка для пяти агентов, пошаговый сценарий от запроса до управления выполнением и подробные таблицы функций: холст, панель узла, динамические поля, вложения, развилки, история, изменение плана на ходу. В конце перечислены инструменты MCP, сообщения WebSocket, переменные окружения, горячие клавиши и стек разработки.