Forge Engine

Forge Engine — MCP コネクター

多くのエージェント。ひとつの計画。混乱なし。

Forge Engine は、AI コーディングエージェントを活用してソフトウェアを開発するチームのための、生きた計画です。エージェントは MCP 経由で設計を読み取り、タスクを確保して作業が重複しないようにし、変更前に何が壊れるかを確認し、実際に構築したものを報告しながら並行して作業を進めます。計画は構造化されているため、コーダーであるかどうかにかかわらず、チームの誰もが読んで疑問を投げかけられます。Markdown ファイルで足りるのは開発者が 1 人の場合です。チームには Forge が必要です。

🌐 forgeengine.app

インストール不要で、実際の設計を 10 秒で確認できます。 Forge プロジェクトでは、設計全体をプレーンテキストで提供する公開リンクを 1 つ作成できます。それを AI チャットに貼り付ければ、アシスタントが 実際の設計に基づいて回答します。セットアップ不要で設計を読むをご覧ください。

このリポジトリについて。 これは Forge のMCP コネクターの公開リポジトリです。Forge Runtime CLI（@forgeengine/cli、MIT）の ソースと、レジストリマニフェスト（server.json）が含まれます。Forge アプリケーションとホスト型 MCP サーバーは、別の非公開リポジトリで開発されています。そのため、このリポジトリはお使いのマシン上で動作する部分です。トークンを保持する部分だからこそ、オープンに公開されています。セキュリティとプライバシーをご覧ください。

次のものと混同しないでください。 Laravel Forge（PHP サーバー管理）、Atlassian Forge / Autodesk Forge（アプリおよび CAD プラットフォーム）、SourceForge（ソフトウェアホスティング）、 Minecraft Forge（MOD ローダー）、ForgeCode、Plan Forge とは異なります。MCP と AI コーディングエージェントの文脈で「Forge」はForge Engine（forgeengine.app）を指します。

---

このツールが解決する課題

コーディングエージェントは高速ですが、記憶を保てません。セッションは毎回まっさらな状態から始まるため、同じコンテキストを何度も貼り直すことになります。3 セッション前の決定は忘れられ、気づかないうちに覆されます。自律実行が、誰も見ていない稼働中のシステムに手を入れることもあります。2 つ目のエージェントを追加したり、別の人がエージェントを操作したりすると、問題はさらに重なります。2 つのエージェントが同じモジュールを書き換えたり、最新だと思われていた仕様が、実際にリリースされたものとは違っていたと判明したり、計画のどの部分が実際に構築済みなのか誰も説明できなくなったりします。

文書を改善しても、こうした問題は解決しません。文書には、読まれたかどうかを知る方法も、「このシステムには手を触れてはいけない」と伝える方法も、コードが文書から逸脱したことに気づく方法もありません。Forge は、エージェントが計画とやり取りできるようにします。エージェントは構築前に計画を読み、担当する作業を確保し、変更した内容を報告します。こうした各ステップには、人間が確認できる証拠が残ります。

---

このループで実際に得られるもの

エージェントは、何も知らない状態ではなく、情報を得た状態から始められます。 1 回の呼び出しで、今取り組んでいるタスクに必要な作業コンテキストが得られます。このシステムの目的、触れてはいけないもの、何をもって「完了」とするか、ほかに誰がどこで作業しているかです。これにより、毎回セッションの冒頭で入力し直していた前置きが不要になります。そして、貼り付けた前置きとは異なり、どのエージェントも同じコンテキストを受け取るため、2 つのエージェントが異なる事実認識に基づいて作業することはありません。

並行作業が衝突しなくなります。 タスクは確保され、その確保状況はプロジェクトに参加しているほかのエージェントや人にも見えます。エージェントがすでに確保された作業に取りかかろうとすると、作業を始める前に、誰が担当しているかを名前付きで知らされます。両方のブランチができてからではありません。

知らないうちに変更が反映されることはありません。 エージェントが設計に加えたい変更はすべて、レビュー可能な提案として届きます。人間が採用するまで、現在の計画に変更は加えられません。削除にも同じ手順が適用されます。これは意図的な非対称性です。エージェントは何も適用できないため、自由に提案できます。そのため、安心して自由に提案させられます。

「これを変更すると何が壊れますか？」に答えられます。 システムには明示的な境界があり、実装ファイルとの対応関係も示されているため、自律的な実行を始める前に変更の範囲を特定できます。作業の後から説明する必要はありません。文章によるドキュメントだけでは、これはまったくできません。

