ChatGPT와 ChatGPT classic 에 연결하기

⚠ 먼저: 앱이 둘이다

OpenAI 앱은 ChatGPT 와 ChatGPT classic 두 개가 함께 깔린다. 붙이는 방법은 이제 둘 다 같다. 앱 안에서 플러그인 디렉터리의 AiAkiv Memory 를 설치한다 (2026-09-20 등재). 보통은 이것으로 끝난다. 다른 방법을 쓰는 경우는 둘이다. 폴더마다 프로젝트를 고정하려면 ChatGPT 앱에서 API 키를 쓴다(§2). 앱 기능(AI에게 콘솔 관리 같은 앱 일을 시키는 기능)을 쓰려면 Codex 에 설치 프롬프트로 따로 연결하거나 폴더에 API 키로 연결한다(§6).

예전 자료에서 Codex 라고 부르던 것이 지금의 ChatGPT 다. 설정 파일이 .codex/config.toml 인 것도 그래서다. §6 의 설치 프롬프트는 Codex CLI 같은 Codex 대화창에 붙여 넣는다.

한눈에

• 플러그인은 한 번 설치하면 계정 전체에 적용돼 웹과 두 앱 모두에서 보인다.
• 두 설정은 함께 두어도 된다. 폴더 쪽은 AiAkiv-<프로젝트 이름> 이라는 다른 이름으로 붙으니, 그 이름으로 어느 쪽을 쓸지 지목한다 → §4
• 그래도 한 쪽만 쓰는 것을 권한다 → §5
• 앱 기능은 공식 ChatGPT 플러그인에서 지원하지 않는다. 쓰려면 Codex 에 설치 프롬프트로 따로 연결하거나 폴더에 API 키로 연결한다 → §6

저장이 어디로 가는지도 다르다. 플러그인 설치와 설치 프롬프트로 붙인 Codex 연결은 콘솔의 Main을 따라가고, 폴더의 키는 그 프로젝트에 고정된다 (팀과 프로젝트).

1. 플러그인으로 설치한다 (두 앱 공통)

앱 안에서 검색해 설치한다. 주소를 손으로 넣을 일이 없다.

1. 설정 → Plugins → Browse directory 를 연다. 왼쪽 사이드바의 Plugins 로 가도 같은 화면이다.
2. 검색창에 AiAkiv Memory 를 입력하고 결과를 누른다.
3. Install plugin 을 누르고 www.aiakiv.com 계정으로 로그인한다. 한 번 설치하면 계정 전체에 적용돼 ChatGPT classic 에서도 보인다.
4. 대화마다 켠다. 플러그인은 대화 단위로 켜진다. 새 대화 입력창 아래 Plugins 에서 AiAkiv Memory 를 켜고 @AiAkiv Memory 로 부른다. 설치 직후 뜨는 Try now 를 누르면 이미 켜진 대화가 열린다. 이 단계를 빼먹으면 새 대화에서 도구가 아예 안 보인다.

보통은 플러그인 설치로 충분하다. 2026-09-20 AiAkiv 가 OpenAI 플러그인 디렉터리에 등재된 뒤로, 저장과 검색, 카드 만들기만 쓴다면 주소를 손으로 넣을 일이 없다. 주소를 직접 등록하는 연결은 앱 기능을 쓸 때만 만든다 → §6.

저장은 Main으로 간다. 플러그인 설치에는 프로젝트를 못 박는 장치가 없어서, 콘솔에서 정한 Main 프로젝트로 들어간다. 저장 대상 확인에서 binding 이 "main" 으로 뜬다. 폴더마다 프로젝트를 다르게 쓰고 싶다면 §2로 간다.

