devspace — это 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