코덱스 플러그인 시작하기: 설치·계정 연결·첫 작업

스킬은 회의록을 어떤 순서로 정리할지 같은 작업 지침이에요. MCP 서버는 외부 서비스의 자료를 읽거나 기능을 실행할 수 있게 연결해요. 플러그인은 이런 기능을 함께 설치하고 관리하는 패키지예요.

플러그인마다 구성이 달라요. 스킬만 들어 있을 수도 있고 외부 연결이나 실행 시점에 맞춰 작동하는 훅이 포함될 수도 있어요. 이름만 보고 기능을 예상하기보다 상세 설명에서 제공하는 작업과 필요한 환경을 확인해 주세요.

데스크톱 앱에서는 Plugins 화면을 열고 필요한 항목을 검색해 상세 내용을 살펴봐요. 설치 버튼으로 추가한 뒤 새 작업에서 사용해 보세요. 공식 문서에서는 ChatGPT 데스크톱 앱 안의 Codex와 Codex CLI를 지원되는 Codex 환경으로 안내해요.

CLI는 터미널에서 codex를 실행한 뒤 대화 입력창에 /plugins를 입력해요. 셸에 /plugins만 입력하는 명령은 아니에요. 설정된 마켓플레이스에서 항목을 고르고 설치한 다음 새 세션을 시작해 주세요.

IDE 확장은 현재 플러그인을 지원하지 않아요. 스킬을 지원하는 것과 플러그인을 설치할 수 있는 것은 다른 조건이에요. Desktop only 표시가 있는 플러그인도 실제로 사용할 환경과 맞는지 확인해 주세요.

패키지 설치와 외부 서비스 인증은 별도 단계예요. 메일이나 문서 서비스의 자료를 읽으려면 해당 계정에 연결하고 요청 권한을 확인해야 해요. 인증이 설치 중에 뜨는 플러그인도 있고 처음 사용할 때 뜨는 플러그인도 있어요.

예를 들어 회사 Drive를 보려는데 개인 계정으로 연결했다면 기대한 파일이 안 보일 수 있어요. 연결한 계정과 원래 서비스에서 그 파일을 읽을 권한이 있는지 확인해 주세요. 인증 파일이나 비밀번호를 대화에 붙여 넣기보다 제공되는 연결 절차를 사용해요.

새 작업에서 플러그인 이름과 찾을 대상을 함께 알려 주세요. 아래는 문서 서비스를 연결한 뒤 해 볼 수 있는 요청 예시예요. 괄호 안은 실제 플러그인 이름과 접근 가능한 문서 제목으로 바꿔 주세요.

[설치한 플러그인 이름]을 사용해서 [문서 제목]을 찾아 줘. 일치하는 문서의 제목과 링크를 먼저 보여 줘. 동일한 제목이 여러 개면 작성자나 폴더를 함께 알려 줘. 문서는 수정하지 말고, 찾지 못했다면 확인한 범위를 적어 줘.

결과의 링크를 열어 실제 문서가 맞는지 확인해요. 이름이 비슷한 문서를 고르지 않았는지, 읽을 수 없었던 자료를 읽은 것처럼 요약하지 않았는지도 살펴봐 주세요. 이 조회가 된 다음 요약이나 편집 요청으로 이어 가면 좋아요.

새 작업이나 CLI 세션을 시작했는지 확인하고, 플러그인이 설치·활성화된 상태인지 살펴봐요. 그다음 외부 연결의 인증 상태와 사용하는 화면의 지원 여부를 확인해 주세요.

API 키로 로그인하는 환경에서는 OAuth 연결 방식 때문에 사용할 수 없는 플러그인도 있어요. 회사 계정이라면 관리자 정책으로 설치나 기능 사용이 제한될 수도 있어요. 같은 플러그인을 반복 설치하기보다 현재 계정과 환경에서 지원되는지 먼저 확인해 보세요.

CLI 플러그인 목록에서는 설치한 항목에 Space를 눌러 켜거나 끌 수 있어요. 제거하려면 지원되는 관리 화면에서 Uninstall plugin을 선택해요. 관리자가 설치한 기본 플러그인은 사용자가 제거할 수 없는 경우도 있어요.

플러그인을 제거해도 별도로 연결된 MCP 통합은 남을 수 있어요. 외부 서비스 접근까지 끝내고 싶다면 연결 관리에서 계정 연결도 해제됐는지 확인해 주세요. 잠시 도구를 안 쓰려는 것인지, 계정 접근도 끊으려는 것인지에 맞춰 처리하면 돼요.