Vorobeoffdevspace — это self-hosted MCP-сервер, который даёт ChatGPT и другим MCP-совместимым клиентам прямой доступ к локальной файловой системе разработчика. После подключения ChatGPT может читать и редактировать файлы проекта, искать код, запускать команды в терминале и работать с Git — всё это без загрузки данных на сторонний сервер.
MCP (Model Context Protocol) — открытый протокол, который позволяет языковым моделям взаимодействовать с внешними инструментами. ChatGPT поддерживает MCP-инструменты, и devspace использует этот протокол как мост между облачной моделью и локальным окружением.
Проект появился на Codex-хакатоне в июне 2026 года. На момент подготовки материала репозиторий собрал 3170 звёзд и 332 форка.
Что это
devspace — self-hosted MCP-сервер: программа, которую вы запускаете на своём компьютере. Она создаёт локальный эндпоинт, к которому через защищённый туннель подключается облачный клиент — ChatGPT или Claude. После подключения модель получает инструменты для чтения, редактирования и запуска кода в выбранных вами папках проекта.
Протокол MCP (Model Context Protocol) — открытый стандарт, который описывает, как языковые модели могут вызывать внешние инструменты. Поддержка MCP встроена в ChatGPT, Claude и другие современные клиенты. devspace реализует MCP-серверную часть: он объявляет набор инструментов (чтение файлов, поиск, запуск команд) и обрабатывает запросы от подключённого клиента.
Зачем нужно
OpenAI разделил два продукта с разными моделями и разными лимитами использования:
- ChatGPT — интерфейс с доступом к продвинутым моделям (GPT-5.5 Pro). Мощная универсальная модель для планирования, исследования кодовой базы, разбора архитектуры и постановки задач. Но ChatGPT не имеет доступа к локальной файловой системе.
- Codex — агент для написания кода. Работает с локальным окружением, читает файлы, запускает команды, делает коммиты. Но основная рекомендуемая модель — GPT-5.5, а не GPT-5.5 Pro.
Ключевое наблюдение: ChatGPT и Codex имеют раздельные лимиты. Можно использовать оба продукта параллельно — продвинутую модель в ChatGPT для планирования и исследования, Codex для написания кода — и фактически удвоить доступный объём работы, не упираясь в общий лимит.
devspace решает техническую часть этой задачи: через MCP-сервер он открывает локальное dev-окружение для ChatGPT, после чего ChatGPT получает возможность видеть файлы проекта и передавать задачи в Codex.
Как устроено
Архитектура devspace состоит из трёх компонентов:
- MCP-сервер — принимает запросы от ChatGPT и предоставляет инструменты для работы с локальным окружением. Сервер запускается локально и выступает мостом между ChatGPT (облако) и файловой системой (локально).
- Туннель — публичный HTTPS-эндпоинт, через который облачный клиент подключается к локальному серверу. Поддерживаются Cloudflare Tunnel, ngrok, Pinggy, Tailscale Funnel и другие reverse proxy.
- Авторизация по паролю — при подключении клиента devspace открывает страницу одобрения с Owner-паролем, который создаётся при инициализации. Пароль хранится в ~/.devspace/auth.json.
После подключения ChatGPT может:
- читать, записывать и редактировать файлы внутри открытого workspace
- искать код и просматривать директории
- запускать shell-команды для тестов, сборок, Git и пакетных скриптов
- использовать изолированные Git worktrees для параллельных сессий
- следовать инструкциям из AGENTS.md и CLAUDE.md
- обнаруживать локальные agent skills из папок навыков
Поддерживаемые платформы:
| Платформа | Статус | Примечания |
|---|---|---|
Linux | Поддерживается | Требует Node, npm, Git, Bash |
macOS | Поддерживается | Требует Node, npm, Git, Bash |
Windows с Git Bash, WSL, MSYS2 | Поддерживается | Git Bash — самый простой вариант |
Windows PowerShell или cmd.exe только | Не поддерживается | Нужен Git Bash или WSL |
Когда использовать
| Кто | Зачем |
|---|---|
Разработчики на ChatGPT Pro | Уже есть подписка с доступом к продвинутым моделям — devspace позволяет получить максимум от обоих продуктов без доплаты |
Команды, активно использующие Codex | Лимиты Codex становятся реальным ограничением. Перенос исследования и планирования в ChatGPT освобождает лимит Codex для кода |
Вайбкодеры на незнакомых кодовых базах | ChatGPT через devspace исследует структуру и объясняет архитектуру, Codex реализует изменения |
Пример
Установка через npm:
npm install -g @waishnav/devspaceИнициализация и запуск:
devspace init
devspace serveБез глобальной установки:
npx @waishnav/devspace init
npx @waishnav/devspace serveПри инициализации devspace запрашивает:
- локальные папки проектов, которые ChatGPT может открывать
- локальный порт (обычно 7676)
- публичный HTTPS URL из туннеля (Cloudflare Tunnel, ngrok, Pinggy, Tailscale Funnel)
Подключение MCP-клиента:
http://127.0.0.1:7676/mcpЧерез публичный туннель:
https://your-tunnel-host.example.com/mcpРабочий процесс разделён на два этапа по принципу «лучшая модель для каждой задачи».
Этап 1 — планирование в ChatGPT. С подключённым devspace MCP-сервером ChatGPT видит проект. Вопросы высокого уровня: «Как устроена авторизация?», «Где добавить модуль кэширования?», «Какие файлы поменять для поддержки WebSocket?» Модель исследует кодовую базу, формирует план изменений, определяет список файлов.
Этап 2 — исполнение в Codex. Готовый план и список задач передаются в Codex. Codex не тратит токены на исследование — он получает сформулированное задание и приступает к написанию кода, тестов и коммитам.
Проверка окружения:
devspace doctorОграничения
Проект появился на хакатоне и быстро вырос, но требует осознанного подхода.
| Пункт | Пояснение |
|---|---|
Хакатон-происхождение — код хакатона обычно требует доработки перед использованием в серьёзных проектах. | Несмотря на рост сообщества, код не проходил формальный security-аудит. |
Зависимость от политики OpenAI — если OpenAI изменит политику раздельных лимитов или добавит продвинутые модели напрямую в Codex, основное преимущество devspace частично исчезнет. | MCP-коннектор для доступа к локальному окружению останется полезным и в этом случае. |
Требует туннеля — для подключения облачного клиента к локальному серверу нужен публичный HTTPS-эндпоинт. | Это дополнительный компонент инфраструктуры, который нужно настраивать и поддерживать. |
Только Node 22.19–27 — узкий диапазон версий Node.js. | На серверах с другими версиями потребуется nvm или docker. |
Windows без Bash не поддерживается | — для Windows обязателен Git Bash, WSL, MSYS2 или Cygwin. |
Антипаттерны
Чего не делать
| Пункт | Пояснение |
|---|---|
Запускать с правами root — MCP-сервер даёт облачному клиенту доступ к файловой системе и терминалу. | Запуск с root превращает это в полный доступ к системе. |
Передавать секреты через MCP-сервер — API-ключи, пароли и токены, переданные в ChatGPT через devspace, уходят в облако OpenAI. | Контекст не изолирован. |
Открывать все папки — devspace позволяет выбрать, какие папки доступны клиенту. | Открывать корень файловой системы или домашнюю директорию целиком — избыточный риск. |
Использовать без Owner-пароля — пароль авторизации создаётся при инициализации. | Отключать проверку или использовать пустой пароль — прямой путь к несанкционированному доступу. |
Полагаться только на devspace без проверки плана | — продвинутая модель сильна в планировании, но финальный план всё равно нужно проверять перед передачей в Codex. |
Чеклист
Проверка перед запуском
| Пункт | Пояснение |
|---|---|
Node версии 22.19–27 | — установлена и активна, проверка через node —version. |
Bash-совместимая оболочка | — доступна (на Windows — Git Bash или WSL). |
Туннель настроен | — Cloudflare Tunnel, ngrok или альтернатива запущен, публичный HTTPS URL известен. |
devspace init выполнен | — Owner-пароль сохранён в ~/.devspace/auth.json, разрешённые папки выбраны. |
devspace serve запущен | — сервер слушает порт 7676 (или настроенный). |
MCP-клиент подключён | — ChatGPT или Claude подключен к публичному /mcp URL. |
Авторизация пройдена | — Owner-пароль введён на странице одобрения. |
Тестовая задача выполнена | — ChatGPT открывает проект, читает файлы, запускает команду (например, git status) без ошибок. |
devspace doctor проходит без ошибок | — окружение проверено. |
Ссылки
- Репозиторий: github.com/Waishnav/devspace
- Сайт: npmjs.com/package/@waishnav/devspace
- Стандарт: modelcontextprotocol.io
- Документация: github.com/Waishnav/devspace/tree/main/docs
