JK

Локальный мост для программирования, который позволяет ChatGPT читать, изменять, тестировать проекты на моём ПК и даже выполнять Git-операции.

English | 한국어

JK — это неофициальный проект, не являющийся официальным продуктом OpenAI. Это форк, модифицированный на основе ezBuilder/chatgpt2codex; перед использованием ознакомьтесь с условиями лицензирования/распространения исходного кода в Attribution & Compliance.

Что нужно знать прежде всего

JK — это не второй ИИ.

나
→ ChatGPT
→ JK
→ 내 PC의 프로젝트 / 터미널 / Git / 테스트

ChatGPT принимает решения, а JK выполняет реальную работу на моём ПК.

Вместо прежнего выражения «ChatGPT-плагин» сейчас подключение выполняется одним из двух способов, приведённых ниже.

1. Рекомендуется для частных пользователей Plus: Custom GPT + Actions

2. Для поддерживаемых сред Business / Enterprise / Edu: ChatGPT Apps + MCP

В обоих случаях можно выполнить аутентификацию владельца с помощью Owner Token JK.

1. Установка

Предварительные требования

• Рекомендуется Windows 10/11

• Git

• Node.js 22 или новее

• npm

• Учётная запись ChatGPT

• Один личный домен (например, example.com — используется для создания HTTPS-адреса для доступа к JK из веб-версии ChatGPT)

Установка:

git clone https://github.com/Anjingyeong/jk-mcp.git
cd jk-mcp
npm ci
npm run build

Запуск

Windows:

npm run chatgpt:windows

macOS / Linux:

npm run chatgpt

Если первый запуск прошёл успешно, будет выведена примерно следующая информация:

JK is ready
MCP URL: http://127.0.0.1:7979/mcp
Dashboard: http://127.0.0.1:7979/

В браузере также можно открыть следующий адрес:

http://127.0.0.1:7979/

2. Сохранение Owner Token

При первом запуске JK автоматически создаёт Owner Token и показывает его в терминале только один раз.

chatgpt2codex init: generated a new HTTP owner token (shown once, never logged again)

Храните этот токен как пароль.

• Не публикуйте его на GitHub.

• Не показывайте его на скриншотах.

• Не делитесь им с другими.

• По возможности сохраните его в менеджере паролей.

Если вы потеряли токен, можно выпустить новый.

node dist/cli.js owner-token --generate

После создания нового токена существующие OAuth-подключения, возможно, потребуется авторизовать заново.

Это не тот способ, когда токен извлекается через GUI, как в старой персональной десктопной версии JK. В текущей публичной версии jk-mcp токен выдаётся CLI/лаунчером при первом запуске.

3. Подключение к ChatGPT

Важное условие: требуется HTTPS-адрес, доступный из интернета

В руководстве по установке для друзей и знакомых личный домен считается обязательным требованием. Например, если у вас есть example.com, используйте поддомен вроде jk.example.com для подключения JK. JK не покупает домены и не настраивает DNS/HTTPS автоматически.

Технически можно использовать и другой публичный HTTPS-hostname, которым вы управляете, но процедура развёртывания для друзей и знакомых в этом README описана исходя из предположения, что используется собственный домен.

По умолчанию JK запускается только на локальном адресе, указанном ниже.

http://127.0.0.1:7979

Веб-сервис ChatGPT не может напрямую подключиться к 127.0.0.1 пользователя, поэтому для реального подключения ChatGPT нужен адрес, например, как указано ниже.

https://내가-관리하는-주소.example.com

Публичная версия JK не создаёт автоматически туннели, DNS или облачные сервисы. HTTPS reverse proxy или tunnel необходимо подготовить отдельно.

Если внешний адрес подготовлен, при запуске JK укажите hostname.

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\start-chatgpt.ps1 `
  -Workspace "C:\workspace" `
  -PublicHostname "jk.example.com"

Тогда основные URL будут выглядеть так:

MCP:     https://jk.example.com/mcp
Actions: https://jk.example.com/actions/openapi.json

4-A. ChatGPT Plus: подключение через Custom GPT Actions

Для частных пользователей Plus этот способ самый простой.

1. В ChatGPT откройте Создать GPT.