앱 기능은 공식 ChatGPT 플러그인에서 지원하지 않는다. ChatGPT 플러그인 디렉터리의 공식 AiAkiv Memory 플러그인은 앱 기능(AI에게 콘솔 관리 같은 앱 일을 시키는 기능)을 지원하지 않는다. 이 연결에는 앱 실행 도구 run_aiakiv_app_action 이 없다. 기억 저장, 검색, 연결된 팀 읽기, 그래프 질의, 카드 만들기는 그대로 된다. 팀, 초대, 프로젝트, 카드 관리 같은 콘솔 일은 웹 콘솔에서 직접 하거나, §6의 두 방법 가운데 하나로 연결해 AI에게 시킨다 → 앱 실행 도구.

2. ChatGPT: 폴더마다 고정하려면 API 키로 붙는다

§1로 설치하면 계정 전체가 Main을 따라간다. 폴더마다 다른 프로젝트로 저장하고 싶을 때 이 방법을 쓴다. 로그인(OAuth) 방식의 폴더 고정(연결 주소의 ?project=, X-K2G-Project 머리글)은 이 앱에서 걸리지 않으므로, 폴더를 고정하는 설정은 프로젝트 고정 API 키 하나다.

키를 쓰면 인증 단계 자체가 사라진다. 인증이 이미 키 안에 들어 있어서 로그인 창도, 브라우저도 필요 없다(연결 인증).

1. 콘솔에서 그 프로젝트의 API 키를 발급한다(발급 직후 한 번만 보인다). 여기서는 프로젝트 키를 쓴다. 동적 키도 붙기는 하지만 저장 위치가 Main을 따라 움직여서, 폴더에 못 박으려는 목적과 어긋나고 §4처럼 두 설정을 함께 둘 때 어디에 저장됐는지가 더 헷갈린다. 동적 키 자체는 다른 데서 쓰면 된다 (연결 인증).

2. 작업 폴더의 .codex/config.toml 에 아래를 넣는다. 파일 위치는 앱·CLI· IDE 확장이 모두 같다.

   [mcp_servers.AiAkiv-myproject]
   url = "https://mcp.aiakiv.com/mcp"
   http_headers = { "Authorization" = "Bearer <발급받은 키>" }
   

3. 앱을 재시작한다.

이름은 AiAkiv-<프로젝트 이름> 이다. 위 예시의 AiAkiv-myproject 는 프로젝트 myproject 의 폴더 연결 이름이다. 콘솔에서 복사하면 내 프로젝트 이름이 들어간 채로 나온다. AiAkiv 로 두면 §1의 플러그인 설치와 이름이 겹쳐 둘을 구분할 수 없게 된다. 이름을 짓는 규칙은 §4.

ChatGPT 데스크톱 앱에서는 두 연결이 함께 보인다. 데스크톱 앱은 폴더의 .codex/config.toml 을 읽어, 폴더 연결(AiAkiv-myproject, 이 프로젝트에 고정)과 §1의 계정 쪽 연결(AiAkiv 플러그인, Main을 따름)을 동시에 인식한다. 이름이 다르니 "AiAkiv-myproject 로 저장해줘" 처럼 폴더 쪽 이름을 지목하면 이 프로젝트로 동작한다(§3·§4). Codex CLI 는 폴더 연결로 동작한다. 그 폴더에서 codex 를 실행하고, 이 폴더를 신뢰하겠냐고 물으면 신뢰한다고 답해야 설정을 읽는다.

폴더 ZIP 으로 한 번에 받을 수도 있다. 콘솔 프로젝트 카드의 이 프로젝트 MCP 설정 → 프로젝트 고정 API 키 탭에서 폴더 ZIP 받기를 누르면, 설정 파일 (.mcp.json, .gemini/settings.json, .codex/config.toml)과 AiAkiv 스킬이 든 폴더가 내려온다. 풀어서 작업할 위치에 두면 된다. 스킬은 Claude 용이 .claude/skills/ 에, Codex·Gemini 용이 .agents/skills/ 에 들어 있다. 이 화면에 발급한 키가 없으면 버튼이 키를 발급해 ZIP 에 넣는다. ZIP 을 받은 뒤 '이 프로젝트용 정적 키 발급'을 누르면 ZIP 안의 키가 폐기된다(한 프로젝트에 살아 있는 키는 하나뿐이다).

