DreamAgent

---

DreamAgent の機能

DreamAgent は AI アプリ構築プラットフォームです。作りたいものを説明すると、 エージェントがコードを作成し、テストを実行し、再ビルドし、本番環境に再デプロイして、 git にコミットします。すべて自動で行われます。この MCP サーバーを使うと、その機能を AI チャットから利用できます。

あなた：「WeatherBot という Telegram ボットを作成して。トークンは 123:ABC。都市名を送ると天気を返信するようにして。」

**ChatGPT：**作成 → 状態を確認 → 「WeatherBot を公開しました。」

あなた：「5 日間予報を表示する /forecast コマンドを追加して。」

**ChatGPT：**編集を依頼 → エージェントがコーディング、テスト、再デプロイ → 完了。

ツール

ツール	機能
dreamagent_list_projects	プロジェクトの一覧を表示します（ID、種類、ステータス、ドメイン）
dreamagent_create_project	ウェブサイト／Telegram ボット／Discord ボット／エージェントのプロジェクトを作成します
dreamagent_get_project_status	ready／failed になるまでビルドの状態を確認します
dreamagent_chat	プロジェクトの AI エージェントにビルド／編集／デバッグの指示を送信します
dreamagent_get_chat_status	編集の実行状況を確認します（出力は順次表示）
dreamagent_get_edit_progress	プロジェクトごとの編集進捗を取得します。セッションキーは不要です
dreamagent_list_sessions	プロジェクトごとの会話スレッドを一覧表示します
dreamagent_create_session	新しいトピック用のスレッドを開始します
dreamagent_cancel_chat	実行中の編集をキャンセルします
dreamagent_release_project_lock	最終手段としてロックを解除します（先に確認してください）
dreamagent_list_files	プロジェクトのファイルツリーを一覧表示します
dreamagent_read_file	プロジェクトのソースファイルを 1 つ読み込みます
dreamagent_edit_file	既存ファイルの対象箇所を検索して置換します（編集時に推奨）
dreamagent_write_file	ファイルを作成／上書きします（確認が必要。新規ファイルや全面的な書き換え用）
dreamagent_get_file_diff	最後のコミット以降の変更内容を表示します
dreamagent_delete_file	ファイルを削除します（確認が必要）
dreamagent_commit_push	保留中の変更をすべて 1 つのバージョンとしてコミットしてプッシュします（失敗したコミットの再試行も可能）
dreamagent_list_commits	バージョン履歴を表示します（ハッシュ、メッセージ、ステータス）。ダッシュボードから復元できます
dreamagent_build_publish	プロジェクトを再ビルドして公開します（確認が必要）
dreamagent_design_mode	デザイン画像をアップロードすると、エージェントがそれに合わせて UI を再デザインします
dreamagent_screenshot_website	任意の公開ページのスクリーンショットを取得します（画像と URL を返します）
dreamagent_list_superpowers	プロジェクトの AI ツールカタログを表示します（音楽、画像、動画のツール）
dreamagent_list_project_env	プロジェクトの環境変数名を表示します（値はマスクされ、シークレットは非表示）
dreamagent_list_global_integrations	アカウント所有者が接続したプロバイダーを表示します

時間のかかる操作は、送信してから状態を確認する方式です。作成 → 状態を確認、編集 → 進捗を確認します。ファイルの変更はすべて自動でコミットおよびプッシュされるため、各編集内容はセッション履歴とバージョン履歴に記録され、復元できます。エージェントがコード、テスト、再ビルド、再デプロイ、git へのコミットをすべて自動で処理するため、プロンプトには変更内容だけを記述します。

接続 — ChatGPT

公式アプリを使う場合（推奨）： ChatGPT アプリのディレクトリで DreamAgent を見つけて → Connect → DreamAgent アカウント（メールアドレスまたは Google）でサインインします。

カスタムコネクターとして接続する場合：

1. DreamAgent で → Settings → Connect to ChatGPT → Create Key → 完全な URL（キーが含まれています）をコピーします
2. ChatGPT で → Settings → Apps & Connectors → Advanced → Add custom connector
3. URL を MCP Server URL として貼り付け、OAuth（または No authentication — キーは URL に含まれています）を選択して保存します
4. 次のように質問します：「DreamAgent のプロジェクトを表示して」

接続 — Claude

Claude → Settings → Connectors → Add custom connector：

• Name: DreamAgent
• Remote MCP server URL: https://mcp.dreamagent.cloud/mcp
• OAuth: 空欄のままにしてください — Claude が自動検出します

Connect をクリックし、DreamAgent でサインインすれば完了です。

接続 — 任意の MCP クライアント

{
  "mcpServers": {
    "dreamagent": {
      "type": "streamable_http",
      "url": "https://mcp.dreamagent.cloud/mcp"
    }
  }
}

認証方式は OAuth 2.1（認可コード + PKCE、RFC 7591 の動的登録）です。 または、DreamAgent API キーを Authorization: Bearer da_... / ?key=da_... として渡してください。

プロンプトの例

