JK

这是将 ChatGPT 连接到我的 PC，使其能够读取、修改、测试项目，甚至执行 Git 操作的本地编码桥。

英语 | 韩语

JK 不是 OpenAI 的官方产品，而是一个非官方项目。它是基于 ezBuilder/chatgpt2codex 修改的 fork，原始代码的许可/再分发条款请先查看 Attribution & Compliance。

首先要了解的事

JK 不是第二个 AI。

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

ChatGPT 负责判断，JK 在我的 PC 上执行实际操作。

而且，现在不再使用过去的说法 “ChatGPT 插件”，而是通过以下两种方式之一进行连接。

1. 推荐给个人 Plus 用户： Custom GPT + Actions

2. 受支持的 Business / Enterprise / Edu 环境： ChatGPT Apps + MCP

两者都可以使用 JK 的 Owner Token 进行所有者认证。

1. 安装

准备工作

• 推荐 Windows 10/11

• Git

• Node.js 22 或更高版本

• npm

• ChatGPT 账号

• 1 个个人域名（例如：example.com —— 用于在 ChatGPT 网页中创建访问 JK 的 HTTPS 地址）

安装：

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 连接可能需要重新认证。

这不是像旧版 JK 个人桌面版那样从 GUI 中取出令牌的方式。在当前公开版 jk-mcp 中，由首次运行的 CLI/launcher 签发令牌。

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. 在新 GPT 的 Actions 中选择 Create new action。

3. 在 Schema 中加载以下地址的 OpenAPI。

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

4. 将 Authentication 设置为 API Key → Bearer 方式。

5. 在 API Key 值中输入首次运行 JK 时获得的 Owner Token。

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. 启用 ChatGPT 的 Developer Mode。

2. 在 Apps 中创建 custom app。

3. 在 MCP endpoint 中输入以下地址。

https://jk.example.com/mcp

4. 进行 OAuth 认证。

5. 当 JK 批准页面打开时，输入 Owner Token。

6. 批准后，对 JK 工具执行 Scan/Connect。

在 JK 的 OAuth 批准界面中，Owner Token 在本地以哈希形式验证，不会以明文保存。

ChatGPT 的 Apps/MCP 功能范围和套餐支持可能会发生变化。如果在当前产品 UI 中看不到该功能，请先确认 Custom GPT Actions 方式。

5. 实际用法

连接完成后，无需记住 JK 内部工具名称。

只需用自然语言说出想要的结果即可。

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

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

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

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

对于较长的任务，同时说明以下四点会更稳定。

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

示例：

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

6. 安全机制

JK 并不是授予 ChatGPT 对 PC 无限整体权限的工具。

• 以选定的 workspace/project 范围为核心进行访问

• 修改现有文件时可以进行基于哈希的冲突保护

• 对 secret 值进行脱敏

• 对敏感的 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 schema

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

MCP endpoint

https://내주소/mcp

更多详细文档

• 安装指南

• 使用指南

• 执行/权限策略

• 本地扩展设置

• Attribution & Compliance

Attribution

JK 是基于 ezBuilder/chatgpt2codex 修改的独立非官方 fork。

OpenAI、ChatGPT、GPT、Codex 是各自权利人的商标。JK 不是 OpenAI 的官方产品、官方插件或官方合作伙伴项目。