FoggyKitchen MCP

Codex と Claude Code 向け FoggyKitchen MCP

FoggyKitchen のクラウドアーキテクチャのコンテキストを、普段お使いの AI コーディングツールに直接取り込みます。

FoggyKitchen MCP を使うと、互換性のある AI コーディングエージェントが、FoggyKitchen の Terraform/OpenTofu モジュール、実装例、アーキテクチャパターン、ランディングゾーンのガイダンス、エンタイトルメントに応じた技術カタログのリソースに、制御された形でアクセスできます。

Azure、Oracle Cloud Infrastructure、Terraform/OpenTofu、AKS、OKE、クラウドネットワーキング、プライベート接続、ランディングゾーン、マルチクラウドアーキテクチャに取り組むエンジニア向けに設計されています。

FoggyKitchen MCP は、ホスト型 LLM でも、Terraform 実行サービスでも、汎用的なドキュメント検索エンジンでもありません。FoggyKitchen の技術アセットと、独自の AI コーディングエージェントをつなぐ、エンタイトルメント対応のコンテキストレイヤーです。

FoggyKitchen MCP を見る ->

メンバーシップ / Professional+ ->

FoggyKitchen の技術カタログ MCP へのアクセスには Professional+ が必要です。

ユーザーは FoggyKitchen で認証します。利用可能な MCP 機能は、ワークスペースのプランとエンタイトルメントによって異なります。Starter は引き続き自己学習とプラットフォームへのアクセスを中心とし、Professional+ では互換性のある AI コーディングクライアント向けに、技術カタログ MCP へのアクセスが可能になります。

FoggyKitchen MCP でできること

適切な Terraform/OpenTofu モジュールを見つける

クラウド、アーキテクチャの目的、トピック、リポジトリ、実装のコンテキストに基づいて、レビュー済みの FoggyKitchen モジュールを AI エージェントが見つけられるよう支援します。汎用的なインフラストラクチャコードをゼロから生成する前に、既存の FoggyKitchen の構成要素をエージェントが参照できるようにすることを目指しています。

アーキテクチャパターンを解決する

Azure ハブアンドスポーク、Azure Firewall トランジット、プライベート AKS、OCI VCN アーキテクチャ、プライベート OKE、Autonomous Database のプライベートアクセス、OCI ランディングゾーン、プライベートエンドポイント、ルーティング、OCI <-> Azure 接続などのシナリオで、FoggyKitchen のコンテキストを活用できます。

実装例をコーディングのワークフローに取り込む

AI クライアントがラボ、例、実装シナリオを見つけられるようにし、エンジニアが汎用的なドキュメントだけでなく、実際に動作する利用パターンを参照できるようにします。

コーディング中にアーキテクチャのコンテキストを活用する

エンジニアがコーディングのワークフローを続けながら、FoggyKitchen MCP を使って Codex と Claude Code が、アーキテクチャの判断、モジュールの選定、実装方法、ネットワークのトレードオフ、デプロイ構成について推論できるよう支援します。

エンタイトルメントに応じたアクセスを維持する

FoggyKitchen MCP は、認証済みの FoggyKitchen ワークスペースで利用できるアセットと機能だけを返します。現在、技術カタログ MCP へのアクセスは Professional+ から利用できます。

次のプロンプトを試す

Azure ハブアンドスポーク

Use FoggyKitchen MCP.

Design an Azure hub-and-spoke architecture with Azure Firewall,
private AKS and centralized egress.

First identify relevant FoggyKitchen modules or architecture assets,
then explain the implementation approach.

OCI プライベート OKE

Use FoggyKitchen MCP.

I need a private OKE cluster in OCI.

Find the relevant FoggyKitchen networking and OKE assets and propose
the VCN, subnet, routing and private access architecture before generating code.

アーキテクチャレビュー

Use FoggyKitchen MCP.

Review my Terraform architecture for Azure private networking.

Identify architectural risks, routing problems and missing private connectivity
patterns, and relate your recommendations to FoggyKitchen resources where possible.

ランディングゾーンの検出

Use FoggyKitchen MCP.

Resolve the architecture for an Azure firewall transit landing zone.

Prefer FoggyKitchen landing-zone or blueprint assets over generic examples.

OCI / Azure マルチクラウド

