Codex에서 Skillry MCP 연결하기(CLI, ChatGPT 앱, IDE 확장)

짧은 답변

1codex mcp add skillry -- npx --yes skillry-cli@latest mcp를 한 번 실행합니다. Windows에서는 실행 부분을 cmd /c로 감쌉니다.
2codex mcp list로 확인하거나, Codex TUI에서 /mcp를 입력합니다.
3ChatGPT 데스크톱 앱과 IDE 확장이 항목을 공유합니다. 한 번 설정하면 셋 모두에서 씁니다.

여기서 시작:추가하기 확인하기 승인하기 작동하지 않을 때

시작하기 전에

2026년 10월 28일에 공식 문서와 대조했습니다. 이 클라이언트의 실제 설치 환경에서는 아직 실행하지 않았습니다. 사용 중인 기기에서 단계가 다르면 페이지 하단의 문제 신고로 알려 주세요.

Codex에 로그인된 상태: CLI, Codex가 포함된 ChatGPT 데스크톱 앱, 또는 IDE 확장. 설정 하나를 공유합니다.
Node.js 22 이상(node --version). Codex는 npx로 서버를 시작합니다.
프로젝트 수준의 .codex/config.toml도 되지만, 신뢰할 수 있다고 표시한 프로젝트에서만 됩니다. 이 가이드는 전역 파일을 사용합니다.

Codex에 Skillry 추가하기

Codex CLI를 쓸 때 가장 빠름