2. В Actions нового GPT выберите Create new action.

3. В Schema загрузите OpenAPI по указанному ниже адресу.

https://jk.example.com/actions/openapi.json

4. В Authentication укажите способ API Key → Bearer.

5. В качестве значения API Key введите Owner Token, полученный при первом запуске JK.

6. В Preview протестируйте action_health или простой запрос списка проектов.

Сервер JK Actions принимает оба следующих типа аутентификации:

• использование Owner Token напрямую в качестве Bearer token

• использование JK OAuth access token

При установке для друзей и знакомых способ с Bearer Owner Token требует меньше всего настроек.

Промпт для проверки подключения

JK로 현재 등록된 프로젝트 목록 보여줘.

Или:

JK로 이 프로젝트 구조만 확인해줘. 파일은 수정하지 마.

При успешном подключении ChatGPT вызывает JK Action и получает информацию о локальных проектах.

4-B. Подключение через ChatGPT Apps / MCP

Этот способ доступен, если в аккаунте/рабочем пространстве ChatGPT поддерживаются custom MCP app и необходимые write action.

1. Включите Developer Mode в ChatGPT.

2. В Apps создайте custom app.

3. В MCP endpoint введите указанный ниже адрес.

https://jk.example.com/mcp

4. Выполните аутентификацию OAuth.

5. Когда откроется страница подтверждения JK, введите Owner Token.

6. После подтверждения выполните Scan/Connect инструментов JK.

На экране подтверждения OAuth в JK Owner Token проверяется локально по хэшу и не сохраняется в открытом виде.

Объём функций Apps/MCP в ChatGPT и поддержка тарифных планов могут меняться. Если функция не отображается в текущем UI продукта, сначала проверьте способ Custom GPT Actions.

5. Практическое использование

После подключения не нужно запоминать названия внутренних инструментов JK.

Просто опишите желаемый результат на естественном языке.

@JK 이 프로젝트 구조 설명해줘. 수정은 하지 마.

@JK 이 오류 원인 찾아서 수정하고 관련 테스트까지 돌려줘.

@JK 지금 diff 리뷰하고 문제 없으면 커밋해줘.

@JK e2e 테스트하고 화면 확인해줘.

Для длительных задач надёжнее указывать следующие четыре пункта вместе.

프로젝트 + 목표 + 제약 + 완료 조건

Например:

@JK paba 프로젝트에서 급여명세서 출력 오류를 고쳐줘.
기존 DB 구조는 가능한 건드리지 말고,
관련 테스트와 build가 통과하면 끝내줘.

6. Механизмы безопасности

JK — это не инструмент, который предоставляет ChatGPT неограниченный доступ ко всему ПК.

• Доступ в основном в пределах выбранного workspace/project

• При изменении существующих файлов возможна защита от конфликтов на основе хэша

• Сокрытие секретных значений

• Применение защитного шлюза к чувствительным shell/сетевым/разрушительным командам

• Для commit/push требуется явное намерение пользователя

• Сохранение рабочих сессий и последних результатов проверки

Тем не менее, любой, у кого есть Owner Token, может получить доступ к JK, поэтому токен обязательно нужно хранить в секрете.

7. Если возникли проблемы

JK не запускается

npm ci
npm run build
npm run chatgpt:windows

Если потерян Owner Token

node dist/cli.js owner-token --generate

ChatGPT не подключается к JK

Сначала проверьте локально.

http://127.0.0.1:7979/

Если локально всё открывается, но ChatGPT не подключается, скорее всего, нужно проверить внешний HTTPS endpoint / reverse proxy / tunnel.

Проверка схемы Actions

https://내주소/actions/openapi.json

MCP endpoint

https://내주소/mcp

Более подробная документация

• Руководство по установке

• Руководство по использованию

• Политика выполнения и прав доступа

• Локальные дополнительные настройки

• Attribution & Compliance

Attribution

JK — это независимый неофициальный форк, модифицированный на основе ezBuilder/chatgpt2codex.

OpenAI, ChatGPT, GPT и Codex являются товарными знаками соответствующих правообладателей. JK не является официальным продуктом, официальным плагином или официальным партнёрским проектом OpenAI.