EasyGerber: проектирование печатных плат с помощью AI, разводка и трассировка

Этот пакет подключает агентные инструменты для программирования к размещённым на серверах EasyGerber инструментам проектирования плат. В открытые файлы пакета входят инструкции по рабочим процессам, метаданные подключений, значки и небольшой установщик. Размещение компонентов, трассировка и оценка выполняются на серверах EasyGerber.

Версия этого пакета и инструкции для плагинов — 0.3.4. В неё добавлены рекомендации по использованию submit_feedback для отправки одобренных пользователем сообщений об ошибках, запросов на новые функции и отзывов в закрытый почтовый ящик администратора EasyGerber. Для отправки сообщения не нужны учётная запись или новая плата. При создании платы, если статус учётной записи неизвестен, сначала запускается гостевая сессия — без предварительной проверки инструментов, доступных только владельцам учётных записей, таких как get_profile. Используются существующие гостевые сессии и авторизованные учётные записи. Также добавлены отдельные инструкции по удалению плат учётной записи с соответствующей авторизацией. Размещённые инструменты обнаруживаются динамически, если подключённый сервис их предоставляет. Эти инструкции не расширяют существующие разрешения OAuth и набор областей доступа, используемый установщиком по умолчанию.

Исходный код доступен в открытом репозитории интеграции. Установщик npm и пакеты плагинов для платформ проходят отдельные процедуры проверки клиентов, но используют общие сценарий работы EasyGerber и размещённый сервис.

Начало работы без регистрации

Для гостевого доступа в первую очередь используйте https://www.easygerber.com/api/mcp. Для подключения, инициализации и обнаружения инструментов не нужны учётная запись EasyGerber, разрешение OAuth или API key. Агент запускает закрытую сессию с помощью start_guest_session, а затем использует полученный guestToken для поиска в каталоге и работы с единственной платой в этой сессии, включая размещение компонентов, проверки, предварительный просмотр и экспорт. Не передавайте токен и закрытую ссылку для просмотра другим лицам.

URL подключения	Когда использовать	Вход в учётную запись
https://www.easygerber.com/api/mcp	Для обычных подключений MCP и просмотра каталога с гостевым доступом по умолчанию	Гостям не требуется; необходим для работы с платами учётной записи, доступа к организации и сохранения гостевой платы в учётной записи
https://www.easygerber.com/api/mcp/account	Для работы с сохранёнными платами учётной записи в клиентах, которые запрашивают OAuth только при настройке	Требуется до инициализации или обнаружения инструментов; это подключение не поддерживает гостевой режим

Установщик Codex, пакеты OpenAI и пакет Claude используют общий URL. Коннектор Grok для учётной записи, а также встроенные конфигурации Cursor и Antigravity, описанные ниже, используют URL только для учётной записи. Для нового гостевого подключения не указывайте данные авторизации. Если существующие учётные данные отклонены, пройдите авторизацию заново: подключение не переключится автоматически в гостевой режим. Информацию об ограничениях сессий и сохранении гостевой платы см. в разделе Попробуйте до регистрации.

Grok

Подключите учётную запись EasyGerber один раз, чтобы открывать и редактировать сохранённые платы в потребительской версии Grok:

• В Grok откройте Plugins → New Connector → Custom.

• Назовите коннектор EasyGerber и укажите https://www.easygerber.com/api/mcp/account в качестве URL сервера.

• Войдите в EasyGerber и выберите Allow access. Затем попросите Grok открыть сохранённую плату по её URL EasyGerber и внести нужные изменения.

Например: «Открой эту сохранённую плату EasyGerber: [URL вашей платы]. Переименуй её в LED indicator и снова прочитай название, чтобы подтвердить сохранение изменений».

Для этого подключения необходимо пройти авторизацию при настройке. Оно использует существующие инструменты EasyGerber и разрешения учётной записи. При новом подключении к учётной записи пройдите обычную процедуру входа. Существующие опубликованные конфигурации пакета продолжают использовать /api/mcp, который поддерживает гостевой доступ и дополнительную авторизацию учётной записи.

16 октября 2026 года потребительская версия Grok прошла проверку согласия, прочитала существующую закрытую сохранённую плату, временно изменила её название и восстановила исходное. Оба изменения были подтверждены после повторного открытия платы на сайте EasyGerber. Grok Bot не тестировался. Отображение 3D-модели в браузере не проверялось, поскольку в тестовом браузере был недоступен WebGL. Эта проверка потребительской версии не подтверждает работу интерактивного OAuth или управляемого моделью процесса проектирования плат в Grok Build.

Cursor

В открытый репозиторий включён встроенный манифест .cursor-plugin/plugin.json. Он использует общий сценарий работы EasyGerber и графические материалы, а также подключается к https://www.easygerber.com/api/mcp/account. Для этого подключения нужно авторизовать учётную запись, прежде чем станут доступны инструменты. Пройдите вход в EasyGerber и выберите Allow access в процессе подключения Cursor. По-прежнему действуют разрешения учётной записи, ограничения тарифного плана и тарификация генерации.

