JK

Eine lokale Coding-Bridge, die ChatGPT mit den Projekten auf meinem PC verbindet, sodass es sie lesen, ändern, testen und sogar Git-Operationen ausführen kann.

English | 한국어

JK ist ein inoffizielles Projekt und kein offizielles OpenAI-Produkt. Es ist ein Fork, der auf Basis von ezBuilder/chatgpt2codex modifiziert wurde. Bitte prüfen Sie zuerst die Lizenz-/Weiterverbreitungsbedingungen des Originalcodes unter Attribution & Compliance.

Das Wichtigste zuerst

JK ist keine zweite KI.

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

ChatGPT entscheidet, JK führt die eigentliche Arbeit auf meinem PC aus.

Und statt des früheren Begriffs „ChatGPT-Plugin“ wird die Verbindung jetzt über eine der folgenden beiden Methoden hergestellt:

1. Für private Plus-Nutzer empfohlen: Custom GPT + Actions

2. Für unterstützte Business-/Enterprise-/Edu-Umgebungen: ChatGPT Apps + MCP

Beide ermöglichen die Eigentümer-Authentifizierung über das Owner Token von JK.

1. Installation

Related MCP server: localterminal-lite

Voraussetzungen

• Windows 10/11 empfohlen

• Git

• Node.js 22 oder höher

• npm

• ChatGPT-Konto

• Eine private Domain (z. B. example.com – wird verwendet, um eine HTTPS-Adresse zu erstellen, über die von ChatGPT Web aus auf JK zugegriffen wird)

Installation:

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

Ausführen

Windows:

npm run chatgpt:windows

macOS / Linux:

npm run chatgpt

Wenn der erste Start erfolgreich war, werden in etwa die folgenden Informationen angezeigt:

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

Die folgende Adresse kann auch im Browser geöffnet werden:

http://127.0.0.1:7979/

2. Owner Token speichern

JK generiert beim ersten Start automatisch ein Owner Token und zeigt es nur einmal im Terminal an.

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

Bewahren Sie dieses Token wie ein Passwort auf.

• Veröffentlichen Sie es nicht auf GitHub.

• Machen Sie keine Screenshots davon.

• Teilen Sie es nicht mit anderen.

• Speichern Sie es wenn möglich in einem Passwort-Manager.

Wenn Sie das Token verloren haben, können Sie ein neues Token ausstellen lassen.

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

Wenn Sie ein neues Token erstellen, müssen bestehende OAuth-Verbindungen möglicherweise erneut authentifiziert werden.

Dies ist nicht wie bei der früheren JK-Desktopversion für den privaten Gebrauch, bei der das Token über die GUI abgerufen wurde. In der aktuellen öffentlichen Version jk-mcp wird das Token beim ersten Start vom CLI/Launcher ausgestellt.

3. Mit ChatGPT verbinden

Wichtige Voraussetzung: Eine über das Internet erreichbare HTTPS-Adresse ist erforderlich

In der Installationsanleitung für Bekannte wird eine private Domain als Pflichtvoraussetzung betrachtet. Wenn Sie z. B. example.com besitzen, verwenden Sie eine Subdomain wie jk.example.com für die JK-Verbindung. JK kauft keine Domains und konfiguriert DNS/HTTPS nicht automatisch.

Technisch gesehen können Sie auch einen anderen öffentlichen HTTPS-Hostnamen verwenden, den Sie selbst verwalten. Die Verteilungsanleitung für Bekannte in diesem README geht jedoch von der Verwendung einer eigenen Domain aus.

JK läuft standardmäßig nur unter der folgenden lokalen Adresse:

http://127.0.0.1:7979

Da der ChatGPT-Webdienst nicht direkt auf 127.0.0.1 des Benutzers zugreifen kann, ist für die tatsächliche ChatGPT-Verbindung beispielsweise eine Adresse wie die folgende erforderlich:

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

Die öffentliche Version von JK erstellt keine bestimmten Tunnel-, DNS- oder Cloud-Dienste automatisch. Ein HTTPS-Reverse-Proxy oder Tunnel muss vom Benutzer separat bereitgestellt werden.

Wenn die externe Adresse bereitsteht, geben Sie den Hostnamen beim Start von JK an.

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

Die wichtigsten URLs sehen dann wie folgt aus:

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

4-A. ChatGPT Plus: Verbindung über Custom GPT Actions

Für private Plus-Nutzer ist diese Methode am einfachsten.

1. Gehen Sie in ChatGPT zu GPT erstellen.