「完了」は、証明して初めて認められます。 実装済みと報告されたシステムが 検証済み として記録されるのは、受け入れ基準のそれぞれが、名前の付いたテストによって裏付けられた場合だけです。また、テストを実際に実行して合格した場合に限り、保証済み として記録されます。それに満たないものはすべて、主張としてその旨を明記して保存され、裏付けのない基準は報告したエージェントに伝えられます。証明には有効期限もあるため、「かつて合格した」が「今も合格している」かのように見せかけることはできません。ほとんどのツールはエージェントの言葉をそのまま信じますが、緑色のダッシュボードが本当に意味を持つかどうかを判断するのが、この仕組みです。

設計とコード、両方の方向から乖離を検出します。 コードが設計から離れていくこともあります（システムの実装場所として示されたファイルがなくなっているなど）。そして、ほとんど誰も対処していないもう半分の問題、つまり動作中のコードの下で設計が変わることもあります。誰かが実装と承認の後に仕様を編集しても、バッジは一度も確認していないドキュメントとの整合性を示し続けます。Forge はどちらも検出し、ファイルを開こうとしているエージェントに通知します。わざわざ確認しようと思った人間にだけ知らせるのではありません。

「なぜそうなったか」は、人がいなくなっても残ります。 決定、却下、システムにまつわる経緯は、次のエージェントが読む場所に記録されます。提案が却下されたとき、次のエージェントは却下されたという事実を知るため、一週間後に何も知らずに同じ提案をし直すのではなく、作業を方針に沿わせることができます。

コーディングをしない人も、対等な参加者です。 プロデューサー、デザイナー、創業者はエージェントと同じ計画を読み、リポジトリに触れずに「これを追加できますか？」と尋ねられます。最初の計画からすぐに乖離し始める、人間向けの別コピーを誰かが維持する必要はありません。

使い続けるほど、さらに役立つようになります。 初日は、計画を書く場所です。3 か月後には、各システムの背後にある理由、却下した提案、設計の各部分とそれを実装するコードとの対応関係が記録されています。新しいチームメイトや新たに始めたエージェントのセッションに本来伝える必要があるものの、たいていは伝えられないコンテキストです。それはあなたのものです。好きなときにいつでもエクスポートできます。また、支払いをやめた場合でも、プロジェクトは削除されず、読み取りとエクスポートのみ可能な状態で凍結されます。

セットアップ不要でデザインを読む

MCP は一連の流れをすべてカバーしますが、セットアップが必要です。設定なしで使える、読み取り専用の方法もあります。プロジェクトのオーナーがリンクを 1 つ公開するだけで、誰でも — 人でも AI チャットでも — そのリンクからデザインを読めます。

• AI チャットに貼り付けると、アシスタントは実際のデザインについて回答します。概要、各システムの Goal ／ Boundary ／ Acceptance、マイルストーン計画をすべて確認できます。アカウントも、キーも、インストールも不要です。
• 読み取るたびにリアルタイムでコンパイルされ、元となったリビジョンが記録されるため、共有リンクから先月の計画がいつの間にか表示されることはありません。
• 意図的に読み取り専用です。 共有リンクを読んでいるアシスタントは何も変更できません。提案を送るには、引き続き認証済みのフローとレビューゲートを経由する必要があります。共有リンクは入り口であり、別の抜け道ではありません。
• プロジェクトごとに任意で有効にでき、いつでも無効にできます。キー、メンバーの身元情報、受信トレイやアクティビティの履歴は含まれません。

Gemini、Claude、Grok に貼り付けて正常に動作することを確認済みです。ChatGPT は既知の例外です — この種のリンクを開かず、ページは公開されていてほかのすべてのアシスタントが読めるにもかかわらず、ウェブ検索を実行してログインが必要だと報告します。アプリでは、ChatGPT に直接貼り付けられるよう、ドキュメントをワンクリックでコピーできます。

---

クイックスタート

一度インストールし、一度ログインすれば、1 行で任意の MCP クライアントを接続できます。

npm で @forgeengine/cli として公開されています（MIT、Node ≥ 18）。インストールされるコマンドは forge です。

npm i -g @forgeengine/cli

forge login

Account Key を貼り付けます（Forge → Connect Agent → Generate an account key）。 Runtime は Account Key をデバイスごとのトークンと交換し、そのトークンだけを保存します。Account Key がディスクに書き込まれることはありません。Connect Agent → Devices から、いつでもデバイスを無効にできます。

任意の MCP クライアントの設定に以下を追加します — すべてのプロジェクトフォルダーでキーは不要です。

{ "command": "forge", "args": ["mcp"] }

クライアントを再起動すれば完了です。

グローバルインストールを避けたい場合は、npx を使用

同じパッケージを使えます。PATH に何も追加されず、npm が初回使用時に取得してキャッシュします。

npx -y @forgeengine/cli login

{ "command": "npx", "args": ["-y", "@forgeengine/cli", "mcp"] }