1
아무 터미널에서 이것을 실행합니다:
macOS
```
codex mcp add skillry -- npx --yes skillry-cli@latest mcp
```
다음이 보여야 합니다: 오류 없이 끝나고, codex mcp list에 skillry가 포함됩니다.
2
Windows에서는 Windows가 npx를 시작할 수 있도록 대신 이것을 실행합니다:
Windows(PowerShell 또는 명령 프롬프트)
```
codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Codex를 다시 시작하거나, 앱이나 확장이 열려 있으면 재시작합니다.
다음이 보여야 합니다: Codex 안의 /mcp 목록에 skillry.

터미널 불필요

1
ChatGPT 데스크톱 앱에서 Settings를 열고 MCP servers를 선택합니다. IDE 확장에서는 톱니바퀴 메뉴를 열고 MCP servers를 선택합니다.
2
Add server를 선택합니다. 이름에 skillry를 입력하고 STDIO를 선택한 뒤 명령에 npx --yes skillry-cli@latest mcp(Windows에서는 cmd /c npx --yes skillry-cli@latest mcp)를 입력합니다.
3
저장한 뒤 앱에서는 Restart, IDE에서는 Restart extension을 선택합니다.
다음이 보여야 합니다: MCP 서버 목록에 skillry가 활성화된 것으로 표시됩니다.

Codex 설정을 파일로 관리할 때

1
편집기에서 ~/.codex/config.toml을 엽니다. 없으면 만듭니다.
2
이 테이블을 덧붙입니다. [mcp_servers.skillry] 테이블이 이미 있으면 교체합니다.
macOS
```
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]
```

Windows에서는 대신 이 테이블을 사용합니다.

Windows

[mcp_servers.skillry]
command = "cmd"
args = ["/c","npx","--yes","skillry-cli@latest","mcp"]

4
첫 시작이 시간 초과되면 테이블 아래에 startup_timeout_sec = 60을 추가합니다. 기본값은 10초이고, 첫 npx 실행은 패키지를 내려받습니다.
5
저장하고 Codex를 다시 시작합니다.
다음이 보여야 합니다: codex mcp list와 /mcp에 skillry.

Codex가 연결되었는지 확인하기

1
터미널에서 설정된 서버 목록을 봅니다:
터미널
```
codex mcp list
```
다음이 보여야 합니다: 입력한 npx 명령과 함께 skillry.
2
Codex TUI에서 /mcp를 입력합니다.
다음이 보여야 합니다: 활성 서버 중에 도구와 함께 skillry.

첫 검색 해 보기

검색에는 계정이 필요 없으므로, 연결이 되었는지 확인하는 가장 빠른 방법입니다.

1
Codex에서 새 대화를 열고 이 요청을 붙여 넣습니다.
에이전트에게 보낼 프롬프트
```
Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.
```
다음이 보여야 합니다: Skill 후보 세 개가 나오고, 각각 미리보기 링크, 필요한 입력, 의존성, 외부 비용이 함께 표시됩니다. 설치되는 것은 없습니다.
2
에이전트가 Skillry 도구가 없다고 답하거나 요청이 멈춰 있으면 작동하지 않을 때로 가세요.

설치할 때 승인하기

설치할 때 Skillry 계정을 확인합니다. 에이전트에 비밀번호를 입력하거나 키를 붙여 넣지 않습니다. 처음 한 번 브라우저에 페이지가 열리고, 거기서 승인합니다.

1
Codex에게 선택한 Skill을 설치해 달라고 요청합니다. 예: 이 프로젝트에 설치해 줘.
다음이 보여야 합니다: 에이전트가 계정 연결이 필요하다고 알리고 브라우저를 엽니다. 터미널 클라이언트에서는 링크만 출력될 수 있으니 직접 열어 주세요.
2
페이지의 기기 코드가 에이전트에 표시된 것과 같은지 확인하고, 요청받으면 Skillry에 로그인한 뒤 Approve를 선택합니다.
다음이 보여야 합니다: Authorization approved와 에이전트로 돌아가라는 안내. 에이전트가 몇 초 안에 이를 감지하고 설치를 끝냅니다.

승인은 7일 동안 유효하며 운영체제의 키링(macOS는 키체인, Windows는 자격 증명 관리자)에 저장됩니다. 만료되면 에이전트가 다시 승인을 요청할 뿐입니다. 더 일찍 로그아웃하려면 에이전트에게 Skillry 계정 연결을 해제해 달라고 요청하세요.

Codex가 Skillry를 보지 못할 때

보이는 현상	예상 원인	해결 방법
`codex mcp list`에 `skillry`가 없음	테이블이 신뢰되지 않은 프로젝트의 프로젝트 파일에 들어갔거나, 테이블 이름에 오타가 있음	테이블을 `~/.codex/config.toml`에 두고, 정확히 `[mcp_servers.skillry]`로 적혀 있는지 확인합니다.
서버가 준비되지 않거나 Codex가 시작 시간 초과를 보고함	첫 `npx` 다운로드가 `startup_timeout_sec`(기본 10초)보다 오래 걸림	테이블에 `startup_timeout_sec = 60`을 추가하거나, 실행 명령을 직접 한 번 실행해 패키지를 캐시합니다.
CLI에서는 되는데 ChatGPT 앱에서는 안 됨	파일이 바뀔 때 앱이 열려 있었음	ChatGPT 데스크톱 앱을 종료하고 다시 열거나, IDE에서 Restart extension을 선택합니다.
서버가 목록에 있지만 실패로 표시되거나 아예 시작되지 않음	`npx`가 설치되지 않았거나, Node.js가 22보다 오래되었거나, 첫 시작이 패키지 다운로드 중에 시간 초과됨	터미널에서 `node --version`과 `npx --version`을 실행합니다. 그다음 `npx --yes skillry-cli@latest mcp`를 직접 한 번 실행하고, 시작되면 Ctrl+C를 누른 뒤 클라이언트를 다시 시도합니다. 이제 패키지가 캐시에 있습니다.
Windows에서 서버가 시작되자마자 종료됨	항목이 `npx`를 직접 실행하는데, Windows는 실행에 셸이 필요함	이 페이지의 Windows 항목을 사용합니다. 명령은 `cmd`이고 인수는 `/c`, `npx`로 시작합니다.
브라우저 페이지에 요청이 잘못되었거나 만료되었다고 표시됨	기기 코드를 너무 늦게 승인했거나, 이전 시도의 코드임	에이전트에게 다시 연결해 달라고 요청하고 새 코드를 몇 분 안에 승인합니다.
설치가 Premium 또는 구매 메시지와 함께 멈춤	Skill이 Premium이고 계정에 플랜도 구매 내역도 없음	에이전트가 보여 주는 링크로 Skill을 구매하거나 구독한 뒤 다시 요청합니다. 그전에는 아무것도 결제되지 않습니다.

제거 또는 연결 해제

1
~/.codex/config.toml에서 [mcp_servers.skillry] 테이블을 삭제하거나, codex mcp --help가 사용 중인 버전에 대해 보여 주는 제거 명령을 사용합니다. 삭제하지 않고 끄려면 테이블에 enabled = false를 추가합니다.
2
Codex, 앱, 또는 확장을 재시작합니다.
다음이 보여야 합니다: codex mcp list에서 skillry가 사라집니다.

항목을 제거해도 Skillry에서 로그아웃되지는 않습니다. 저장된 승인까지 취소하려면 먼저 에이전트에게 Skillry 계정 연결 해제를 요청하거나, 항목을 제거하고 7일 뒤 승인이 만료되도록 두세요.

레퍼런스

항목	macOS	Windows
전역 설정 파일	`~/.codex/config.toml`	`%USERPROFILE%\.codex\config.toml`
프로젝트 설정 파일	`.codex/config.toml`(신뢰된 프로젝트만)	같음
실행 명령	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
확인	`codex mcp list` 또는 `/mcp`	같음

Codex가 저장하는 테이블(macOS)

[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]

시간 초과, 도구 허용 목록, 승인 모드는 Codex 공식 MCP 문서에 있습니다.

자주 묻는 질문

ChatGPT 데스크톱 앱용으로 따로 설정하나요?

아니요. 앱, CLI, IDE 확장이 같은 config.toml을 읽습니다. 변경 후 앱을 재시작하세요.

한 프로젝트에서만 쓸 수 있나요?

예. 신뢰된 프로젝트에서는 전역 파일 대신 그 프로젝트 안의 .codex/config.toml에 테이블을 넣으세요.

첫 시작이 왜 느린가요?

첫 npx 실행이 skillry-cli를 내려받기 때문입니다. startup_timeout_sec을 늘리거나 실행 명령을 직접 한 번 실행하세요. 그 뒤로는 바로 시작됩니다.

출처

이 가이드가 도움이 되었나요?

이전Claude Code 다음Cursor