CodexのMCP設定ガイド — 外部ツール連携のやり方・おすすめサーバー・安全に使う設定

MCPとは — AIと外部ツールをつなぐ共通規格

MCP（Model Context Protocol）は、AIをツールや情報源に接続するための共通規格です。「MCPサーバー」と呼ばれる接続部品を追加すると、Codexはそのツールを自分の道具として使えるようになります。たとえばブラウザ操作・Figmaのデザイン参照・GitHubのプルリクエスト管理・最新の開発者ドキュメント検索などが、依頼文の中で自然に使えるようになります。

人間の組織にたとえるなら、MCPサーバーの追加は「新しい社内システムのアカウントをスタッフに発行する」ことに近い操作です。道具が増えるほど任せられる仕事は広がりますが、後述のとおり何でも繋げばよいわけではない点が実務のポイントになります。

前提 — アプリ・CLI・IDE拡張で設定は共有される

CodexのMCP設定は config.toml という設定ファイル（標準では ~/.codex/config.toml）に保存され、デスクトップアプリ・CLI・IDE拡張が同じ設定を共有します。一度設定すれば、どの入り口からCodexを使っても同じ外部ツールに接続できます。プロジェクト単位で接続先を分けたい場合は、信頼済みプロジェクトに限り .codex/config.toml をプロジェクト側に置くこともできます。

接続のやり方 — コマンド1行から始める

基本: codex mcp add で追加する

最も簡単な追加方法は、ターミナルでの1行です。公式ドキュメントの例では、開発者向けドキュメント検索のContext7を次のように追加しています。

codex mcp add context7 -- npx -y @upstash/context7-mcp

追加済みのサーバーは codex mcp list で一覧でき、Codexの対話画面では /mcp で現在有効なサーバーを確認できます。OAuth認証が必要なサーバーは codex mcp login <サーバー名> でログインします。

細かく制御したい場合: config.toml を編集する

接続先ごとの詳細設定は、config.toml に [mcp_servers.<サーバー名>] のブロックを書いて行います。ローカルでコマンドとして起動するタイプ（STDIO）と、URLで接続するタイプ（Streamable HTTP）の両方に対応し、環境変数・認証（Bearer トークン／OAuth）・タイムアウトなどを指定できます。

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

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"

何を繋ぐか — 公式が挙げる代表例と選び方

公式ドキュメントが「よく使われる例」として挙げているのは次のようなサーバーです。

• OpenAI Docs MCP — OpenAIの開発者ドキュメントを検索・参照
• Context7 — 最新の開発者ドキュメントに接続
• GitHub — プルリクエストやIssueなど、gitコマンドを超えたGitHub操作
• Playwright / Chrome Developer Tools — ブラウザの操作・検証
• Figma — デザインデータへのアクセス
• Sentry — エラーログの参照

選び方の原則はシンプルで、「いま任せたい業務に必要な道具だけを繋ぐ」ことです。SNSで話題の「おすすめMCP」を手当たり次第に入れるのではなく、議事録業務ならカレンダーやドキュメント系、開発業務ならGitHubやブラウザ系——と、業務起点で1つずつ足していくのが、当社が研修でお伝えしている順番です。

安全に使う — 承認モードとツール許可リスト

外部ツールに触れるということは、Codexの行動範囲が自分のPCの外へ広がるということです。Codexには接続先ごとの統制機能が用意されており、業務利用では最初に押さえておくべきポイントです。

• 承認モード — サーバー単位・ツール単位で「自動実行してよいか、都度確認するか」を設定できます（auto／prompt／writes／approveの4段階。writesは書き込み系ツールだけ確認）
• ツール許可リスト — enabled_tools（使ってよいツールだけ列挙）と disabled_tools（禁止ツールを列挙）で、サーバーの機能の一部だけを開放できます
• 一時停止 — 使わない時期は enabled = false で、設定を消さずに無効化できます

見落としがちな注意点 — MCPは利用枠も消費する

MCPサーバーを接続すると、その道具の説明が毎回の依頼に文脈として追加されるため、接続数が多いほど1回あたりの利用枠の消費が増えます。公式ドキュメントも「使わないMCPサーバーは無効化する」ことを利用枠の節約術として挙げています。「繋いだまま使っていないサーバー」は、料金効率の面でも見直す価値があります（利用枠と節約術の全体はCodexの料金を参照）。

MCPは「仕組み化」の一部 — 全体像の中で考える

MCPで道具を増やすことは、AGENTS.mdでルールを教える・Skillsで手順を登録するといった仕組み化と組み合わさって初めて業務基盤になります。「どの業務に・どの道具と・どんなルールで」をセットで設計する考え方は、Codexの応用機能まとめとCodexの使い方 — 頼み方3つの型で解説しています。

組織導入では「接続先の統制」がセキュリティ設計そのもの

個人利用なら必要な道具を自分で足していけば十分ですが、組織では「誰が・どの外部ツールを・どの権限で繋いでよいか」の統制がセキュリティ設計の中心になります。認証情報の管理、書き込み権限の扱い、部署ごとの接続先の標準化——当社のCodex研修・導入伴走支援では、MCP連携を含む利用ガイドラインの整備までを一体でご支援しています。