0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@kai_kou(甲斐 甲)

OpenAI Codex Plugins入門 — Skills・Apps・MCPをバンドルし開発チームを統一する

0
Last updated at Posted at 2026-03-28

はじめに

2026年3月26日、OpenAIはCodexにプラグインシステムを正式リリースした。20以上のプラグインが一挙提供され、Slack・Figma・Google Driveといった開発現場で使われるツールとの連携が簡単にできるようになった。

Codex Pluginsの核心は「再利用可能なワークフローのバンドル化」だ。スキル（Skills）・アプリ連携（Apps）・MCPサーバー（MCP Servers）を1つのプラグインにまとめ、チーム全員のCodex設定を一括で同期できる。

この記事では以下を学べる:

  • Codex Pluginsの3コンポーネント（Skills・Apps・MCP Servers）の仕組み
  • 公式プラグインディレクトリの使い方
  • カスタムプラグインを自分で作成・配布する方法
  • チームでプラグインを共有するマーケットプレース戦略

対象読者

  • OpenAI Codexを日常的に使う開発者
  • チーム内でAIワークフローを標準化したいエンジニア
  • MCP対応のカスタムツールをCodexから活用したいエンジニア

前提環境

  • Codex app または Codex CLI がインストール済み
  • OpenAIアカウント（Pro/Teamプラン推奨）

TL;DR

  • Codex Pluginsは Skills・Apps・MCP Serverを1バンドルにしてインストールできる仕組み
  • 2026-03-26時点で Box・Figma・Slack・Gmail・Notion 等20以上が公式提供
  • カスタムプラグインは $plugin-creator スキルで数分で自動スキャフォールド
  • リポジトリ単位・個人単位の2種のローカルマーケットプレースで社内配布が可能

Codex Pluginsとは

Codex Pluginsは、再利用可能なCodexワークフローのインストール可能なバンドルだ。

従来、チームでCodexを共通設定するには、各メンバーが個別にMCPサーバーを設定し、カスタムインストラクションを追加する必要があった。プラグインはこの手間を解消し、1回のインストールで全員の設定を揃えられる。

Plugins make it relatively simple to sync a Codex configuration across multiple developers' OpenAI accounts.
— SiliconANGLE（2026-03-27）

プラグインはCodex app・CLI・VS Code拡張の3つのクライアントで利用できる。

3コンポーネントの仕組み

Codex Pluginsは以下の3コンポーネントを組み合わせて構成される。

1. Skills（スキル）

スキルは、特定のタスクを自動化するためのワークフロー定義だ。Markdownファイルで記述し、Codexが必要に応じて段階的に読み込む仕組みになっている。

skills/
  my-skill/
    SKILL.md

SKILL.md の基本フォーマット:

---
name: hello
description: Greet the user with a friendly message.
---

Greet the user warmly and ask how you can help.

フロントマターに name（識別子）と description（Codexが自動選択するための説明）を記載する。本文にはCodexへの指示を記述する。

スキルは段階的ディスカバリーの仕組みを持つ。Codexはまずメタデータ（名前・説明・ファイルパス）だけを読み込み、そのスキルを使うと判断した時だけ SKILL.md 本文を読み込む。コンテキスト使用量を効率化するための設計だ。

2. Apps（アプリ連携）

Appsは、外部ツールとのコネクター設定をプラグインにパッケージングする仕組みだ。.app.json ファイルで定義する。

現在公式提供されているアプリ連携の例:

サービス 連携できること
Google Drive Docs・Sheets・Slidesへのアクセス・編集
Figma デザインファイルの読み取り・コード実装との対応
Slack チャンネルの読み取り・プランニング情報の参照
Gmail メールスレッドの要約・返信草稿
Notion ドキュメントの読み取り・ページ作成
Linear Issueの一覧・更新
Sentry エラーの参照・デバッグ補助
Box ファイルアクセス・ドキュメント管理
Hugging Face モデル情報・データセット参照
Cloudflare Workersデプロイ・KV操作

3. MCP Servers（MCPサーバー）

MCP Serverは、Codexにリモートツールや共有コンテキストを提供する仕組みだ。.mcp.json ファイルで設定する。

