JK

Un puente de codificación local que conecta a ChatGPT para que pueda leer, modificar, probar y realizar operaciones de Git en los proyectos de mi PC.

English | 한국어

JK es un proyecto no oficial, no es un producto oficial de OpenAI. Es un fork modificado basado en ezBuilder/chatgpt2codex; consulte primero Attribution & Compliance para conocer las condiciones de licencia/redistribución del código original.

Lo primero que debes saber

JK no es una segunda IA.

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

ChatGPT toma las decisiones y JK ejecuta el trabajo real en mi PC.

Y, en lugar de la antigua expresión "ChatGPT plugin", actualmente se conecta mediante una de las dos formas siguientes:

1. Recomendado para usuarios individuales de Plus: Custom GPT + Actions

2. Entornos de Business / Enterprise / Edu compatibles: ChatGPT Apps + MCP

Ambas pueden autenticar al propietario mediante el Owner Token de JK.

1. Instalación

Requisitos

• Windows 10/11 recomendado

• Git

• Node.js 22 o superior

• npm

• Cuenta de ChatGPT

• 1 dominio propio (por ejemplo: example.com — se usa para crear la dirección HTTPS para acceder a JK desde la web de ChatGPT)

Instalación:

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

Ejecución

Windows:

npm run chatgpt:windows

macOS / Linux:

npm run chatgpt

Si la primera ejecución es correcta, se mostrará aproximadamente la siguiente información.

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

También puedes abrir la siguiente dirección en el navegador.

http://127.0.0.1:7979/

2. Guardar el Owner Token

En la primera ejecución, JK genera automáticamente un Owner Token y lo muestra una sola vez en la terminal.

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

Guarda este token como una contraseña.

• No lo subas a GitHub.

• No lo expongas en capturas de pantalla.

• No lo compartas con otras personas.

• Guárdalo en un gestor de contraseñas si es posible.

Si pierdes el token, puedes emitir uno nuevo.

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

Al crear un token nuevo, es posible que las conexiones OAuth existentes deban autenticarse de nuevo.

No es el método de la versión de escritorio personal anterior de JK, donde se obtenía el token desde la GUI. En la versión pública actual jk-mcp, el CLI/launcher de primera ejecución emite el token.

3. Conexión con ChatGPT

Condición importante: se necesita una dirección HTTPS accesible desde Internet

En la guía de instalación para conocidos, se considera un requisito indispensable disponer de un dominio propio. Por ejemplo, si tienes example.com, puedes usar un subdominio como jk.example.com para la conexión de JK. JK no compra dominios ni configura DNS/HTTPS automáticamente.

Técnicamente, también se puede usar otro hostname HTTPS público que administres tú mismo, pero el procedimiento de este README para instalaciones de conocidos asume que se usa un dominio de tu propiedad.

JK, por defecto, se ejecuta únicamente en la siguiente dirección local.

http://127.0.0.1:7979

El servicio web de ChatGPT no puede acceder directamente al 127.0.0.1 del usuario, por lo que para la conexión real con ChatGPT se necesita, por ejemplo, una dirección como la siguiente:

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

La versión pública de JK no crea automáticamente túneles, DNS ni servicios en la nube específicos. El proxy inverso HTTPS o el túnel deben ser preparados por el usuario por separado.

Cuando la dirección externa esté lista, indícala como hostname al ejecutar JK.

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

Entonces las URL principales quedarán de la siguiente manera.

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

4-A. ChatGPT Plus: Conexión mediante Custom GPT Actions

Para usuarios individuales de Plus, este es el método más sencillo.

1. Entra en ChatGPT y ve a Custom GPT.

2. En el nuevo GPT, selecciona Create new action.

3. Carga el OpenAPI de la siguiente dirección.

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

4. En Authentication, selecciona API Key → Bearer.

5. En el valor de la API Key, introduce el Owner Token que se mostró al ejecutar JK por primera vez.

6. En Preview, prueba action_health o una consulta simple de proyectos.

JK Actions aceptan ambas autenticaciones.

• Usar el Owner Token de JK directamente como Bearer

• Usar el token de acceso OAuth de JK

Se recomienda el método Bearer Owner Token para instalaciones personales.

Prompt para comprobar la conexión

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

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

Si la conexión es correcta, ChatGPT podrá responder con la información del proyecto local.

4-B. Conexión mediante ChatGPT Apps / MCP

Se puede usar si tu cuenta/espacio de trabajo de ChatGPT admite custom MCP apps y las write actions necesarias.

1. Activa el modo developer de ChatGPT.

2. Crea una app en Apps.

3. Introduce la siguiente dirección en el endpoint MCP.

https://jk.example.com/mcp

4. Completa la autenticación OAuth.

5. Cuando se abra la pantalla de aprobación de JK, introduce el Owner Token.

6. Tras la aprobación, escanea y conecta las herramientas de JK.

Las funciones de Apps/MCP de ChatGPT y la compatibilidad con planes pueden cambiar. Si la función no aparece en la interfaz actual del producto, consulta primero el método de Custom GPT Actions.

5. Uso real

Una vez conectado, no necesitas memorizar los nombres internos de las herramientas de JK.

Simplemente di lo que quieres en lenguaje natural.

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

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

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

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

Para tareas largas, es más estable mencionar los siguientes cuatro puntos.

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

Ejemplo:

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

6. Medidas de seguridad

JK no otorga a ChatGPT acceso ilimitado a todo el PC.

• Acceso basado en el workspace seleccionado

• Protección contra conflictos mediante hash al modificar archivos existentes

• Redacción de valores secretos

• Aplicación de puertas de seguridad para comandos sensibles de shell, red o destructivos

• commit / push requieren intención explícita del usuario

• Guarda la sesión de trabajo y los resultados de verificación recientes

Aun así, cualquier persona que tenga el Owner Token puede acceder a JK, por lo que debes mantenerlo en secreto.

7. Si surge algún problema

JK no se inicia

npm ci
npm run build
npm run chatgpt:windows

Perdí el Owner Token

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

ChatGPT no se conecta a JK

Primero comprueba si responde localmente.

http://127.0.0.1:7979/

Si responde localmente pero no desde fuera, normalmente el problema está en la dirección HTTPS externa o en la configuración del endpoint.

8. Stack y referencias

Stack principal

• Node.js, express, TypeScript

• OAuth2 + Express server

• MCP SDK oficial de OpenAI

• vite + vanilla-ts (frontend de aprobación)

Documentos relacionados

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

Licencia

https://내주소/mcp