どちらの場合もログインは一度だけです。デバイストークンはパッケージではなく設定ディレクトリに保存されるため、グローバルインストールと npx で同じセッションを共有します。正直なところ、npx はクライアントがサーバーを起動するたびに少し時間がかかり、初回はネットワークアクセスが必要です。グローバルインストールはより高速で、npx はよりすっきりしています。どちらも同じコードです。

アップグレード

npm i -g @forgeengine/cli@latest    # or: npx -y @forgeengine/cli@latest mcp

新しいツールを使うために、このパッケージをアップグレードする必要はありません。ツールはサーバー側にあるため、再インストールは不要です。クライアントは次のセッション開始時にツールリストを要求してツールを取得します。長時間稼働するリモートコネクターでは、ツールが表示される前に、クライアント自身の設定でツールリストを更新する必要がある場合があります。このパッケージをアップグレードするのは、ローカル Runtime 自体が変更された場合だけです。forge doctor で、現在のバージョンと Forge に接続できるかどうかを確認できます。

コマンド

forge login	このマシンを登録
forge logout	ローカルのデバイストークンを削除
forge mcp	stdio MCP サーバーとして実行（クライアントが起動）
forge doctor	Runtime と接続を確認
forge version	バージョンを表示

仕組み

Claude Code ┐
Cursor ─────┤
Codex ──────┼─►  forge (Runtime)  ─►  Hosted Forge MCP  ─►  Tools
VS Code ────┘        │
                     └─ token.json (0600) + config.json  (~/.config/forge)

Runtime は薄いシムです。ツール、ビジネスロジック、キャッシュ、テレメトリはありません。ツールはすべてサーバー側にあるため、新しいツールを提供する際に新しいパッケージを配布する必要はありません。クライアントがツールの変更を認識するために必要な作業については、アップグレードを参照してください。

---

セキュリティとプライバシー

お使いのマシン上で実行される Forge のコードは Runtime のみです。そのため、オープンソースとして公開されています。認証情報を扱うすべての行を確認できます（500 行未満です）。

• アカウントキーは一切保存されません。 forge login はキーを一度だけ POST してデバイストークンを発行し、その後キーを破棄します。ディスクに書き込まれるのはデバイストークンのみです。
• デバイストークンは 0600 の権限で保存されます。 ~/.config/forge/token.json（Windows では %APPDATA%\Forge\token.json）に保存され、機密情報を含まない config.json とは別に管理されます。トークンへのアクセスは単一の接点を経由するため、呼び出し側を変更せずにファイルを OS のキーチェーンバックエンドに置き換えられます。
• スコープが限定され、取り消し可能です。 デバイストークンはマシンごとに発行されます。ほかのマシンやアカウントキーに影響を与えずに、Connect Agent → Devices からトークンを取り消せます。
• Forge とのみ通信します。 トークンは設定済みの Forge エンドポイントへの Bearer ヘッダーとしてのみ送信されます。分析情報の収集やサードパーティへの通信はありません。
• 依存関係は 1 つだけです。 公式の @modelcontextprotocol/sdk です。
• ヘッドレス環境に対応しています。 ログインの代わりに、CI で FORGE_TOKEN を設定してください。

設定

• ~/.config/forge/config.json（Linux/macOS） · %APPDATA%\Forge\config.json （Windows） — 機密情報を含みません
• ~/.config/forge/token.json — デバイストークン、0600
• 環境変数による上書き：FORGE_TOKEN、FORGE_CONFIG、FORGE_SERVER、FORGE_PROJECT

---

代替方法：ホストされたエンドポイントに直接接続する

ローカルプロセスを一切実行したくない場合は、ほとんどのクライアントでホストされたサーバーに直接接続できます。その場合、キーはデバイスごとのトークンに一度だけ交換されるのではなく、各クライアントの設定に保存されます。

• 種類： リモート／ホスト型 MCP サーバー（Streamable HTTP）
• エンドポイント： https://mmvdabzadclebfxyzudg.supabase.co/functions/v1/forge-mcp
• 検出は公開されています： initialize と tools/list に トークンは不要 なため、どの MCP クライアントでもサインイン前にすべてのツールを確認できます。認証が必要なのはツール呼び出し（tools/call）のみです。
• 認証： Google OAuth、または forge_sk_ アカウントキー（アクセス可能なすべてのプロジェクトに、1 つのキーでアクセスできます）。ウェブアプリで Connect a coding agent を選ぶと取得できます。
• レジストリ： 公式 MCP Registry の app.forgeengine/forge。

Claude Code

claude mcp add --scope user --transport http forge \
  https://mmvdabzadclebfxyzudg.supabase.co/functions/v1/forge-mcp \
  --header "Authorization: Bearer <YOUR_KEY>"

Cursor / Cline / その他の MCP クライアント