프로젝트가 키에 고정된다. 좌표가 키 안에 동결돼 있어서 콘솔에서 Main을 바꿔도 이 폴더는 안 움직인다. 저장 대상 확인에서 binding 이 "api-key" 로 뜬다.

⚠ 키가 곧 신분증이다. 유출은 내 기억에 대한 접근이 통째로 넘어가는 것을 뜻한다. config.toml 을 저장소에 올리지 않는다. 지켜야 할 최소선 전체는 연결 인증의 키 보안.

3. 한 앱 안에서 두 설정이 만난다

ChatGPT 앱에서는 두 설정이 동시에 보일 수 있다.

• 플러그인 설치(§1)는 계정에 붙는 것이라, 한 번 설치하면 이 앱에서도 보인다.
• 폴더의 키(§2)는 그 폴더에서 일을 시작할 때 읽힌다.

그래서 같은 앱에서 대화는 플러그인으로, 폴더 작업은 폴더의 키로 붙는 상황이 나온다. 문제가 되는 상황은 아니다. 다만 어느 쪽으로 저장됐는지가 헷갈리기 시작한다. 그래서 폴더 프로젝트로 저장하고 싶으면 폴더 쪽 연결 이름(§4)을 지목한다.

4. 둘을 함께 쓰기: 폴더 연결은 이름이 다르다

§1과 §2는 동시에 사용할 수 있다. 둘이 함께 있는 것이 정상이고, 막지 않는다. 둘은 이름으로 구별한다.

전역과 폴더의 MCP 서버 이름이 다르다.

	이름	저장 위치
전역: 플러그인 설치	AiAkiv	Main을 따라간다
폴더: .codex/config.toml	AiAkiv-<프로젝트 이름> (예: AiAkiv-k2g)	그 프로젝트에 고정

이름이 둘 다 AiAkiv 면 어느 쪽을 쓰라고 지목할 방법이 없다. 도구 이름까지 같아 지므로 AI가 그때그때 아무 쪽이나 고르고, 저장이 어디로 갔는지는 나중에야 알게 된다. 이름이 다르면 "AiAkiv-k2g 로 저장해줘" 처럼 지목할 수 있다.

폴더 연결 이름을 짓는 규칙. 콘솔이 복사해 주는 설정과 폴더 ZIP 은 폴더 연결 이름을 AiAkiv-<프로젝트 이름> 으로 낸다. Claude·Gemini·ChatGPT 모두 같다. 이 이름은 AI가 부르는 도구 이름(mcp__<연결 이름>__<도구>)에 들어가는데, 도구 이름에는 영문 글자· 숫자·-·_ 만 쓸 수 있다. 그래서 프로젝트 이름이 그대로 들어가지 않을 때가 있다.

• 공백과 기호는 - 로 바뀐다. 프로젝트 My Project → AiAkiv-My-Project. 이어진 -·_ 는 하나로 줄이고, 이름 앞뒤의 -·_ 는 뗀다.
• 영문이 아닌 글자(한글·일본어 등)는 빠지고, 프로젝트 id 에서 뽑은 짧은 코드가 붙는다. 거의 다 빠지면 코드만 남는다(예: AiAkiv-3f9a1c). 일부만 빠지면 남은 앞부분 뒤에 붙는다(예: K2G-연구 → AiAkiv-K2G-3f9a1c). 코드는 프로젝트마다 다르다.
• 너무 길면 잘린다. 연결 이름은 26자를 넘지 않는다. 잘린 이름 뒤에도 짧은 코드가 붙는다.

프로젝트 이름은 가능하면 영문 글자·숫자·-·_ 로 짓는다. 영문이 아닌 글자가 들어 있으면 연결 이름이 코드로 바뀌어 알아보기 어렵다. 그럴 때는 설정 파일 (.mcp.json, .gemini/settings.json, .codex/config.toml) 안의 서버 이름을 알아보기 쉬운 영문 이름으로 바꿔 써도 된다(예: AiAkiv-research). 새 이름도 AiAkiv- 로 시작하고 영문 글자·숫자·-·_ 만 써서 26자 이내로 짓는다. Claude Code 는 .claude/settings.json 의 enabledMcpjsonServers 안 이름도 똑같이 바꿔야 한다. 두 이름이 다르면 폴더 연결이 저절로 켜지지 않는다.

