JK

ChatGPTが自分のPCのプロジェクトを読み、修正し、テストし、Git操作まで行えるようにするローカルコーディングブリッジです。

English | 한국어

JKはOpenAI公式製品ではなく非公式プロジェクトです。ezBuilder/chatgpt2codexをベースに修正したフォークであり、元のコードのライセンス/再配布条件はAttribution & Complianceを先に確認してください。

最初に知っておくべきこと

JKは2番目のAIではありません。

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

ChatGPTが判断し、JKが自分のPCで実際の作業を実行します。

そして以前の表現である**「ChatGPTプラグイン」**の代わりに、現在は以下の2つの方式のいずれかで接続します。

1. 個人Plusユーザーにおすすめ: Custom GPT + Actions

2. 対応しているBusiness / Enterprise / Edu環境: ChatGPT Apps + MCP

どちらもJKのOwner Tokenで所有者認証を行うことができます。

1. インストール

Related MCP server: localterminal-lite

準備物

• Windows 10/11推奨

• Git

• Node.js 22以上

• npm

• ChatGPTアカウント

• 個人ドメイン1つ (例: example.com — ChatGPT Webから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アドレスが必要です

知人向けインストールガイドでは、個人ドメイン1つを必須準備物と見なします。 例えばexample.comを持っているなら、jk.example.comのようなサブドメインをJK接続用に使用します。JKはドメインの購入やDNS/HTTPSの自動構成は行いません。

技術的には、自分が管理する他の公開HTTPS hostnameを使用することもできますが、このREADMEの知人向け配布手順は自分所有のドメインを使用する前提で説明します。

JKは基本的に以下のローカルアドレスでのみ実行されます。

http://127.0.0.1:7979

ChatGPT Webサービスはユーザーの127.0.0.1に直接接続できないため、実際のChatGPT接続には例えば以下のようなアドレスが必要です。

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

公開版JKは特定のトンネル、DNS、クラウドサービスを自動で作成しません。HTTPSリバースプロキシまたはトンネルはユーザーが別途準備する必要があります。

外部アドレスが準備できたら、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サーバーは次の2つの認証をすべて受け付けます。

• 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 테스트하고 화면 확인해줘.

長い作業は以下の4つを一緒に伝えると安定します。

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

例:

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

6. 安全装置

JKはChatGPTにPC全体の権限を無制限に与えるツールではありません。

• 選択したworkspace/project範囲を中心にアクセス

• 既存ファイル修正時のハッシュベースの衝突保護が可能

• secret値のredaction

• 機密性の高いshell / network / 破壊的コマンドへの安全ゲート適用

• 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をベースに修正した独立・非公式フォークです。

OpenAI、ChatGPT、GPT、Codexは各権利者の商標です。JKはOpenAIの公式製品、公式プラグイン、または公式パートナープロジェクトではありません。