快速入門：連接你的 AI

Gamentic 是一個 MCP 伺服器。只要讓你的助理指向一個網址、帶上一組金鑰，它就能取得 66 個工具，用來撰寫、繪製、配樂、測試與發佈 HTML5 遊戲——而你依然使用自己的模型和自己的上下文視窗。

你需要的兩個值

1. 建立 MCP 金鑰

1. 登入

   前往 gamentic.net/account。如果你還沒有帳號，請先建立一個——Free 方案每 30 天會發放一筆免費 credits。

2. 開啟 MCP 金鑰

   在帳號頁的側邊欄選擇 MCP 金鑰，再點選 ＋ 開新 key。

3. 以用戶端名稱命名

   每個 AI 用戶端各用一組金鑰——例如 claude-desktop-laptop、codex-work。這樣你就能看出是哪一台裝置在生成內容，必要時也只需停用那一組。

4. 立刻複製

   金鑰以 gi_ 開頭。之後表格只會顯示截短後的樣子，所以請在離開頁面之前，先把它貼進用戶端的設定。

2. 把伺服器加入你的用戶端

Claude Code

只要一行指令：

claude mcp add --transport http gamentic https://mcp.gamentic.net/mcp \
  --header "Authorization: Bearer gi_your_key_here"

也可以在儲存庫根目錄寫入 .mcp.json，把設定依專案納入版本控制；當整個團隊都應該取得相同的工具時，這個做法很實用：

{
  "mcpServers": {
    "gamentic": {
      "type": "http",
      "url": "https://mcp.gamentic.net/mcp",
      "headers": {
        "Authorization": "Bearer gi_your_key_here"
      }
    }
  }
}

Claude Desktop

開啟 Settings → Connectors → Add custom connector，填入上方的端點。接著在該連接器的進階設定中，把 Authorization 標頭設為 Bearer gi_…。如果你使用的 Claude Desktop 版本沒有提供標頭欄位，請改用 Claude Code 或其他可以設定標頭的用戶端——這裡沒有 OAuth 備援方案。

其他 MCP 用戶端

Cursor、Windsurf、Codex、Zed 以及大多數其他用戶端，都接受相同的格式：類型為 http 的遠端伺服器（有時稱為 streamable-http）、一個網址，以及一組標頭對應表。請查閱你的用戶端本身的 MCP 說明文件，確認設定檔放在哪裡，再填入本頁最上方表格中的值。

3. 確認連線成功

開啟一個新的對話，請它執行一項唯讀操作：

List my Gamentic games.

你的助理應該會呼叫 list_games，並回傳你的遊戲庫——如果是新帳號，回傳空清單也算通過。如果你看到的是驗證錯誤，請依序檢查以下項目：

4. 為你的 agent 配置模組

在第一次製作之前，請先開啟 gamentic.net/start。這裡是 Agent Lab：共有十一個模組可以接上或拔除，它們會改變每個已連接的 AI 所收到的指示。設定會立即生效——下一次製作就會套用新的配置。

5. 開始製作

Make me a bubble shooter. Cute pastel art, about 3000 credits of budget.
Tell me the plan before you spend anything.

一次順利的執行，流程大致如下：

1. 先讀規則

   get_convention 與 get_skill 會回傳標記規範、平衡建議，以及——若是已知的遊戲類型—— 取自一款真實上市遊戲的玩法藍圖。這一步免費，也正是它讓 AI 不必憑空猜測遊戲機制。

2. 先估價，再詢問你

   開啟預算模式時，在任何 credits 被扣除之前，你就會先看到製作範圍與小計。

3. 先建立外殼

   create_game 會先建立一個小型的 game.html 外殼，接著由 write_game_file 為每個角色、場景與系統各寫入一個檔案。最後一個檔案寫入時，會執行真正的無頭瀏覽器測試。

4. 生成美術並接進遊戲

   generate_asset、character_sprite、generate_sound、 generate_music。檔案資料會直接存入你的遊戲，回傳給模型的只有名稱。

5. 交給你一個編輯器連結

   https://gamentic.net/edit/<id>。接下來由你親自調校——請參閱編輯器。

下一步