2. Wählen Sie unter Actions des neuen GPT die Option Create new action.

3. Laden Sie im Schema die OpenAPI von der folgenden Adresse:

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

4. Stellen Sie die Authentifizierung auf API Key → Bearer.

5. Geben Sie als API-Key-Wert das Owner Token ein, das Sie beim ersten Start von JK erhalten haben.

6. Testen Sie in der Vorschau action_health oder eine einfache Projektabfrage.

Der JK-Actions-Server akzeptiert beide folgenden Authentifizierungsarten:

• Verwendung des Owner Tokens direkt als Bearer-Token

• Verwendung des JK-OAuth-Zugriffstokens

Bei privaten Installationen für Bekannte erfordert die Bearer-Owner-Token-Methode den geringsten Konfigurationsaufwand.

Prompt zur Verbindungsprüfung

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

Oder:

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

Bei erfolgreicher Verbindung ruft ChatGPT die JK-Action auf und erhält die lokalen Projektinformationen.

4-B. Verbindung über ChatGPT Apps / MCP

Diese Methode kann verwendet werden, wenn das ChatGPT-Konto/der Workspace eine benutzerdefinierte MCP-App und die erforderlichen Write-Actions unterstützt.

1. Aktivieren Sie den Developer Mode in ChatGPT.

2. Erstellen Sie unter Apps eine benutzerdefinierte App.

3. Geben Sie unter MCP-Endpunkt die folgende Adresse ein:

https://jk.example.com/mcp

4. Führen Sie die OAuth-Authentifizierung durch.

5. Wenn die JK-Genehmigungsseite geöffnet wird, geben Sie das Owner Token ein.

6. Scannen/verbinden Sie nach der Genehmigung die JK-Tools.

Auf dem OAuth-Genehmigungsbildschirm von JK wird das Owner Token lokal als Hash verifiziert und nicht im Klartext gespeichert.

Der Funktionsumfang von ChatGPT Apps/MCP und die Tarifunterstützung können sich ändern. Wenn die Funktion in der aktuellen Produkt-UI nicht sichtbar ist, prüfen Sie zuerst die Custom-GPT-Actions-Methode.

5. Praktische Verwendung

Nach der Verbindung müssen Sie sich die Namen der internen JK-Tools nicht merken.

Sie können das gewünschte Ergebnis einfach in natürlicher Sprache formulieren.

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

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

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

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

Bei längeren Aufgaben ist es zuverlässiger, die folgenden vier Dinge gemeinsam zu nennen:

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

Beispiel:

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

6. Sicherheitsvorkehrungen

JK ist kein Werkzeug, das ChatGPT uneingeschränkten Zugriff auf den gesamten PC gewährt.

• Zugriff vorwiegend auf den ausgewählten Workspace-/Projektbereich

• Hashbasierter Kollisionsschutz bei der Änderung vorhandener Dateien möglich

• Schwärzung von Secret-Werten

• Sicherheitsgate für sensible Shell-/Netzwerk-/destruktive Befehle

• Commit/Push erfordert die ausdrückliche Absicht des Benutzers

• Speicherung von Arbeitssitzungen und letzten Verifizierungsergebnissen

Dennoch gilt: Jeder, der das Owner Token besitzt, kann auf JK zugreifen. Das Token muss daher unbedingt geheim aufbewahrt werden.

7. Wenn Probleme auftreten

JK startet nicht

npm ci
npm run build
npm run chatgpt:windows

Owner Token verloren

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

ChatGPT kann keine Verbindung zu JK herstellen

Prüfen Sie zuerst lokal:

http://127.0.0.1:7979/

Wenn die lokale Adresse geöffnet werden kann, aber nur ChatGPT keine Verbindung herstellt, liegt es meist am externen HTTPS-Endpunkt / Reverse-Proxy / Tunnel.

Actions-Schema prüfen

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

MCP-Endpunkt

https://내주소/mcp

Weitere Dokumentation

• Installationsanleitung

• Benutzerhandbuch

• Ausführungs-/Berechtigungsrichtlinie

• Lokale Erweiterungseinstellungen

• Attribution & Compliance

Attribution

JK ist ein unabhängiger, inoffizieller Fork, der auf Basis von ezBuilder/chatgpt2codex modifiziert wurde.

OpenAI, ChatGPT, GPT und Codex sind Marken der jeweiligen Rechteinhaber. JK ist kein offizielles Produkt, kein offizielles Plugin und kein offizielles Partnerprojekt von OpenAI.