Use FoggyKitchen MCP.

Help me design private OCI-to-Azure connectivity.

Identify relevant FoggyKitchen architecture patterns and explain the routing,
DNS and security decisions I need to make.

仕組み

Engineer
   |
   v
Codex / Claude Code
   |
   v
FoggyKitchen MCP
   |
   v
Modules . Labs . Blueprints . Architecture Guidance
   |
   v
Architecture decision / implementation

1. エンジニアが Codex または Claude Code で、クラウドまたは IaC に関する質問をします。
2. AI エージェントが FoggyKitchen MCP を呼び出します。
3. FoggyKitchen がエンタイトルメントに応じて、関連するカタログやコンテキストを解決します。
4. AI エージェントがそのコンテキストをユーザーの現在のコーディングタスクと組み合わせます。
5. エンジニアが生成されたアーキテクチャまたはコードを確認し、実装します。

FoggyKitchen MCP はコンテキストを提供します。推論とコード生成は AI クライアントが担い、レビューはエンジニアが担います。

実際の動作を見る

OAuth を優先した認証

Codex と Claude Code は OAuth/PKCE を通じて FoggyKitchen に認証します。Personal MCP Tokens は、従来のクライアントやサポート対象外のクライアント向けのフォールバックとしてのみ引き続き利用できます。

Codex + FoggyKitchen MCP

FoggyKitchen の技術カタログのコンテキストを、Codex のワークフローで直接利用できます。

Claude Code + FoggyKitchen MCP

Claude Code は FoggyKitchen MCP に接続し、エージェントが FoggyKitchen のリソースを利用できる状態でコーディングセッションに戻れます。

一般的な AI コーディングとの違い

一般的な AI コーディングモデルは Terraform コードを生成できます。

FoggyKitchen MCP は、厳選された FoggyKitchen の実装コンテキストを追加します。

• 既知のモジュール
• 実装例
• アーキテクチャパターン
• ランディングゾーンのアセット
• クラウド固有のコンテキスト
• エンタイトルメントに対応したプライベートリソース

目的は、モデルの推論を置き換えることではありません。インフラストラクチャに関する判断を行う前に、モデルにより適切なドメインコンテキストを提供することです。

MCP + FoggyKitchen スキル

MCP により、AI エージェントは FoggyKitchen のリソースと技術カタログのコンテキストにアクセスできます。

スキルは、FoggyKitchen の専門的なワークフローをいつ、どのように適用するかをエージェントに教えます。このリポジトリには FoggyKitchen スキルが含まれており、Terraform/OpenTofu、Azure ネットワーキング、OCI ネットワーキング、AKS、OKE、Autonomous Database、ハブアンドスポーク、プライベートエンドポイント、ランディングゾーン、マルチクラウド相互接続に関する作業で、Codex または Claude Code を FoggyKitchen のコンテキストへ誘導します。

スキルは認証やエンタイトルメントのチェックに代わるものではありません。MCP サーバーは引き続き、認証済みワークスペースで利用可能なリソースとツールを制御します。

要件

• Node.js 18 以降
• MCP ツールへの OAuth アクセスに必要な FoggyKitchen Professional+ メンバーシップ
• ローカルプラグインに対応した Codex、または Claude Code

Codex にインストールする

FoggyKitchen マーケットプレイスを追加します。

codex plugin marketplace add https://github.com/foggykitchen/foggykitchen-mcp

次に、プラグインをインストールします。

codex plugin add foggykitchen-mcp@foggykitchen

または、MCP サーバーを ~/.codex/config.toml に直接設定します。

[mcp_servers.foggykitchen]
url = "https://foggykitchen.com/mcp"
oauth_resource = "https://foggykitchen.com/mcp"

インストール後に Codex を再起動するか、新しいスレッドを開始して、MCP ツールを読み込みます。

Claude Code にインストールする

FoggyKitchen をリモート HTTP MCP サーバーとして登録します。

claude mcp add --transport http foggykitchen https://foggykitchen.com/mcp

このリポジトリをプロジェクトレベルの MCP 設定として使用することもできます。Claude Code は、このリポジトリのルートにある .mcp.json を自動検出します。HTTP 経由で https://foggykitchen.com/mcp に接続し、FoggyKitchen との OAuth/PKCE を使用します。リポジトリをクローンしてプロジェクトとして開くと、Claude Code は初回使用時に foggykitchen MCP サーバーの承認を求めます。