Codexは以下の2種類のMCPサーバーをサポートする:

  • STDIOサーバー: ローカルプロセスとして起動するサーバー
  • Streamable HTTPサーバー: URLでアクセスするリモートサーバー

~/.codex/config.toml での設定例:

[plugins."sentry@openai-curated"]
enabled = true

[plugins."gmail@openai-curated"]
enabled = false  # 無効化（アンインストールせずに一時停止）

プラグインのインストール方法

UIからのインストール（Codex app）

  1. Codex appのサイドバーから Plugins セクションを開く
  2. 使いたいプラグインを選択して Install をクリック
  3. 外部アプリの認証が必要な場合は画面の指示に従う（一部は初回使用時まで延期可能）
  4. 新しいスレッドを開始し、プラグインを呼び出す

CLIからのインストール

Codex CLIでは /plugins コマンドでプラグインディレクトリを開き、インストールできる。

# Codex CLIを起動
codex

# プラグインディレクトリを開く
/plugins

プラグインの呼び出し方

インストール後、2通りの方法でプラグインを使える:

方法1: 自然言語（推奨）

今日の未読Gmailスレッドを要約して

方法2: @ での明示指定

@gmail 先週のスレッドでスプリントに関係するものをまとめて

インストール済みプラグインはCodex app・CLI・VS Code拡張で共有される。一度設定すれば、どのクライアントでも同じプラグインが使える。

カスタムプラグインの作成

公式プラグイン以外に、自分でカスタムプラグインを作成して社内配布できる。

ステップ1: $plugin-creator でスキャフォールド

最速のセットアップ方法は、Codexの組み込みスキル $plugin-creator を使うことだ。

$plugin-creator を使って、コードレビューワークフローのプラグインを作成して

$plugin-creator は以下を自動生成する:

  • .codex-plugin/plugin.json マニフェスト
  • skills/ ディレクトリとサンプル SKILL.md
  • ローカルマーケットプレースエントリー（テスト用）

ステップ2: プラグイン構造を確認・カスタマイズ

my-plugin/
├── .codex-plugin/
│   └── plugin.json        # 必須マニフェスト
├── skills/
│   └── code-review/
│       └── SKILL.md       # カスタムスキル
├── .app.json              # アプリ連携設定（任意）
├── .mcp.json              # MCPサーバー設定（任意）
└── assets/
    ├── icon.png
    └── logo.png

ステップ3: plugin.json マニフェストを設定

最小構成（必須フィールドは name・version・description の3つのみ）:

{
  "name": "code-review",
  "version": "1.0.0",
  "description": "Code review workflow for the team"
}

フルマニフェスト（チーム配布向け）:

{
  "name": "code-review",
  "version": "1.0.0",
  "description": "Bundle reusable code review skills and GitHub integration.",
  "author": {"name": "Your Team", "email": "team@example.com"},
  "homepage": "https://github.com/your-org/codex-plugins",
  "repository": "https://github.com/your-org/codex-plugins",
  "license": "MIT",
  "keywords": ["code-review", "github", "pr"],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "apps": "./.app.json",
  "interface": {
    "displayName": "Code Review",
    "shortDescription": "コードレビューを効率化するチームプラグイン",
    "category": "Development",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/logo.png"
  }
}

ステップ4: スキルを記述する

skills/code-review/SKILL.md の例:

---
name: code-review
description: PRのコードレビューを実行し、品質チェックと改善提案を行う。
---

# コードレビュースキル

以下の観点でコードをレビューしてください:

1. **バグリスク**: 明らかなバグや例外処理の漏れ
2. **パフォーマンス**: N+1クエリ、不要なループ
3. **セキュリティ**: SQLインジェクション、XSS、認証漏れ
4. **可読性**: 変数名、コメント、関数の責務分離

レビュー結果は以下の形式で出力してください:
- 🔴 Critical: 即時修正が必要
- 🟡 Warning: 改善推奨
- 🟢 Info: 軽微な提案

チームでのプラグイン共有（マーケットプレース）

Codexは3種類のマーケットプレースからプラグインを読み込む。