Claude는 다르다. 이름을 달리해도 AI가 계정 커넥터 쪽을 쓸 수 있다. 그래도 계정 커넥터는 끄지 않고(끄면 웹과 모바일 앱에서도 꺼진다) 저장 뒤 목적지를 확인한다 → 계정 커넥터와 폴더 연결이 함께 있을 때.

5. 권장: 하나만 쓰되, 함께 쓸 거면 확인을 붙인다

§1 또는 §2 중 하나만 쓰는 것을 권한다. 설정이 하나면 저장이 어디로 가는지 헷갈릴 일이 없다.

함께 써야 한다면 두 가지를 지킨다.

1. 쓸 쪽을 명시한다. 일을 시킬 때 §4의 연결 이름으로 어느 쪽인지 말한다.
2. 저장 대상을 자주 확인한다. 아래 §확인하기. ChatGPT는 대체로 스스로 get_save_target 을 자주 부르는 편이라, 확인을 요청하면 잘 따른다.

지목이 곧 전환이다(2026-09-21 실측). 폴더의 키를 깐 work(Codex) 세션에서 그냥 "save target 확인" 을 물으면 폴더 프로젝트로 대답한다. 같은 세션에서 입력창의 @AiAkiv-Memory(플러그인)를 고른 뒤 같은 질문을 하면 폴더를 무시하고 전역 Main 으로 간다. 즉 멘션이 어느 쪽을 쓸지 정한다. 방금 무엇을 골랐는지 기억나지 않으면 저장 전에 §확인하기로 다시 본다.

6. 앱 기능을 쓰려면

앱 기능은 AI에게 콘솔 관리 같은 앱 일을 시키는 기능이다. 팀 만들기, 초대, 프로젝트 관리, 만든 카드 관리를 대화에서 시키는 것이 여기에 든다. AI는 이 일을 앱 실행 도구 run_aiakiv_app_action 으로 한다 → 앱 실행 도구.

콘솔 앱이 하는 일은 대략 팀 만들기와 초대, 팀 연결의 초대 코드와 수락, 일시정지, 재개, 감사 기록과 저장 대상 전환 이력 보기, 프로젝트 만들기와 페르소나 고치기, Main(저장 대상) 바꾸기와 끄고 켜기, 공개 대상 보기와 숨기기, 만든 카드 관리, 켜 둔 AI 권한 확인이다. 이 일은 모두 사람이 웹 콘솔(대시보드, app.aiakiv.com)에 접속해 직접 할 수 있다. AI에게 시키는 것은 편의이고, 공식 플러그인만 쓰는 사람도 웹 콘솔에서 전부 할 수 있다.

앱 기능은 공식 ChatGPT 플러그인에서 지원하지 않는다. §1로 설치한 연결로는 기억 저장, 검색, 연결된 팀 읽기, 그래프 질의, 카드 만들기를 쓴다. ChatGPT에서 앱 기능을 쓰는 방법은 둘이다.

방법 1. Codex 에 연결 (설치 프롬프트)

왜 따로 설치하나. 플러그인 디렉터리의 AiAkiv Memory 플러그인에는 앱 실행 도구 run_aiakiv_app_action 이 없다. OpenAI 플러그인 심사 정책과 AiAkiv 의 앱 기능이 맞지 않는 부분이 있어서다. 이 도구는 도구 하나가 여러 앱의 여러 일을 받아 실행하는 범용 실행 도구인데, 플러그인에는 이런 도구를 담을 수 없었다. 그런데 AiAkiv 의 앱 기능은 전부 이 도구로 돌아간다. 콘솔 관리, Contents 에서 작품 쓰기, 만든 카드 관리처럼 AI 가 세밀하게 제어하는 일이 다 그렇다. 그래서 플러그인으로도 기억 저장, 검색, 그래프 질의, 연결된 팀 읽기, 카드 만들기는 되지만, Codex 에서 앱 기능까지 쓰려면 이 연결을 따로 설치한다.