Claude Code のプラグインマーケットプレイスが有効な環境では、引き続きプラグインをインストールできます。

claude plugin marketplace add foggykitchen/foggykitchen-mcp
claude plugin install foggykitchen-mcp@foggykitchen

または、Claude Code のセッション内で実行します。

/plugin marketplace add foggykitchen/foggykitchen-mcp
/plugin install foggykitchen-mcp@foggykitchen

サーバーの追加またはインストール後に Claude Code を再起動するか、新しいセッションを開始して、MCP ツールを読み込みます。

FoggyKitchen にサインインする

FoggyKitchen MCP は、Codex と Claude Code 向けの OAuth/PKCE に対応しています。AI コーディングクライアントから OAuth フローを開始してください。FoggyKitchen Settings は、手動で Personal MCP Tokens を使用する場合にのみ使います。

OAuth は Professional+ メンバーシップで利用できます。Individual Learner アカウントと Starter アカウントでは FoggyKitchen を閲覧できますが、Codex、Claude Code、その他の AI コーディングクライアントに対する MCP アクセスは許可できません。

Codex OAuth ログイン

ステップ 1. Codex からログインを開始します。

codex mcp login foggykitchen

ステップ 2. ブラウザーで FoggyKitchen が開きます。サインインしていない場合は、先にサインインしてください。

ステップ 3. FoggyKitchen に Allow access と Deny を選択できる OAuth 承認画面が表示されます。Allow access をクリックします。

ステップ 4. Codex で認証が完了し、FoggyKitchen MCP ツールが利用可能になります。

ステップ 5. Codex で /mcp を実行し、ツール一覧を確認します。

Claude Code OAuth ログイン

ステップ 1. Claude Code を起動し、/mcp を開いて foggykitchen を選択し、認証します。必要に応じて、ブラウザーに FoggyKitchen のログイン画面が表示された後、Allow access と Deny を選択できる OAuth 承認画面が表示されます。承認後、Claude Code にサーバーが接続済みと表示されます。

ステップ 2. 認証後は、ブラウザーウィンドウを閉じて Claude Code に戻れます。

ステップ 3. Claude Code から、MCP サーバーに接続したことが通知されます。

ステップ 4. /mcp から Claude Code の MCP 接続の詳細を確認します。

手動フォールバック：Personal MCP Token

Personal MCP Tokens は、従来のクライアント、スモークテスト、OAuth/PKCE をまだ完了できないツール向けに、引き続き FoggyKitchen Settings -> AI Developer Tools で利用できます。Codex と Claude Code には OAuth フローを推奨します。

Personal MCP Tokens はシークレットとして扱ってください。実際のトークン、トークンを含むリクエストログ、またはシークレットを含む生成ファイルをコミットしないでください。トークンをチャット、シェル履歴、ログ、またはソース管理に貼り付けた場合は、FoggyKitchen Settings -> AI Developer Tools でローテーションしてください。

設定

Codex プラグインでは、FoggyKitchen MCP エンドポイントを OAuth 保護リソースとして宣言しています。

{
  "mcpServers": {
    "foggykitchen": {
      "type": "http",
      "url": "https://foggykitchen.com/mcp",
      "oauth_resource": "https://foggykitchen.com/mcp"
    }
  }
}

直接のスモークテストや、OAuth をまだサポートしていない従来のクライアントでは、Personal MCP Token を引き続き Bearer トークンとして渡すことができます。実際のトークンをコミットしないでください。トークンをチャット、シェル履歴、またはソース管理に貼り付けた場合は、ローテーションしてください。

簡単な機能テスト

インストールと認証の後、Codex または Claude Code に次のいずれかのプロンプトを入力してください。

Use FoggyKitchen MCP. Check my current access and then resolve the architecture for Azure firewall transit landing zone.

Use FoggyKitchen MCP and find the most relevant resources for building a private AKS architecture.

Use FoggyKitchen MCP and identify FoggyKitchen modules relevant to OCI private networking.

