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 проходит без ошибок

— окружение проверено.

Ссылки

Ссылки