[AI] Github 공식 mcp서버 전환

엄유상·2026년 1월 9일

ai

목록 보기
4/4

이전 작업

기존 codex의 toml설정파일에서 github mcp 공식 서버에 접속하는 명령어를 사용할 수 없어, go를 이용한 로컬 서버를 구동하여 사용하였다. 최근 윈도우에서 wsl을 이용해 codex를 설치하면서 docker를 이용해 접속할 수 있는 명령어를 발견하였다.
GitHub MCP 서버 사용방법 - ApiDog

적용

기존 config.toml

sandbox_mode = "danger-full-access"

model = "gpt-5.1-codex-max"
model_reasoning_effort = "xhigh"
model_reasoning_summary = "detailed"

[sandbox_workspace_write]
network_access = true

[projects."/Users/eomyoosang"]
trust_level = "trusted"

[projects."/Users/eomyoosang/Desktop/oauth2_practice"]
trust_level = "trusted"

[mcp_servers.figma]
command = "npx"
args = ["-y", "mcp-remote", "http://127.0.0.1:3845/mcp", "--transport", "http"]
enabled = true

[mcp_servers.figma.environment]
FIGMA_TOKEN = "${FIGMA_TOKEN}"

[mcp_servers.mobile-mcp]
command = "npx"
args = ["-y", "@mobilenext/mobile-mcp@latest"]
enabled = true

[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp"]

[mcp_servers.Context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp@latest"]

[mcp_servers.sequentialthinking]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]
disabled = false
autoApprove = []

[mcp_servers.notionApi]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]
env = { NOTION_TOKEN = "${NOTION_TOKEN}" }

[mcp_servers.github]
command = "/Users/eomyoosang/go/bin/github-mcp-server"
args = ["stdio"]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "${GITHUB_PERSONAL_ACCESS_TOKEN}" }

[notice]
"hide_gpt-5.1-codex-max_migration_prompt" = true

[notice.model_migrations]
"gpt-5.1-codex-max" = "gpt-5.2-codex"

이 중 아래 부분이 github mcp 설정이다.
이 외 부분은 이전 포스트를 참고하면 된다.
[AI] Codex CLI 사용기: 설치부터 MCP 설정까지 1

[mcp_servers.github]
command = "/Users/eomyoosang/go/bin/github-mcp-server"
args = ["stdio"]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "${GITHUB_PERSONAL_ACCESS_TOKEN}" }

github에 공개된 로컬 mcp 서버를 로컬에서 실행하였는데, go 설정 및 로컬 디바이스 상황에 따라 재구동을 해야하는 불편함이 있었다.

변경 후

command = "docker"
 "args"= [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "${GITHUB_PERSONAL_ACCESS_TOKEN}" }

명령어가 docker로 바뀌고, args 부분에 이것저것 추가되었다.
codex 실행 후 mcp연결을 확인한다.

마무리

GitHub MCP 서버 사용방법 - ApiDog
이 게시글에도 사용방법은 자세히 나와있다. 다만 claude등이 json을 사용하는 것과 달리 codex에서는 toml을 사용하다보니, toml 포맷에 맞게 수정하여 올려보았다.

profile
전역자의 개발log

0개의 댓글