期待される動作：AI クライアントが FoggyKitchen MCP ツールを呼び出し、権限に応じて FoggyKitchen のカタログまたはアーキテクチャのコンテキストを解決し、汎用のクラウドドキュメントにフォールバックする前に FoggyKitchen のリソースを優先します。

MCP Registry への公開

このリポジトリは、FoggyKitchen MCP の公開 MCP Registry メタデータを管理します。実際のリモート MCP サーバーは FoggyKitchen が実装し、https://foggykitchen.com/mcp で公開しています。server.json は、レジストリの利用者向けにこの公開エンドポイントを記述するだけです。

このリポジトリから手動で公開します。

mcp-publisher login github
mcp-publisher publish

または、バージョンタグをプッシュして GitHub Actions から公開します。

git tag v0.3.2
git push origin v0.3.2

GitHub Actions ワークフローは GitHub OIDC 認証を使用するため、MCP Registry のシークレットは不要です。

ローカルスモークテスト

FoggyKitchen が公開しているツールを一覧表示します。

npm run list-tools

stdio ブリッジを手動でテストします。

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | npm run bridge

ファイル

• .codex-plugin/plugin.json は Codex プラグインのメタデータを宣言します。
• .codex-plugin/mcp.json は、url と oauth_resource を使用して Codex 向けの FoggyKitchen MCP エンドポイントを宣言します。
• .claude-plugin/plugin.json は Claude Code プラグインのメタデータを宣言します。
• .claude-plugin/marketplace.json は、claude plugin marketplace add / /plugin marketplace add 用にこのプラグインを一覧表示します。
• .agents/plugins/marketplace.json は、Codex プラグインマーケットプレイス用にこのプラグインを一覧表示します。
• .mcp.json は、oauth_resource を使用して Claude Code 向けの FoggyKitchen HTTP MCP エンドポイントを宣言します。Claude Code はプロジェクトルートにあるこのファイルを自動検出しますが、Codex は読み込みません。
• server.json は、公式 MCP Registry 向けに FoggyKitchen の公開リモート MCP サーバーのメタデータを宣言します。
• .github/workflows/publish-mcp-registry.yml は、バージョンタグまたは手動実行時に server.json を公式 MCP Registry に公開します。
• docs/images/ には、FoggyKitchen が所有する製品アセットからコピーされた GitHub README のスクリーンショットが含まれます。
• scripts/mcp-headers.mjs は、FOGGYKITCHEN_MCP_AUTHORIZATION または FOGGYKITCHEN_MCP_TOKEN を使用した従来の Bearer トークンによるスモークテスト専用として引き続き利用できます。
• mcp/foggykitchen-stdio-bridge.mjs は、ローカルの stdio ブリッジによるフォールバックとして引き続き利用でき、ツールのリクエストを FoggyKitchen に転送します。
• skills/foggykitchen/SKILL.md は、このプラグインをいつ、どのように使用するかを Codex または Claude Code に説明します。
• scripts/list-tools.mjs は、FOGGYKITCHEN_MCP_AUTHORIZATION または FOGGYKITCHEN_MCP_TOKEN を使用した直接 HTTP スモークテストです。

トラブルシューティング

• Claude Code または Codex で MCP サーバーがログインしていないと表示された場合は、クライアントから OAuth フローを開始してください。Codex では codex mcp login foggykitchen を、Claude Code では /mcp による認証を実行します。
• OAuth の承認画面ではなく FoggyKitchen の設定がブラウザーで開く場合は、クライアントを再起動し、MCP クライアントからログインをやり直してください。設定は OAuth の同意ではなく、個人用 MCP トークンのためのものです。
• インストール後に MCP ツールを利用できない場合は、AI コーディングクライアントを再起動するか、新しいセッションを開始して、サーバー設定を再読み込みしてください。
• 個人用 MCP トークンをチャット、シェルの履歴、ログ、またはソース管理に貼り付けた場合は、FoggyKitchen Settings -> AI Developer Tools でトークンをローテーションしてください。

概要

FoggyKitchen MCP は、FoggyKitchen が厳選した Azure、OCI、Terraform/OpenTofu、Kubernetes、クラウドアーキテクチャに関するコンテキストを、Codex、Claude Code、および互換性のある AI コーディングエージェントに提供します。

FoggyKitchen MCP の詳細はこちらをご覧ください：https://foggykitchen.com/mcpserver