무엇을 얻나.

• 앱 기능: run_aiakiv_app_action 으로 콘솔 관리, Contents 작품 쓰기, 만든 카드 관리를 대화에서 시킨다. 카드 만들기(create_aiakiv_card)도 그대로 있다.
• AiAkiv 스킬 일곱 개: aiakiv-onboarding, aiakiv-save-and-recall, aiakiv-graph-query, aiakiv-links, aiakiv-cards, aiakiv-console, aiakiv-contents. ~/.agents/skills/<스킬 이름>/ 에 들어간다. 콘솔의 폴더 ZIP 에 든 스킬과 같은 경로다.
• 로그인 연결: OAuth 로 붙으므로 관리할 키가 없고, 개발자 모드도 필요 없다.
• 저장은 Main 을 따른다: 저장 대상 확인에서 binding 이 "main" 으로 뜬다. 폴더마다 프로젝트를 고정하려면 여전히 §2 의 API 키를 쓴다.

어떻게.

1. 붙여 넣기 전에 기존 플러그인을 정리한다(아래 이름 규칙).
2. Codex 대화창에 Codex 설치 프롬프트를 붙여 넣는다. Codex 가 주소 https://mcp.aiakiv.com/mcp?apps=all 을 AiAkiv 라는 이름으로 등록하고, 로그인 창을 띄우고, 공개 저장소 github.com/AiAkiv/aiakiv-plugins 의 스킬 일곱 개를 설치하고, 작업 폴더에 설치 기록을 쓴다.
3. 로그인 창이 뜨면 www.aiakiv.com 계정으로 로그인한다. 로그인은 사람이 한다.
4. 새 세션을 열고 Codex 검증 프롬프트를 붙여 넣는다. 도구 목록에 run_aiakiv_app_action 이 보이고, binding 이 "main" 이고, 스킬 일곱 개가 읽히면 끝이다.

이름 규칙.

• 기존 플러그인은 가능하면 삭제하고 AiAkiv 로 설치한다. 둘이 함께 있으면 같은 이름의 도구가 두 벌 생겨 AI 가 아무 쪽이나 고른다.
• 플러그인을 남겨 둘 거면 이 연결의 이름을 AiAkivCodex 로 바꿔 설치한다. chatgpt.com 웹 대화에서도 플러그인을 같이 쓰고 싶을 때다. 설치 프롬프트의 MCP 이름만 바꿔 넣으면 된다. 그러면 "AiAkivCodex 로 저장해 줘" 처럼 어느 쪽을 쓸지 지목할 수 있다.

적용 범위. Codex CLI 에서 실측했다(2026-10-13). Codex 데스크톱 앱과 IDE 확장은 OpenAI 문서상 같은 설정을 읽지만 아직 실측하지 않았다. chatgpt.com 웹 대화에는 이 연결이 보이지 않는다. 웹 대화에서는 §1 의 플러그인을 쓴다.

AI 권한. AI 가 무언가를 바꾸는 콘솔 일은 콘솔의 참고 → AI 권한에서 켠 것만 할 수 있다. 읽기는 처음부터 켜져 있다 → AI에게 콘솔 일 시키기.

방법 2. 폴더에 API 키로 연결

§2의 방법 그대로다. 작업 폴더의 .codex/config.toml 에 프로젝트 고정 API 키를 두면 그 폴더가 한 프로젝트에 고정되고, 그 연결에 앱 기능이 있다. AI에게 무언가를 바꾸는 콘솔 일을 시키려면 키를 발급할 때 "AI 콘솔 관리 허용 (manage)" 를 체크해야 한다(연결 인증).

확인하기

일을 시작하기 전에 AI에게 물어본다.

aiakiv 지금 어디에 저장돼?