上記のエンドポイントを指定したカスタムコネクターを追加する（Authorization: Bearer <YOUR_KEY> ヘッダーを設定する）か、クライアントが対応したら公式 MCP Registry のエントリー（app.forgeengine/forge）からインストールしてください。

// example: custom MCP connector
{
  "forge": {
    "url": "https://mmvdabzadclebfxyzudg.supabase.co/functions/v1/forge-mcp",
    "headers": { "Authorization": "Bearer <YOUR_KEY>" }
  }
}

---

エージェントが MCP 経由でできること（54 個のツール）

すべてのツールにはティアがあり、ティアは慣例ではなく契約の一部です。読み取りツールは書き込みできません。提案ツールはレビュー可能なカードを追加し、公開中のデザインには手を加えません。直接変更ツールは、公開中のデザインに取り消し可能な変更を加えます。また、削除もレビューに回されます。エージェントが単独で何かを破棄することはできません。

• デザインを読み取る： プロジェクトのメタデータと概要、システム（Goal / Boundary / Acceptance）、マイルストーンと次のタスク、影響範囲、記録された履歴、 システム → ファイルのマップ、受信トレイ、却下項目、アクティビティ、検索、残高データ。
• ビルドの実態を報告する： システム → ファイルのマップと受け入れ証拠を含む ビルドステータス、マイルストーンの進捗、ドリフト、ビルドログ、エージェント同士が競合しないためのタスクの 取得と解放。
• 提案 → オーナーがレビュー： 新規または更新されたシステム、デザインノート、 マイルストーン、残高テーブルとボード、既存のコードベースのインポート、提案の取り下げ。
• 画面とフロー（補助的、ユーザー主導）： 画面、要素、フローのエッジ、 システムからの UI レイアウト生成を含みます。

すべてのツールの詳細な説明：forgeengine.app/llms-full.txt — GET で取得できるため、この URL をそのままアシスタントに渡せます。

---

よくある質問

Forge はオープンソースですか？ このリポジトリの Runtime は MIT ライセンスです。これはローカルで動作し、トークンを処理する部分なので、監査できます。Forge の Web アプリとホスト型 MCP サーバーはクローズドソースです。設計データはお客様のものです。いつでもエクスポートでき、プランをキャンセルすると削除されず、読み取りとエクスポートのみ可能な状態になります。

登録する前に、実際の設計を確認できますか？ はい。設定なしで設計を読むをご覧ください。公開共有リンクを使うと、アカウントがなくても、AI チャットを含む誰もがプロジェクト全体の設計をテキストとして閲覧できます。

CLAUDE.md / AGENTS.md ファイルとの違いは何ですか？ Markdown ファイルは個人向けです。1 つのリポジトリに限られ、タスクの担当管理も影響分析もなく、実際に何が作られたかの記録もなく、コーディングをしない人には見えません。Forge はチーム向けです。エージェントがタスクを確保するため、並行作業が重複せず、すべてのシステムが実装する実際のファイルに対応付けられ、「完了」には証拠が必要です。また、プロデューサーやデザイナーはコードに触れずに設計を読んで質問できます。

Notion、Linear、Jira との違いは何ですか？ これらは人間向けに書かれたドキュメントやチケットを保管します。コーディングエージェントは構築前にそれらを読まず、コードが内容と一致しなくなっても検知されません。Forge の設計は MCP 経由で機械可読です。エージェントは実際の仕様に基づいて構築し、現状を報告します。また、両者に食い違いが生じると、計画にその旨が示されます。

AI の「メモリー」ツールとの違いは何ですか？ メモリーは「話されたこと」を類似性に基づいて検索し、ベストエフォートで想起します。エージェントが越えてはならない制約を明示することはできません。Forge が保持するのは「合意されたこと」です。明示的な境界と受け入れ基準を持つシステムが、ワークフローで必須のために参照され、実装するファイルに対応付けられ、変更は人間がレビューする受信箱を通じて管理されます。両者は競合するものではなく、相互に補完します。

チームの一部しかエージェントを使っていなくても利用できますか？ はい。それが通常のケースです。計画は双方にとって同じオブジェクトです。エージェントは MCP 経由でやり取りし、人は Web アプリで読み書きし、レビューキューで両者が合流します。

どのエージェントが使えますか？ Claude Code、Cursor、GitHub Copilot、Cline など、あらゆる MCP クライアントで利用できます。

料金はいくらですか？ オープンな無料ベータ版で、クレジットカードは不要です。有料プランはチームごとの定額制で、AI キーはお客様ご自身のものを使用するため、モデルの利用料金は上乗せされず、実費でお客様に請求されます。

---

詳細を見る

• 製品：forgeengine.app
• 機械可読な概要：forgeengine.app/llms.txt · ツールの全リファレンス：forgeengine.app/llms-full.txt
• レジストリマニフェスト：server.json

ライセンス

MIT — LICENSEをご覧ください。