Codex の設定

最終更新: 2026年7月10日

Codex はターミナルで動作するコーディングエージェントです。ここに WEEGLOO MCP サーバーを接続すると、Codex が Content TypeContentMedia といったリソースを直接作成・読み取り・編集できるようになります。接続方法はほかの環境と同じです。インストールツールで一度に設定したあと、Codex で認証を済ませるだけです。

MCP そのものやサーバーグループ、ファイルアップロードサーバーについては MCP で扱います。このページでは Codex に接続する手順だけを扱います。

事前準備

以下のインストールコマンドを実行するには Node.js が必要です。まず、次のコマンドでインストールされているか、バージョンが 18 以上かを確認してください。

ターミナル
node --version # v18 以降なら OK npx --version # バージョンが表示されれば OK

Node.js はインストールされているのに npx がインストールされていない場合は、以下のコマンドで npm を最新バージョンに更新してください。npm を更新すると npx も一緒にインストールされます。

ターミナル
npm install -g npm@latest

Node.js がインストールされていない場合、またはバージョンが古い場合は、使用しているオペレーティングシステムに合った方法で Node.js をインストールしてください。

ターミナル
brew install node

Homebrew がない場合は、まず brew.sh からインストールするか、nodejs.org から Node.js を直接ダウンロードしてください。

Codex も、ターミナルで codex コマンドから実行できるようインストールされている必要があります。まだない場合は Codex CLI のインストール手順 を参照してください。

接続する

インストール先を選び、次のガイドに従って進めてください。1 つのプロジェクトだけに接続するには プロジェクト を、すべてのプロジェクトで使うには グローバル を選びます。

1

MCP・Skills をインストール

インストールコマンドをコピーして、ターミナルで実行してください。

ターミナル
$ npx weegloo@latest -y \ --agent codex \ --token wgl_••••••••••••
2

MCP を認証

以下の順に認証してください。

  1. 1.ターミナルで下のコマンドを実行すると、ブラウザに WEEGLOO 認証ページが開きます。
    ターミナル
    codex mcp login weegloo
  2. 2.開いた WEEGLOO 認証ページに、下の トークンをコピー ボタンでコピーしたトークンを貼り付け、サーバーに接続 を押します。 認証後、すでに起動している場合はエージェントを再起動してください。

設定ファイルを直接確認する

インストールツールが設定ファイルを自動的に作成・管理するため、ユーザーが直接確認する必要はありません。以下の内容は、具体的な設定ファイルの構造やパスが必要なユーザー向けの参考資料です。

weegloo サーバーは HTTP 方式で https://ai.weegloo.com/mcp に接続し、ファイルを扱う weegloo-upload サーバーは npx で実行され、認証に Personal Access Token を使います。グローバル でインストールするとユーザーのホームの ~/.codex/config.toml に、プロジェクト でインストールするとプロジェクトフォルダ内の .codex/config.toml に登録されます。

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"
 
[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>"

サーバーグループを変更するには、weegloo サーバーの url の末尾に group の値を付けます。たとえばすべてのツールを使うには https://ai.weegloo.com/mcp?group=all と書きます。グループごとのツール構成は MCP サーバーグループ を参照してください。

プロジェクト でインストールすると、インストールツールはユーザーのホームの ~/.codex/config.toml にも項目を 1 つ追加します。Codex は信頼したプロジェクトでのみ、そのフォルダ内の .codex/config.toml を読み込みます。この項目がないと、登録したばかりの MCP サーバーが無視されるため、インストールツールが対象のプロジェクトを信頼済みとして登録しておきます。パスの部分には、インストールを実行したプロジェクトフォルダの実際のパスが入ります。

[projects."/Users/jimin/projects/jeju-shop"]
trust_level = "trusted"

次にすること

  • MCP: サーバーグループやファイルアップロードサーバーなど、接続の土台となる内容を扱います。
  • Skills と Rules: インストールツールが一緒にインストールする Skills と Rules が何かを扱います。
  • AI で静的ページを移行する: 接続した MCP で実際のページをコンテンツベースのサービスへ移す流れをたどります。