AI가 get_save_target 을 부르고 결과를 알려준다. binding 값이 지금 어느 설정으로 붙어 있는지를 그대로 말해 준다.

말에 aiakiv 를 넣는다(2026-09-21 실측). ChatGPT 대화에서 "save target 확인" 처럼만 물으면 플러그인을 부르지 않고 그냥 대답해 버리는 경우가 있다. "aiakiv save target 확인" 처럼 이름을 섞으면 바로 도구를 부른다. 폴더의 키로 붙은 work(Codex) 쪽은 이름 없이도 도구를 부르는 것이 확인됐다.

측정한 계정은 AiAkiv 를 오래 써 온 이력이 있다. 막 설치한 계정에서는 모델이 도구를 고르는 습관이 이와 다를 수 있다.

프로젝트 이름에 (Main) 접미사가 붙어 있으면 전역 Main을 따라가는 중이다.

두 연결이 함께 있으면 폴더 연결 이름을 지목해 확인한다: "AiAkiv-k2g 연결로 get_save_target 을 불러 줘". binding 이 "api-key"(OAuth 로 붙인 폴더 설정이면 "folder")이고 프로젝트가 맞으면 폴더 연결로 붙은 것이다. "main" 이 나오면 계정 쪽 연결을 부른 것이다.

이 둘 말고 binding 이 가질 수 있는 나머지 값은 폴더 바인딩의 제대로 붙었는지 확인하기 에 있다.

자주 겪는 문제

• 어느 앱을 열었는지 모르겠다. 설치(§1)는 둘 다 같다. 폴더 고정(§2)은 아이콘 이름이 ChatGPT 인 앱에서만 된다.
• 폴더 설정을 넣었는데 안 붙는다. 로그인(OAuth) 방식(주소의 ?project= 나 X-K2G-Project 머리글)으로 넣지 않았는지 본다. 이 앱에서 폴더를 고정하는 것은 §2의 키 방식 하나다.
• 저장이 엉뚱한 프로젝트로 간다. 두 설정이 함께 켜져 있고 이름이 같을 때 생긴다. §4대로 폴더 쪽 이름을 바꾼다.
• 새 대화에서 도구가 아예 안 보인다. 플러그인은 대화마다 켠다. §1의 4단계.
• AI에게 콘솔 일을 시켰는데 이 연결에서는 할 수 없다고 한다. 앱 기능은 공식 ChatGPT 플러그인에서 지원하지 않는다. §6의 두 방법 가운데 하나로 연결한다.
• 설치 프롬프트로 연결했는데 run_aiakiv_app_action 이 안 보인다. 새 세션에서 Codex 검증 프롬프트를 돌린다. 플러그인이 남아 있고 이름이 같으면 플러그인 쪽으로 확인했을 수 있다. §6 의 이름 규칙대로 플러그인을 지우거나 AiAkivCodex 로 설치한다.
• chatgpt.com 웹 대화에 Codex 연결이 안 보인다. 정상이다. 설치 프롬프트로 붙인 연결은 Codex 쪽에만 있다. 웹 대화에서는 §1 의 플러그인을 쓴다.
• 플러그인을 지웠다 다시 설치했더니 안 붙는다. 예전 상태가 캐시로 남은 것이다 → 자주 겪는 문제.

관련 문서

• 폴더 바인딩 전반과 다른 클라이언트 → 폴더 바인딩
• Claude Desktop에서 폴더 바인딩 → Claude Desktop
• 인증(OAuth·API 키)과 키 보안 → 연결 인증
• Main·프로젝트·저장 대상의 개념 → 팀과 프로젝트
• 콘솔에서 MCP 설정 복사하기 → 콘솔 안내
• Codex 에 앱 기능까지 붙이기 → Codex 설치 프롬프트, Codex 검증 프롬프트
• 앱 실행 도구가 어느 연결에 있나 → 앱 실행 도구
• AI 권한과 시킬 수 있는 콘솔 일 → AI에게 콘솔 일 시키기