Codex 설정

최종 수정: 2026년 6월 22일

Codex에서 WEEGLOO MCP 서버를 연결하는 방법을 다룹니다. 연결하면 Codex가 WEEGLOO의 리소스를 직접 조회하고 만들고 수정할 수 있습니다. 전체 흐름과 서버 그룹·파일 업로드 서버는 MCP에서 다룹니다. 이 페이지는 Codex에 한정한 연결 단계만 설명합니다.

준비물

연결하기 전에 다음을 갖춰야 합니다.

  • Codex: Codex가 설치되어 있어야 합니다.
  • Node.js 18 이상: 설치 도구와 파일 전송용 서버(weegloo-upload)를 실행하는 데 필요합니다. Node.js 다운로드에서 받을 수 있습니다.
  • Personal Access Token: 인증에 씁니다. Personal Access Token은 계정이 자기 권한으로 API를 호출할 때 쓰는 열쇠입니다. 발급 방법은 Personal Access Token 발급하기에서 다룹니다.

설치 도구로 연결하기

설치 도구를 쓰면 Codex 설정 파일에 MCP 서버가 자동으로 등록됩니다. 프로젝트 폴더에서 다음을 실행합니다.

npx weegloo@latest

실행하면 차례로 묻습니다. 각 질문의 뜻은 다음과 같습니다.

  1. Select plugin version (branch): Skills와 Rules의 버전을 고릅니다. 보통 latest를 고릅니다.
  2. Select your IDE: Codex를 고릅니다.
  3. What would you like to install?: MCP 서버와 Skills / Rules를 따로 설치할 수 있습니다. 처음 설치한다면 전부 설치합니다.
  4. Enter your Weegloo Personal Access Token: 미리 발급해 둔 Personal Access Token을 입력합니다.
  5. Select the MCP server group: 일반적인 용도라면 default를 고릅니다. 서버 그룹의 종류는 MCP에서 다룹니다.
  6. Where would you like to install Codex configuration: 현재 프로젝트에만 적용하려면 Project, 모든 프로젝트에 적용하려면 Global을 고릅니다. Codex 버전에 따라 Project 설치가 지원되지 않을 수 있고, 그때는 Global로 설치합니다.

설치가 끝나면 설정 도구가 MCP 서버를 Codex 설정 파일(config.toml)에 등록합니다. Global로 설치하면 ~/.codex/config.toml에, Project로 설치하면 프로젝트의 Codex 설정 파일에 등록됩니다.

MCP 서버에 로그인하기

weegloo 서버는 HTTP 방식으로 연결하며, 설치와 별도로 한 번 로그인해야 합니다. 설치 도구가 이 로그인 단계를 이어서 실행합니다. 자동으로 실행되지 않으면 다음을 직접 실행합니다.

codex mcp login weegloo

실행하면 브라우저에서 인증 페이지가 열립니다. 인증을 마치면 weegloo 서버 연결이 완료됩니다. 파일 전송용 weegloo-upload 서버는 설정 파일에 넣은 Personal Access Token으로 인증하므로 이 로그인 단계가 필요 없습니다.

설정 파일을 직접 편집하기

설치 도구 대신 Codex 설정 파일(config.toml)을 직접 편집해도 됩니다. weegloo 서버는 HTTP 방식으로 연결합니다.

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"

서버 그룹을 지정하려면 주소 끝에 group 값을 붙입니다. 예를 들어 모든 도구를 쓰려면 다음과 같이 적습니다.

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp?group=all"

파일 전송용 weegloo-upload 서버는 명령으로 실행하며, 인증에는 Personal Access Token을 씁니다. 토큰 자리에는 발급받은 Personal Access Token을 넣습니다.

[mcp_servers.weegloo-upload]
command = "npx"
args = ["-y", "weegloo-upload"]
 
[mcp_servers.weegloo-upload.env]
UPLOAD_API_URL = "https://upload.weegloo.com/v1"
AUTH_BEARER_TOKEN = "<Personal Access Token>"

설정 파일을 직접 편집했다면 Codex를 다시 시작합니다. 이후 weegloo 서버는 위의 MCP 서버에 로그인하기 단계로 한 번 로그인합니다.

다음으로 할 일

  • MCP: 서버 그룹·파일 업로드 서버 등 연결의 전체 그림을 다룹니다.
  • Skills와 Rules: 설치 도구가 함께 깔 수 있는 Skills와 Rules를 다룹니다.
  • AI로 정적 페이지 옮겨오기: 연결한 MCP로 실제 페이지를 콘텐츠 기반 서비스로 옮기는 흐름을 따라갑니다.