種別 ファイルパス 用途
公式ディレクトリ OpenAI管理 公式20+プラグイン
リポジトリスコープ $REPO_ROOT/.agents/plugins/marketplace.json プロジェクト固有のプラグイン強制配布
個人スコープ ~/.agents/plugins/marketplace.json 個人の追加プラグイン

リポジトリスコープのマーケットプレース設定

プロジェクトのルートに以下のファイルを作成する:

$REPO_ROOT/.agents/plugins/marketplace.json:

{
  "name": "local-repo",
  "plugins": [
    {
      "name": "code-review",
      "source": {
        "source": "local",
        "path": "./plugins/code-review"
      },
      "policy": {
        "installation": "INSTALLED_BY_DEFAULT",
        "authentication": "ON_INSTALL"
      },
      "category": "Development"
    }
  ]
}

installation ポリシーの選択肢:

値 意味
AVAILABLE ディレクトリに表示、手動インストール
INSTALLED_BY_DEFAULT チームメンバーがリポジトリを開いた時に自動インストール
NOT_AVAILABLE 非表示（一時無効化等に使用）

プラグインのディレクトリ配置

$REPO_ROOT/
├── .agents/
│   └── plugins/
│       └── marketplace.json   # マーケットプレース定義
└── plugins/
    └── code-review/
        ├── .codex-plugin/
        │   └── plugin.json
        └── skills/
            └── code-review/
                └── SKILL.md

インストール済みプラグインは ~/.codex/plugins/cache/$MARKETPLACE_NAME/$PLUGIN_NAME/$VERSION/ にキャッシュされる。ローカルプラグインの場合、$VERSION は local になる。

活用パターン

パターン1: デザイン→コード変換の自動化

Figmaプラグインを使えば、Codexがデザインファイルを直接参照できる。

Figmaの「Button Component」セクションをReactコンポーネントに実装して

Codexはデザインファイルから色・サイズ・バリアントを読み取り、型安全なReactコンポーネントを生成する。デザイン↔実装間のコンテキストスイッチが不要になる。

パターン2: バグ調査の自動化

Sentryプラグインを使えば、エラーからコード修正までを一連の流れで処理できる。

Sentryで直近24時間に5回以上発生したエラーを調査して、修正PRを作成して

パターン3: スプリント計画の補助

Slackプラグイン + Linearプラグインを組み合わせると、Slackの議論からLinear Issueを自動作成できる。

今週の #product チャンネルの議論をもとに、来週のスプリントバックログを提案して

パターン4: チームオンボーディングの高速化

INSTALLED_BY_DEFAULT ポリシーを使えば、新メンバーがリポジトリをクローンしてCodexを開いた瞬間に、チームの標準プラグインが自動インストールされる。

注意点

セキュリティ

プラグインを使用する際も、Codexの既存の承認設定（approval settings）が引き続き適用される。外部サービスはそれぞれの認証ポリシーで管理される。

ローカルマーケットプレースを使う場合、プラグインの読み込みは信頼済みプロジェクト（trusted projects）のみに制限される。

現在の制限

  • 公式プラグインディレクトリへのセルフ登録は Coming Soon（2026-03-27時点）
  • MCP OAuth フローのカスタムコールバックURLは ~/.codex/config.toml の mcp_oauth_callback_url で設定可能

まとめ

OpenAI Codex Pluginsの要点をまとめる:

  • 3コンポーネント: Skills（ワークフロー）・Apps（ツール連携）・MCP Servers（リモートツール）を1バンドルに
  • 20以上の公式プラグイン: Figma・Slack・Gmail・Notion・Linearなど即使い始められる
  • カスタムプラグイン: $plugin-creator で数分でスキャフォールド、plugin.json で設定
  • チーム配布: リポジトリスコープのマーケットプレースで INSTALLED_BY_DEFAULT 設定するとオンボーディングが自動化
  • 設定管理: ~/.codex/config.toml でプラグインの有効・無効を制御

Codex Pluginsは、個人のAIワークフロー自動化からチーム全体のCodex設定標準化まで、幅広いユースケースに対応する強力な拡張機能だ。まず公式プラグインを試し、次に自分たちのワークフローをプラグイン化してチームに配布することから始めてみよう。

参考リンク

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?