Чтобы загрузить локальную копию открытого репозитория с помощью официального CLI Cursor:

agent --plugin-dir .

Введите /mcp, выберите Easygerber (plugin), затем Manage Server → Login, чтобы пройти процедуру подтверждения в браузере. После этого попросите: «Открой эту сохранённую плату EasyGerber: [URL вашей платы]. Прочитай её текущее название и компоненты». Cursor управляет учётными данными учётной записи. Установщик npm не требуется: он настраивает только Codex. Корневые конфигурации подключений OpenAI и Claude сохраняют возможность гостевого доступа через /api/mcp. Публикация в Marketplace зависит от проверки Cursor.

Antigravity

Проектируйте и размещайте компоненты на печатных платах в Antigravity с помощью опубликованных компонентов, автоматического размещения и трассировки, редактирования схем и экспорта производственных файлов. В открытый репозиторий включены встроенные метаданные Antigravity и общий сценарий работы EasyGerber. Подключение MCP использует https://www.easygerber.com/api/mcp/account; по-прежнему действуют разрешения учётной записи, ограничения тарифного плана и тарификация генерации.

Установите плагин из открытого репозитория с помощью актуальной версии CLI Antigravity и запустите сессию:

agy plugin install https://github.com/EasyGerber/easygerber-agent-plugin
agy

Введите /mcp, чтобы проверить подключение EasyGerber. Когда Antigravity запросит авторизацию учётной записи, войдите в EasyGerber и выберите Allow access. Затем попросите: «Открой эту сохранённую плату EasyGerber: [URL вашей платы]. Прочитай её текущее название и компоненты». Antigravity управляет учётными данными учётной записи. Установщик npm не требуется. Публикация в Marketplace зависит от проверки Antigravity.

См. официальные руководства: руководство по плагинам и руководство по MCP.

Cline

Cline может подключаться напрямую к размещённой конечной точке MCP EasyGerber по протоколу Streamable HTTP. Для работы нужна установленная версия Cline с настроенной моделью. Установщик настройки npm из этого репозитория конфигурирует только Codex и не используется для установки Cline. Для нового гостевого подключения локальный сервер EasyGerber, сборка и API key не нужны.

В панели IDE Cline откройте MCP Servers → Remote Servers, укажите EasyGerber в качестве имени сервера и https://www.easygerber.com/api/mcp в качестве URL сервера, выберите Streamable HTTP и нажмите Add Server. Для гостевого доступа оставьте поле авторизации пустым.

Или откройте MCP Servers → Configure → Configure MCP Servers и добавьте эту запись в существующий объект mcpServers, сохранив остальные серверы и настройки:

