codexでgithub-mcp-serverを直接使う

codexにStreamable HTTPなMCP Serverに対するサポートが追加されたのでそれを使ってこれまで直接使えなかったGitHub公式のMCP Serverを使う設定を追加。

experimental_use_rmcp_client
GitHub公式MCP Serverをcodexで直接使う
OAuthがうまく行かない
experimental_use_rmcp_clientの設定がなかったときの設定
まとめ

experimental_use_rmcp_client

Streamable HTTP

experimental_use_rmcp_clientというオプションが追加されていて、これをtrueにすると Streamable HTTPなMCP Serverを使えるようになります。

GitHub公式MCP Serverをcodexで直接使う

github/github-mcp-server: GitHub’s official MCP Server

これまではこれをcodexで直接使うことは出来ず、 mcp-proxy などを使った方法が紹介されていました。

これをexperimental_use_rmcp_clientを使うと

~/.codex/config.toml

experimental_use_rmcp_client = true

[mcp_servers.github-mcp-server]
url = "https://api.githubcopilot.com/mcp"
bearer_token_env_var = "GITHUB_MCP_API_TOKEN"

と設定を書くだけで使えるようになります。

ここで、GITHUB_MCP_API_TOKENはGitHubのPersonal Access Tokenを格納した環境変数の名前で、その環境変数をcodexが中で解釈している形になります。

$GITHUB_MCP_API_TOKENと変数展開の形では書かずに直接変数名だけ書きます。このことから分かるように、文字列であるTOKENを直接設定ファイルに書くことは出来ず、環境変数に入れておく必要があります。

これでcodexを起動して/mcpコマンドを実行すると

  • Server: github-mcp-server
    • Status: enabled
    • Auth: Bearer token
    • URL: https://api.githubcopilot.com/mcp
    • Tools: add_comment_to_pending_review, add_issue_comment, add_sub_issue, assign_copilot_to_issue,
create_and_submit_pull_request_review, create_branch, create_issue, create_or_update_file,
create_pending_pull_request_review, create_pull_request, create_repository, delete_file,
delete_pending_pull_request_review, fork_repository, get_commit, get_file_contents, get_issue, get_issue_comments,
get_label, get_latest_release, get_me, get_release_by_tag, get_tag, get_team_members, get_teams, list_branches,
list_commits, list_issue_types, list_issues, list_label, list_pull_requests, list_releases, list_sub_issues, list_tags,
merge_pull_request, pull_request_read, push_files, remove_sub_issue, reprioritize_sub_issue, request_copilot_review,
search_code, search_issues, search_pull_requests, search_repositories, search_users, submit_pending_pull_request_review,
update_issue, update_pull_request, update_pull_request_branch

のような感じで確認でき、適当なレポジトリでcodexを起動して、 現在openなIssueを一覧表示してなどと入力するとIssueの一覧が表示されます。

OAuthがうまく行かない

bearer_token_env_varを設定しておかないと、

■ MCP client for `github-mcp-server` failed to start: handshaking with MCP server failed: Send message error Transport
[rmcp::transport::worker::WorkerTransport<rmcp::transport::streamable_http_client::StreamableHttpClientWorker<reqwest::as
ync_impl::client::Client>>] error: Auth required, when send initialize request

見たい感じでgithub-mcp-serverの起動に失敗します。

github-mcp-serverはOAuthでの認証もサポートしていて、 codexでは

$ codex mcp login github-mcp-server

とすることでOAuth認証を行うことも出来るようですが、やってみると

$ codex mcp login github-mcp-server
Dynamic registration failed: Registration failed: HTTP 404 Not Found: 404 page not found

Authorize `github-mcp-server` by opening this URL in your browser:
https://api.githubcopilot.com/authorize?response_type=code&client_id=mcp-client&state=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&code_challenge_method=S256&redirect_uri=http%3A%2F%2F127.0.0.1%3A46863%2Fcallback

のようになってうまくいかない状態。

experimental_use_rmcp_clientの設定がなかったときの設定

以前は以下のような設定が紹介されていました。

~/.codex/config.toml

[mcp_servers.github-mcp-server]
command = "mcp-proxy"
args = [
  "--transport", "streamablehttp",
  "-H", "Authorization", "Bearer <TOKEN>",
  "https://api.githubcopilot.com/mcp/",
]

ここでは<TOKEN>の部分には直接TOKENを書く必要があります。

これで上と同じように使えはするのですが、これだとTOKENを直接設定ファイルに書く必要があります。 mcp-proxyでは認証部分を

~/.codex/config.toml

[mcp_servers.github-mcp-server]
command = "mcp-proxy"
args = [
  "--transport", "streamablehttp",
  "https://api.githubcopilot.com/mcp/",
]
env = { API_ACCESS_TOKEN = "<TOKEN>" }