• 「DreamAgent のプロジェクトを表示して」
• 「PriceBot という名前の Discord ボットを作成して — トークンは <from Discord dev portal> — /price と /top コマンドで暗号資産の価格を表示するボットです」
• 「ウェブサイトの構築は完了していますか？」
• 「暗号資産ボットが返信しなくなりました — 何が問題ですか？」（編集を開始する際、エージェントはまず プロジェクトのログを読み取ります）
• 「ドキュメントサイトにダークモードの切り替えを追加して」
• 「昨日のダッシュボードの変更をロールバックして」（チャット経由）
• 「AI クレジットはあと何件残っていますか？」

仕組み

ChatGPT / Claude / Glama
   │  MCP (streamable HTTP) + OAuth 2.1
   ▼
mcp.dreamagent.cloud ── this server (FastMCP)
   │  per-request Bearer = the user's own DreamAgent API key
   ▼
api.dreamagent.cloud ── DreamAgent platform
   └── agent writes code → tests → rebuild → deploy → git commit

すべてのリクエストは接続中のユーザーとして実行されます。DreamAgent の所有権チェック、 プランの上限、AI クレジットの課金は、ダッシュボードとまったく同じように適用されます。

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

• キーはあなたのもの、アカウントもあなたのものです。 OAuth は接続時に、取り消し可能な DreamAgent API キー （da_...）を発行します。このキーは Settings → Connect to ChatGPT でいつでも確認・取り消しできます。 取り消すと、そのクライアントはすぐに切断されます。他のクライアントは引き続き使用できます。
• 適切な OAuth。 認可コード + PKCE（S256 は必須）、 120 秒間有効で一度だけ使用できるコード、リダイレクト URI の許可リスト（RFC 8252 に準拠したループバック）、 ログインのレート制限、提示時のシークレット検証を備えています。クライアント登録は再起動後も保持されます。
• チャットにシークレットは含まれません。 Telegram/Discord のボットトークンは HTTPS 経由で DreamAgent に送信され、プロジェクトの環境変数としてサーバー側に保存されます。ダッシュボードの作成ダイアログと同じ方式です。 MCP サーバーが認証情報をログに記録することはありません。
• このサーバーがトークンを保存することはありません。 リクエストごとに呼び出し元自身の Bearer を転送し、 データベースは保持しません。

プライバシー：dreamagent.cloud/privacy · 利用規約：dreamagent.cloud/terms

スクリーンショット

Coming soon — a GIF of "Create a Telegram bot" end-to-end from ChatGPT.

セルフホスト／開発

ホスト済みのエンドポイント（mcp.dreamagent.cloud）が最も簡単な接続方法です。 独自に実行するには：

git clone https://github.com/nivethaug/dreamagent-mcp-server
cd dreamagent-mcp-server
pip install -r requirements.txt
cp .env.example .env          # optional: your account for local stdio mode
python server.py              # stdio
python server.py --http --port 8800   # remote MCP (put behind HTTPS)

本番ホストのセキュリティ強化： サービスは run-mcp.sh を介して pm2 で実行され、 専用の cgroup dreamagent-mcp-egress に参加します。 ホストのファイアウォールルール（/usr/local/sbin/mcp-egress-rules.sh。mcp-egress-block.service systemd ユニットで適用）は、 その cgroup から内部のすべての範囲（ループバック／RFC1918／リンクローカル／CGNAT／マルチキャスト、 IPv4 + IPv6）への新規接続をブロックし、DNS とパブリックトラフィックは許可します。これにより、リダイレクトや サブリソースを介した場合でも、スクリーンショットが内部サービスに到達することはありません。

システム依存関係 — Chromium： dreamagent_screenshot_website ツールは、システムの Chromium/Chrome バイナリを使ってページをレンダリングします（次の順に確認します： /usr/bin/chromium、/usr/bin/chromium-browser、/usr/bin/google-chrome、 その後 PATH）。pip ではインストールされません — Debian/Ubuntu の場合：

apt-get install -y chromium          # or chromium-browser / google-chrome

これがなくても他のすべてのツールは動作します。スクリーンショットツールは 「no headless chromium binary」という明確なエラーを返します。

リクエストごとの優先順位に従って、次の 3 つの認証モードを使用します。

1. Authorization: Bearer da_... ヘッダー（OAuth クライアント／API クライアント）
2. ?key=da_... URL パラメーター（NoAuth カスタムコネクター）
3. DREAMAGENT_EMAIL / DREAMAGENT_PASSWORD 環境変数（個人用セルフホスト）

構成：server.py（ツール） · oauth.py（OAuth 2.1 プロバイダー：/register、 /authorize、/token、/.well-known/*） · dreamagent_client.py（API クライアント） · auth.py（ログインモード） · plugin/（Codex プラグインパッケージ）。

OAuth クライアントの登録は oauth_clients.json に保持されます。信頼された ゲートウェイのコールバックは TRUSTED_OAUTH_REDIRECTS で追加できます。

Links

• DreamAgent — dreamagent.cloud
• Documentation — dreamagent.cloud/documentation
• Help & Support — dreamagent.cloud/help
• Support — [email protected]

License

MIT