{
  "mcpServers": {
    "easygerber": {
      "type": "streamableHttp",
      "url": "https://www.easygerber.com/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Указывать тип streamableHttp важно: если его не указать, Cline выберет устаревший протокол SSE. Не отключайте подтверждение вызова инструментов. Если запись easygerber уже существует, проверьте её, а не заменяйте и не создавайте дубликат.

В актуальном CLI Cline эквивалентная команда настройки выглядит так:

cline mcp add easygerber https://www.easygerber.com/api/mcp --transport http --yes

Эта команда сохраняет подключение, но сама по себе не подтверждает, что настройка прошла успешно. В Cline проверьте, что подключение установлено и появились инструменты EasyGerber, например search_parts, get_part и start_guest_session. Если нужно только проверить установку, остановитесь после обнаружения инструментов: не запускайте гостевую сессию, не создавайте и не изменяйте плату, не генерируйте разводку, не экспортируйте файлы и не отправляйте отзывы.

Для дальнейшей работы с платой по запросу пользователя гостевой доступ позволяет работать с одной платой в каждой сессии до регистрации. Для работы с сохранёнными платами учётной записи требуется согласие OAuth EasyGerber. Для клиентов, которым нужна авторизация при настройке подключения, можно использовать отдельную запись https://www.easygerber.com/api/mcp/account, описанную выше. Авторизация учётной записи и рабочие процессы с платами требуют отдельной проверки в Cline; проверка гостевого подключения их не подтверждает.

Эти инструкции составлены на основе официального руководства Cline по MCP. 18 октября 2026 года CLI Cline 3.0.73 прочитал предложенный README и добавил встроенную конфигурацию подключения в пустой изолированный профиль с включённым подтверждением вызова инструментов. При отдельной проверке с установленным @cline/core 0.0.95 удалось подключиться и обнаружить 17 инструментов EasyGerber без авторизации. Сам агент обнаружение инструментов не проверял. Инструменты EasyGerber не вызывались; OAuth и операции с платами не тестировались.

Kiro

Установите папку power Kiro через Powers → Add Custom Power или из локальной копии этого публичного репозитория выполните kiro-cli --v3 powers install ./kiro, а затем запустите kiro-cli --v3. Установщик npm не требуется. Power использует доступную гостям точку входа /api/mcp и содержит полный сценарий работы с EasyGerber в своём навыке.

18 октября 2026 года Kiro CLI 2.32.0 V3 импортировал и явно активировал power, загрузил навык целиком и обнаружил 17 размещённых инструментов без аутентификации EasyGerber. Встроенный гостевой сценарий позволил выбрать опубликованные компоненты, создать и отредактировать плату, выполнить разводку, получить данные предварительного просмотра, проверить наличие препятствий и экспортировать производственные файлы и файлы EasyGerber. Отдельно настроенное подключение к /api/mcp/account завершило OAuth и успешно сохранило эту гостевую плату в личной учётной записи после возобновления того же диалога. При последующем чтении подтвердилась доступность платы в учётной записи и сохранённой разводки. В отдельной проверке в браузере отобразились 3D-модели компонентов сохранённой платы.

В этой версии CLI автоматическая OAuth-авторизация посреди сеанса не завершилась. Для работы с учётной записью и сохранения гостевой платы следуйте инструкциям по дополнительному подключению учётной записи и возобновлению сеанса в README Kiro. Завершите подтверждение в браузере, пока локальный обработчик обратного вызова Kiro активен. Более ранняя попытка подключения к конечной точке учётной записи завершилась по истечении примерно 60 секунд; это произошло отдельно от ошибки состояния авторизации power посреди сеанса. Обновление токена, удаление, отправка отзывов и активация только по ключевым словам в Kiro не проверялись. Подтверждение каталога не входит в число этих проверок.

Gemini CLI

Установите расширение EasyGerber в текущую версию Gemini CLI. Вход в Gemini и подключение к EasyGerber — отдельные процессы: для нового гостевого подключения EasyGerber не нужны учётная запись или API-ключ.

gemini extensions install https://github.com/EasyGerber/easygerber-agent-plugin
gemini extensions list
gemini skills list
gemini mcp list

Проверьте MCP-подключение расширения и подтвердите стандартный запрос на установку. Если Gemini уже запущен, после установки перезапустите сеанс. Убедитесь, что расширение easygerber и общий навык включены, а MCP-подключение EasyGerber доступно. Существующие пользовательские настройки или настройки рабочей области с таким же именем сервера или навыка могут иметь приоритет над расширением. Проверьте их, если отображаемое подключение или навык получены из другого источника.

Расширение подключается к https://www.easygerber.com/api/mcp по Streamable HTTP и загружает существующий сценарий работы skills/easygerber. В его состав не входят локальный сервер или механизм EasyGerber. Не отключайте стандартные запросы Gemini на подтверждение использования инструментов. Попробуйте запрос: «Используй EasyGerber, чтобы создать плату по назначениям выводов в этой прошивке». Агент выбирает опубликованные компоненты и использует описанный выше гостевой сценарий.

Проверено в Gemini CLI 0.65.0: установка расширения, обнаружение общего навыка и активное MCP-подключение. В отдельной проверке с помощью MCP-транспорта этой установленной версии CLI были обнаружены 17 инструментов, создан гостевой сеанс, выполнен поиск опубликованных компонентов и получены сведения о компоненте. В рамках этой проверки не проверялись интерактивный сеанс модели, создание платы, разводка, экспорт или авторизация учётной записи.

Для работы с платами, сохранёнными в учётной записи, или переноса существующей гостевой платы в учётную запись Gemini документирует интерактивную команду /mcp auth easygerber. Подтвердите подключение EasyGerber, а затем возобновите исходную задачу и, если применимо, перенесите гостевую плату в учётную запись. Обнаружение гостевого подключения не подтверждает работу OAuth для учётной записи, обновление токена или автоматическую авторизацию во время вызова инструмента. См. документацию Gemini по авторизации MCP.

Расширение распространяется через этот репозиторий и отдельный архив релиза Gemini. Чтобы обновить установленную версию, выполните gemini extensions update easygerber. Тема репозитория gemini-cli-extension позволяет галерее ежедневно находить расширения; индексация в галерее — отдельный процесс, она не означает одобрения со стороны Google или распространения в пользовательском приложении Gemini.

Devin

В публичный экспорт исходного кода входит .devin-plugin/plugin.json. Он подключается к доступной гостям конечной точке https://www.easygerber.com/api/mcp и загружает существующий сценарий работы skills/easygerber и связанные с ним материалы. Вход в Devin и авторизация EasyGerber — отдельные процессы. Для нового гостевого подключения EasyGerber не нужны учётная запись или API-ключ.

Для локальной проверки используйте копию экспортированного публичного репозитория интеграции и выполните команды в CLI Devin, войдя в свою учётную запись:

devin plugins install --local .
devin

После установки начните новый сеанс и выполните /easygerber:easygerber, чтобы загрузить сценарий. Не отключайте стандартные запросы на подтверждение использования инструментов. Для минимальной проверки подключения запросите: «Используй EasyGerber как гость, найди опубликованный двухконтактный разъём и проверь контакты в каталоге. Не создавай плату». Агент запускает один гостевой сеанс и использует инструменты каталога; гостевой токен и приватную ссылку для просмотра необходимо хранить в тайне.

20 октября 2026 года Devin CLI 3000.11.92 установил созданный локальный пакет и обнаружил общий навык и конфигурацию размещённого MCP. В новом встроенном сеансе с доступной в тарифе Free моделью SWE-1.6 Slow был создан один гостевой сеанс, выполнен поиск опубликованных разъёмов и получен компонент для проверки его двух контактов в каталоге. Создание платы, разводка, экспорт и авторизация в учётной записи EasyGerber не проверялись. Более ранняя попытка с SWE-2 потребовала тариф Pro и завершилась до вызова инструмента; платный тариф не приобретался. Проверка и публикация в Marketplace не входят в эти встроенные проверки.

Для OAuth-подключений плагинов Devin документирует команду devin mcp login easygerber. Доступ к учётной записи, продолжение работы с гостевой платы в учётной записи и сценарии работы с платами требуют отдельной встроенной проверки; установка плагина или просмотр списка инструментов не подтверждают их работоспособность. Отправка в Marketplace и публикация в нём не входят в проверки релиза общего пакета. См. официальное руководство по плагинам Devin.

Codex в VS Code или терминале

Требуются Node.js версии 22 или выше и Codex. Чтобы установить версию 0.3.4:

npx @easygerber/agent-plugin@0.3.4 setup --dry-run
npx @easygerber/agent-plugin@0.3.4 setup
npx @easygerber/agent-plugin@0.3.4 doctor

Установщик размещает навык в ~/.agents/skills/easygerber и добавляет небольшую управляемую таблицу MCP в $CODEX_HOME/config.toml (по умолчанию — ~/.codex/config.toml). Существующий текст TOML и другие серверы сохраняются. Квитанция об установке хранится в ~/.easygerber/agent-plugin/codex-install.json. Файлы проекта и прошивка не изменяются. Codex — целевой клиент по умолчанию и единственный поддерживаемый установщиком; параметр --client codex позволяет указать его явно. Все команды можно запускать без участия пользователя; в сценариях также поддерживается параметр --yes.

После установки перезапустите чат Codex или IDE и запросите: «Создай небольшую плату для светодиода на 3,3 В, покажи предварительный просмотр и экспортируй производственные файлы и файл EasyGerber». Агент использует подключённую учётную запись или автоматически запускает создание гостевой платы через https://www.easygerber.com/api/mcp.

Чтобы работать с платами, сохранёнными в учётной записи, или с платами организации, подключите EasyGerber в настройках MCP. Если установлен Codex CLI, выполните:

codex mcp login easygerber

Клиент открывает процесс авторизации учётной записи и сохраняет учётные данные. В управляемой конфигурации MCP запрашиваются права boards:read, boards:write, boards:generate, boards:export и offline_access. Согласие на их предоставление охватывает обычные операции с платами и продление доступа, но не удаление. Для удаления требуется отдельное явное согласие на право boards:delete; уже предоставленного права boards:write недостаточно. Доступ к учётной записи также зависит от разрешений организации, ограничений учётной записи и согласия пользователя. Установщик не запрашивает, не читает и не сохраняет токены доступа или гостевые данные доступа. Команда doctor проверяет локальную конфигурацию и целостность навыка, но не подтверждает работу аутентификации, гостевого режима или действующей службы.

Попробуйте запрос: «Используй EasyGerber, чтобы создать плату по назначениям выводов в этой прошивке». Агент изучает соответствующий локальный код, выбирает опубликованные компоненты и передаёт требования к плате через службу MCP. Стандартный набор прав для учётной записи: boards:read, boards:write, boards:generate и boards:export; также применяются разрешения организации, квоты и условия тарификации.

Попробуйте до регистрации

Гостевой доступ уже работает в производственном MCP-сервисе EasyGerber и использует опубликованный каталог компонентов. До регистрации агент может создать одну плату на сессию и неограниченно редактировать её, менять компоновку, выполнять проверки и предварительный просмотр, а также экспортировать файлы для производства в ZIP или .egb. У платы и сессии нет автоматического срока действия. При этом продолжают действовать обычные ограничения на частоту запросов, сложность платы и использование общих вычислительных ресурсов. Сервис возвращает limits: { boards: 1 }; expiresAt: null означает, что плановый срок действия не установлен. Лимит плат относится к сессии, а не к подтверждённому пользователю.

Агент хранит данные для гостевого доступа в контексте своих инструментов. Сохраните приватную ссылку для просмотра, чтобы вернуться к плате: получить доступ к гостевому проекту может любой, у кого есть эта ссылка. Не помещайте токен в открытом виде и эту ссылку в репозитории firmware, публичные обращения и диагностические журналы. При просмотре токен удаляется из фрагмента URL, а браузер открывает приватную сессию. Гостевой доступ зависит от сохранности этих данных или ссылки: создать новую сессию, чтобы восстановить утраченное, нельзя. Ссылки для скачивания действуют пятнадцать минут, а экспортированные объекты могут быть удалены через двадцать четыре часа после создания. Эти ограничения относятся к файлам и не прекращают действие гостевой платы.

Чтобы закрепить плату за учётной записью, иметь возможность восстановить к ней доступ через аккаунт и создавать дополнительные платы в рамках обычного тарифа, войдите в аккаунт или создайте его в приватном окне просмотра. После перехода к авторизации окно просмотра автоматически сохранит плату в вашей учётной записи. Если открыть гостевой проект в браузере, где уже выполнен вход, плата останется гостевой. Если во время задачи агента с гостевой платой вы выбираете вход или работу с платой учётной записи, агент также сохраняет эту плату без отдельного подтверждения Keep board. Исключение — вход только для удаления платы учётной записи или отправки отзыва: в этом случае агент запускает авторизацию с помощью claim_guest_board, передав исходный гостевой токен, а после стандартного подтверждения доступа в аккаунт повторяет запрос на закрепление платы. У обычной команды Authenticate в нативных настройках нет контекста гостевой платы, поэтому после входа агент должен продолжить её закрепление. Сам по себе переход по ссылке обратного вызова плату не сохраняет.

После успешного закрепления возвращается новый ID платы учётной записи, а гостевой доступ прекращается. Перед дальнейшими изменениями агент считывает эту плату из аккаунта. Если компоновка ещё выполняется, он ожидает и автоматически повторяет запрос, не отменяя задачу. Если закрепление завершилось ошибкой или ответ не был получен, агент сохраняет исходный токен для безопасного повтора. Используйте исходную гостевую сессию и не создавайте дополнительные сессии для обхода лимита плат или защитных механизмов сервиса. Если подключение учётной записи истекло, требуется повторная авторизация; оно не становится гостевым автоматически.

Удаление платы учётной записи

Явно попросите удалить конкретную плату учётной записи. Агент считывает её текущую ревизию и вызывает delete_board только по такой просьбе. Удаление необратимо, восстановить плату нельзя, а активные задачи для неё отменяются. Создание, редактирование или экспорт платы не дают разрешения на её удаление или очистку.

Для удаления требуется отдельное согласие OAuth на boards:delete, а также право владения личной учётной записью либо роль владельца/администратора организации. Установщик и стандартные конфигурации клиентов не запрашивают эту область доступа; клиент должен поддерживать получение дополнительного разрешения. Имеющееся разрешение boards:write не позволяет удалять платы. Если регистрация клиента ограничена областями, запрошенными ранее, её необходимо намеренно обновить или заменить через стандартную процедуру повторного подключения или регистрации клиента, прежде чем запрашивать согласие на удаление. Существующие регистрации и разрешения не получают доступ к удалению автоматически. Этим инструментом нельзя удалять гостевые платы, и агент не должен закреплять такую плату за аккаунтом только ради её удаления. Вход исключительно для удаления платы учётной записи не разрешает закреплять за аккаунтом другую гостевую плату.

Для подключения easygerber в установщике Codex, у которого не настроен OAuth client ID, явно включите удаление с помощью следующих команд. Работа команд проверена с Codex CLI 0.163.0-alpha.10.2:

codex mcp logout easygerber
codex mcp login easygerber \
  --scopes boards:read,boards:write,boards:generate,boards:export,boards:delete,offline_access \
  --oauth-client-registration dcr

Команда выхода удаляет локально кэшированные client ID и токены. При входе создаётся новая динамическая регистрация клиента с указанными областями доступа и открывается браузер для получения нового согласия, включая разрешение на удаление. Эти флаги действуют только для этого входа и не меняют области доступа установщика, заданные в config.toml. Выход не отзывает регистрацию клиента или разрешение на стороне сервера. Подробнее см. в исходном коде Codex CLI, отвечающем за выбор областей доступа и выход.

Если для подключения задан OAuth client ID, динамическая регистрация не используется, даже с этим флагом. Прежде чем клиент сможет получить новое согласие, регистрация у поставщика должна разрешать область boards:delete. Приведённые выше команды не являются универсальным решением для нативных плагинов и других клиентов. Подробнее см. в разделе Регистрация OAuth-клиента Codex. После авторизации агент повторно считывает указанную плату учётной записи и удаляет её только по явной просьбе пользователя.

Удаление подтверждает только успешный ответ { boardId, deleted: true }. При наличии необходимой области OAuth недоступные платы, недостаточные права владения и повторные запросы на удаление уже отсутствующей платы возвращают not_found. Этот результат не доказывает, что удаление состоялось. Если ответ не получен, агент сообщает о неопределённости и не считает последующее отсутствие платы подтверждением удаления.

Отправка отзыва

Попросите агента отправить EasyGerber сообщение об ошибке, предложение по улучшению или общий отзыв. Агент вызывает submit_feedback только по вашей просьбе или с вашего согласия. Перед отправкой он очищает текст от пробелов по краям и проверяет, что его длина составляет от 10 до 2000 символов, после чего отправляет краткое сообщение в закрытый почтовый ящик администраторов. Переписка, исходные диагностические данные, экспорты плат, учётные данные и приватные ссылки автоматически не отправляются. После успешной отправки возвращаются идентификатор квитанции и временная метка; это не гарантирует ответа или обязательств по включению предложения в план развития.

Подключение к /api/mcp принимает анонимные отзывы: для этого не нужно входить в аккаунт, создавать гостевую сессию или плату. К отзыву можно привязать уже подключённую учётную запись или действующую гостевую сессию. Дополнительная область доступа для работы с платами не нужна, а стандартные области доступа установщика не меняются. Если имеющиеся учётные данные недействительны, доступ будет отклонён — подключение не станет анонимным автоматически. Вход исключительно для отправки отзыва не разрешает закреплять за аккаунтом гостевую плату. Для подключения только через учётную запись при настройке по-прежнему требуется вход.

При повторной отправке отзыва, результат которой неизвестен, агент использует тот же UUID requestId, а также идентичный текст сообщения и те же данные атрибуции. Если инструмент, подключение или сервис недоступны, воспользуйтесь разделом GitHub Issues. Обращения в GitHub Issues публичны, а для их создания нужна учётная запись GitHub. Перед публикацией проверьте и отредактируйте сообщение. Не включайте в него учётные данные, приватные ссылки или конфиденциальные данные платы.

ChatGPT и нативные плагины Codex

Корневой манифест для переносимой версии и mcp.json предназначены для проверки в каталоге плагинов OpenAI. В них заявлена смешанная модель публичного доступа и доступа через OAuth: гости могут находить инструменты без авторизации в учётной записи, а операции с аккаунтом используют зарегистрированный публичный OAuth client с PKCE и стандартным подтверждением доступа. Его client ID — публичные метаданные, а не учётные данные. Это не меняет автоматическую регистрацию Codex установщиком npm. В каждом клиенте отдельно необходимо проверить обнаружение инструментов гостями и возможность дополнительной авторизации в аккаунте; успешная проверка пакета не означает одобрения для каталога или принятия нативным клиентом. В пакете для нативного Codex используются отдельные совместимые манифест и MCP-файл с автоматическим обнаружением OAuth; client ID, предназначенный только для каталога, в них не копируется. Используйте этот нативный пакет в поддерживаемом настольном клиенте, а для Codex в терминале и IDE — отдельную установку, описанную выше. ZIP-архив для переносимой версии из каталога нельзя использовать вместо нативного ZIP-архива. Не устанавливайте несколько копий интеграции в один клиент.

Чтобы работать с сохранёнными платами учётной записи в пользовательских коннекторах, запрашивающих авторизацию аккаунта только при настройке, используйте https://www.easygerber.com/api/mcp/account и выполните вход с подтверждением доступа при подключении. Для этой точки подключения OAuth обязателен до инициализации; она использует те же инструменты, разрешения и сервисы для работы с платами. Для доступа, изначально рассчитанного на гостей, используйте https://www.easygerber.com/api/mcp: авторизация в учётной записи для этого подключения необязательна.

Для этих двух точек подключения предусмотрены разные OAuth-ресурсы. При выборе точки для учётной записи установите новое подключение: существующие регистрации клиентов и токены остаются привязаны к исходному ресурсу. Не переносите токены между точками подключения. В опубликованных манифестах пакетов URL подключения остаются без изменений.

Claude

Пакет Claude подготовлен в папке claude публичного репозитория. В него входят .claude-plugin/plugin.json и .mcp.json. Пакет использует те же навык EasyGerber, графические материалы и размещённый сервис, что и пакеты OpenAI. Установщик npm по-прежнему предназначен только для Codex. Чтобы проверить пакет и загрузить его локально с помощью Claude Code версии 2.1.281 или новее, перейдите к клону публичного репозитория и выполните:

claude plugin validate ./claude --strict
claude --plugin-dir ./claude

Используйте /mcp в Claude Code, чтобы проверить подключение EasyGerber и при необходимости предоставить доступ к учётной записи. В Claude chat и Cowork добавьте EasyGerber или подключите его через вкладку Connectors плагина. EasyGerber одобрен и опубликован в каталоге Claude; гостевой доступ предоставляется через /api/mcp.

Обновление и удаление

Выполните npx @easygerber/agent-plugin@0.3.4 setup, затем перезапустите чат или IDE Codex, чтобы загрузить актуальные инструкции по гостевому доступу, сохранению учётной записи, удалению и отправке отзывов. При обновлении с версии 0.2.x устаревшее имя score_board также заменяется на check_board_layout; псевдоним для обратной совместимости не предоставляется.

Чтобы обновить управляемые файлы, которые не менялись, запустите setup из новой версии пакета. Повторный запуск той же процедуры ничего не меняет. Если обнаружена конфликтующая запись MCP или изменённый файл навыка, установка остановится, не заменяя этот файл. Оставьте его на месте или самостоятельно переместите в другое место перед повторной попыткой. Символические ссылки на управляемые файлы не принимаются, чтобы избежать изменений в неожиданных расположениях.

npx @easygerber/agent-plugin@0.3.4 uninstall --dry-run
npx @easygerber/agent-plugin@0.3.4 uninstall

При удалении стираются только неизменённые файлы и неизменённое управляемое подключение; остальные настройки и изменённые файлы сохраняются. Утилита выводит список сохранённых путей и оставляет запись об их принадлежности. Отзовите подключение учётной записи отдельно в Codex или EasyGerber: удаление локальных файлов не отзывает разрешения OAuth и не делает недействительной существующую ссылку гостевого доступа. Гостевой доступ прекращается после привязки к учётной записи или отзыва, а не по таймеру. Устаревшие гостевые данные можно удалять через 24 часа после привязки или отзыва; копия, привязанная к учётной записи, остаётся доступной. Если установка была прервана, её можно продолжить по сохранённой записи. Если осталась устаревшая блокировка установщика, сначала убедитесь, что ни один процесс установки не запущен, и только после этого удалите путь блокировки, указанный в CLI.

Сеть и данные

Интеграция напрямую подключается к https://www.easygerber.com/api/mcp, а для встроенных конфигураций Cursor и Antigravity и коннектора учётной записи Grok для потребителей — к /api/mcp/account. Авторизация выполняется с использованием метаданных и сценария работы с учётной записью, объявленных для выбранного подключения. В запросы к инструментам могут включаться требования к плате, выбранные компоненты, изменения схемы, идентификаторы платы или организации, а также сообщения с отзывами, которые вы одобрили для своей задачи. Ссылки на созданные материалы возвращает EasyGerber. Размещённый сервис хранит аналитику активности агента в течение одного года, включая историю гостевого доступа после привязки платы к учётной записи. Установщик не загружает репозитории, не проверяет файлы окружения, не запускает сценарии жизненного цикла и не собирает телеметрию. Загрузка обычного пакета npm выполняется средствами npm.

См. документацию по интеграции и поддержке, политику конфиденциальности и условия использования.

Проверка сопровождающим и выпуск

В публичном репозитории ветка по умолчанию — main. Квадратный логотип Grok для marketplace экспортируется только в репозиторий, отдельно от пакетов npm и плагина. Архивный тег codex/grok-submission-assets сохраняет исходный URL изображения.

Файл server.json в репозитории объявляет выпуск 0.1.1 для записи в MCP Registry io.github.EasyGerber/easygerber. В ней используется общий URL https://www.easygerber.com/api/mcp для обнаружения сервиса гостями и необязательной авторизации аккаунта. Каталоги, импортирующие метаданные Registry, должны использовать этот URL для доступа без предварительной авторизации. Конфигурации клиентов, требующие аккаунт, доступны отдельно, как описано выше. Манифест экспортируется только в публичный репозиторий; пакеты npm и плагина не содержат локального MCP-сервера или закрытых движков. Версия Registry 0.1.1 отслеживает метаданные размещённого сервиса независимо от версий npm и плагина 0.3.4.

Стандартные сценарии сохранения и выпуска продукта не публикуют пакеты npm, публичный репозиторий интеграции или записи в MCP Registry. Команда npm run release:agent-plugin -- --output в закрытой рабочей копии подготавливает очищенные артефакты; команда npm run check:agent-release -- --release-dir проверяет их. В существующий публичный репозиторий публикуйте только файлы из public-source, сохраняя проверенные конфигурации клиентов. Проверьте public-source/server.json командой mcp-publisher validate, затем опубликуйте его командой mcp-publisher publish с существующей идентификацией Registry и проверьте последние метаданные. Версии Registry неизменяемы, поэтому при изменении метаданных Registry необходимо создать новую версию отдельно от выпусков пакета npm.

Для версии npm 0.3.4 выполните команду npm pack --ignore-scripts --pack-destination .. из каталога /public-source. В закрытой рабочей копии проверьте полученный архив командой npm run check:agent-release -- --release-dir --npm-tarball /easygerber-agent-plugin-0.3.4.tgz. Опубликуйте именно этот проверенный архив командой npm publish /easygerber-agent-plugin-0.3.4.tgz --access public.

Пакет содержит среду выполнения установщика, метаданные подключения, навыки и ресурсы. В публичном репозитории также находятся рабочий процесс GitHub Actions и тест установщика. При отправке изменений и создании pull request рабочий процесс проверяет собранный установщик в Linux, Windows и macOS с Node.js 22 и 24. Тесты используют временные профили пользователей и не подключаются к EasyGerber и не используют учётные данные аккаунта. Эти проверки охватывают процесс установки, но не подтверждают работу аутентификации или операций с платами в конкретном клиенте-агенте. Фактический статус запусков смотрите в результатах Actions.

Рабочий сервис поддерживает гостевое создание, компоновку, предварительный просмотр, проверку блокирующих проблем, оба варианта экспорта и сохранение в аккаунте. Проверьте эти операции и продолжение работы после входа, используя именно тот пакет и клиент, которые выпускаются. Проверки более ранних версий сервиса или пакета не подтверждают совместимость нового артефакта клиента.

Рабочий процесс и тест установщика не входят в пакет npm и ZIP-архивы плагинов. Расширенный набор регрессионных тестов и инструменты выпуска остаются в закрытой среде разработки EasyGerber. Эти инструменты создают ZIP-архивы OpenAI и Claude, а также публичный исходный код на основе явных списков разрешённых файлов и проверяют содержимое полученных архивов. Публичный исходный код включает сгенерированный каталог claude: отправляйте этот путь плагина в существующий репозиторий. Для Claude нужен отдельный каталог, поскольку корневой установщик npm содержит каталог bin/, который Claude chat и Cowork установить не могут. Общие навыки и графические материалы копируются из канонических источников при выпуске; сопровождающим не нужно редактировать вторую копию. Экспортируемая среда выполнения установщика использует только встроенные модули Node.js и публичный парсер smol-toml; она не импортирует закрытые пакеты EasyGerber. Пакет Claude содержит только документацию, графические материалы и метаданные удалённого подключения.

При том же выпуске из общих метаданных также создаётся корневой файл .cursor-plugin/plugin.json. Его встроенная конфигурация MCP выбирает запись для аккаунта, не меняя корневые настройки аутентификации OpenAI. Cursor использует существующие корневые навык и ресурсы; отдельную копию поддерживать не нужно. Манифест Cursor включается только в публичный репозиторий и не входит в пакет npm и ZIP-архивы OpenAI и Claude. Для проверки Cursor укажите URL публичного репозитория.

Antigravity использует сгенерированный файл .antigravity-plugin/plugin.json и корневой файл mcp_config.json, а также тот же корневой навык и графические материалы. Эти два файла включаются только в публичный репозиторий и не входят в пакет npm и ZIP-архивы OpenAI и Claude. Корневой манифест OpenAI и конфигурации остальных клиентов остаются без изменений.

Kiro использует сгенерированный каталог kiro из восьми файлов со стандартными манифестами Agent Plugins и адресом, поддерживающим гостевой доступ. Навык содержит полный канонический сценарий работы, поскольку в проверенной нативной сессии ссылки на сценарий относительно текущего каталога не разрешались. Отдельный справочный материал остаётся без изменений. Каталог Kiro включается только в репозиторий и не добавляет файлов в пакет npm или ZIP-архивы OpenAI и Claude; для проверки Kiro укажите URL этого каталога в публичном репозитории.

Gemini CLI использует сгенерированный корневой файл gemini-extension.json и тот же корневой навык. В конфигурации Streamable HTTP применяется httpUrl, а авторизация остаётся необязательной, чтобы был доступен гостевой режим. При выпуске также создаётся архив easygerber-gemini-extension-0.3.4.zip, содержащий манифест, общий навык и ссылку на сценарий работы, графические материалы, README и лицензию. Манифест и архив Gemini не входят в пакет npm и пакеты других клиентов. Опубликуйте этот проверенный архив как единственный устанавливаемый артефакт соответствующего выпуска GitHub: при установке по URL репозитория Gemini предпочитает последний выпуск. Сохраняйте предыдущие выпуски, включая видео для проверки, и следите за тем, чтобы в последнем выпуске оставался действительный архив расширения. Для распространения Gemini публикация в npm не требуется.

Devin использует сгенерированный корневой файл .devin-plugin/plugin.json, общий корневой навык и assets/logo.svg. Его встроенная конфигурация MCP выбирает общий адрес с поддержкой гостевого доступа; нативные манифесты Devin не считывают автоматически переносимый корневой файл mcp.json. Эти метаданные, предназначенные только для репозитория, не добавляют файлов в пакет npm или архивы других клиентов. В записях marketplace указывайте существующий публичный репозиторий и проверенный полный SHA коммита. Перед отправкой ознакомьтесь с требованиями marketplace к нативной установке и фактическому вызову инструмента. При публикации метаданных только для репозитория сохраняйте опубликованный выпуск Gemini и его артефакт.

Перед публикацией подтвердите владение npm scope, официальным публичным репозиторием интеграции и учётными записями издателей у поставщиков. Проверьте вход в производственную систему и полный сценарий создания, изменения, генерации и экспорта в поддерживаемых клиентах. Изучите результат команды npm pack --dry-run --json, выполненной для публичного экспорта. Публикуйте только очищенный пакет или репозиторий; монорепозиторий продукта и его история должны оставаться закрытыми. Иконки и текст описания в этом пакете — редактируемые материалы выпуска, а не подтверждение одобрения со стороны marketplace. Не добавляйте хуки жизненного цикла установки npm.

Лицензия MIT распространяется на этот пакет интеграции, но не на размещённый сервис и закрытые движки.