快速入門:連接你的 AI
Gamentic 是一個 MCP 伺服器。只要讓你的助理指向一個網址、帶上一組金鑰,它就能取得 72 個工具,用來撰寫、繪製、配樂、測試與發佈 HTML5 遊戲——而你依然使用自己的模型和自己的上下文視窗。
你需要的兩個值
| 設定 | 值 |
|---|---|
| 端點 | https://mcp.gamentic.net/mcp——MCP Streamable HTTP |
| 驗證標頭 | Authorization: Bearer gi_… |
有兩種連接方式。Claude(網頁、桌面版、手機)和 ChatGPT 可以直接登入 Gamentic 連接,不用複製金鑰。其他用戶端(包括 Cursor、VS Code 和 Codex)則在 Authorization 標頭中帶上 MCP 金鑰。
1. 建立 MCP 金鑰
-
登入
前往 gamentic.net/account。如果你還沒有帳號,請先建立一個——Free 方案每 30 天會發放一筆免費 credits。
-
開啟 MCP 金鑰
在帳號頁的側邊欄選擇 MCP 金鑰,再點選 + 建立新金鑰。
-
以用戶端名稱命名
每個 AI 用戶端各用一組金鑰——例如
claude-desktop-laptop、codex-work。這樣你就能看出是哪一台裝置在生成內容,必要時也只需停用那一組。 -
立刻複製
金鑰以
gi_開頭。之後表格只會顯示截短後的樣子,所以請在離開頁面之前,先把它貼進用戶端的設定。
金鑰會消耗你的 credits。任何 AI 持有這組金鑰時生成的內容,都會從你的錢包扣款。請把它當成付款憑證看待:絕對不要提交到公開的儲存庫;一旦懷疑外洩,請立刻到同一個頁面停用。
2. 把伺服器加入你的用戶端
在下方選擇你用的 AI,每一個都有完整步驟。Claude 和 ChatGPT 用登入連接;其他工具用第 1 步建立的金鑰。找不到你的工具?把本頁最上方的兩個值填進它自己的 MCP 設定。
Claude 登入連接
所有 Claude 方案都可以使用,免費方案只能加入一個自訂連接器。團隊版和企業版要由擁有者新增,並先為組織開啟連接器。
-
開啟 Customize → Connectors。
-
如果看不到「Add custom connector」,先按「+」。
-
按「Add custom connector」。
-
在「Name」填入
Gamentic。 -
在「MCP server URL」填入
https://mcp.gamentic.net/mcp。 -
「Advanced settings」和「Request headers」保持空白。
-
按「Add」。
-
按「Connect」。
-
在開啟的視窗登入 Gamentic,然後按「允許」。
-
開啟 + → Connectors。
-
在「Gamentic」選擇「On」。
-
手機:先在網頁版或桌面版加入,手機 App 就會出現。
對話框分成兩個步驟(Authentication 和 OAuth client)
-
開啟 Customize → Connectors。
-
按「Add custom connector」。
-
在「Name」填入
Gamentic。 -
在「MCP server URL」填入
https://mcp.gamentic.net/mcp。 -
在「Authentication」選擇「Sign in now」。
-
在「OAuth client」選擇「Use Claude's published identity」。
-
按「Add」。
-
按「Connect」。
-
在開啟的視窗登入 Gamentic,然後按「允許」。
團隊版或企業版:擁有者新增一次,成員各自按「Connect」登入
-
開啟 Organization settings → Connectors。
-
按「Add」。
-
按「Custom」。
-
按「Web」。
-
在「MCP server URL」填入
https://mcp.gamentic.net/mcp。 -
按「Add」。
-
開啟 Customize → Connectors。
-
按「Connect」。
-
在開啟的視窗登入 Gamentic,然後按「允許」。
ChatGPT 登入連接
需要網頁版的 Plus、Pro、Business、Enterprise 或 Edu 方案,手機 App 不支援。Business 只有管理員可以使用開發者模式,Enterprise 和 Edu 要由管理員授權。
-
開啟 Settings → Security and login。
-
在「Developer mode」選擇「On」。
-
開啟 Plugins。
-
按「+」。
-
如果先看到「Create app」,請先按它,再選「Create MCP App」。
-
按「Create MCP App」。
-
在「Name」填入
gamentic。 -
如果表單要求填寫「Description」,請填入 Gamentic。
-
在「Server URL」填入
https://mcp.gamentic.net/mcp。 -
在「Authentication」選擇「OAuth」。
-
如果表單有 OAuth client ID 或 secret 欄位,請保持空白。
-
勾選「I understand and want to continue」。
-
按「Create」。
-
在開啟的視窗登入 Gamentic,然後按「允許」。
-
在新對話的「+」選單(或「More」中)選擇 gamentic 即可使用。
工作區管理員(Workspace settings 版面)
-
開啟 Workspace settings → Apps。
-
按「Create」。
-
在「Name」填入
gamentic。 -
在「Server URL」填入
https://mcp.gamentic.net/mcp。 -
在「Authentication」選擇「OAuth」。
-
按「Scan Tools」。
-
在開啟的視窗登入 Gamentic,然後按「允許」。
-
按「Create」。
Claude Code 登入或金鑰
需要先安裝並登入 Claude Code。同一個指令在 bash、zsh、PowerShell 和命令提示字元都能用。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
在終端機執行:
bashclaude mcp add --transport http --scope user gamentic https://mcp.gamentic.net/mcp --header "Authorization: Bearer gi_your_key_here" -
執行
claude mcp list,確認 gamentic 顯示為已連接。
不用金鑰,改用登入連接
-
先把 Claude Code 更新到最新版本。
-
在終端機執行:
bashclaude mcp add --transport http --scope user gamentic https://mcp.gamentic.net/mcp -
在終端機執行:
bashclaude mcp login gamentic -
在開啟的視窗登入 Gamentic,然後按「允許」。
-
執行
claude mcp list,確認 gamentic 顯示為已連接。
團隊共用 .mcp.json(金鑰放在環境變數)
-
把金鑰存到環境變數
GAMENTIC_API_KEY(設定後,重新開啟終端機和應用程式才會生效):macOS (zsh)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.zshrcLinux (bash)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.bashrcWindows (PowerShell)setx GAMENTIC_API_KEY "gi_your_key_here" -
開啟
<project>/.mcp.json(沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "type": "http", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer ${GAMENTIC_API_KEY}" } } } } -
重新啟動 Claude Code,讓它載入新的伺服器。
-
Claude Code 詢問是否使用這個專案的伺服器時,請允許 gamentic。
-
執行
/mcp,確認 gamentic 顯示為已連接。
Codex 使用金鑰
需要登入 Codex(包含 Codex 的 ChatGPT 方案,或 OpenAI API 金鑰)。CLI、IDE 擴充功能和 ChatGPT 桌面版共用同一個 config.toml。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
把金鑰存到環境變數
GAMENTIC_API_KEY(設定後,重新開啟終端機和應用程式才會生效):macOS (zsh)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.zshrcLinux (bash)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.bashrcWindows (PowerShell)setx GAMENTIC_API_KEY "gi_your_key_here" -
在終端機執行:
bashcodex mcp add gamentic --url https://mcp.gamentic.net/mcp --bearer-token-env-var GAMENTIC_API_KEY -
請從新開啟的終端機視窗啟動 Codex,它才能讀取 GAMENTIC_API_KEY。
-
執行
/mcp,確認 gamentic 顯示為已連接。
Codex IDE 擴充功能(VS Code、Cursor、Windsurf)
-
把金鑰存到環境變數
GAMENTIC_API_KEY(設定後,重新開啟終端機和應用程式才會生效):macOS (zsh)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.zshrcLinux (bash)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.bashrcWindows (PowerShell)setx GAMENTIC_API_KEY "gi_your_key_here" -
開啟 ⚙ → Codex Settings → Open config.toml。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
toml[mcp_servers.gamentic] url = "https://mcp.gamentic.net/mcp" bearer_token_env_var = "GAMENTIC_API_KEY" -
重新啟動 VS Code / Cursor / Windsurf,讓它載入新的伺服器。
-
確認 gamentic 在 ⚙ → MCP servers 顯示為已連接。
ChatGPT 桌面版,或 Codex 無法讀取環境變數時
-
開啟
~/.codex/config.toml(Windows 為%USERPROFILE%\.codex\config.toml;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
toml[mcp_servers.gamentic] url = "https://mcp.gamentic.net/mcp" http_headers = { "Authorization" = "Bearer gi_your_key_here" } -
如果已經有 [mcp_servers.gamentic] 區段,請用這段取代。這個檔案現在含有金鑰,請勿分享。
-
重新啟動 Codex,讓它載入新的伺服器。
-
執行
/mcp,確認 gamentic 顯示為已連接。
Gemini CLI 使用金鑰
從 2026-06-18 起,Gemini CLI 只提供給 Gemini Code Assist Standard/Enterprise 和付費 API 金鑰。免費和 Google AI Pro/Ultra 帳號請改用 Antigravity CLI。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
在終端機執行:
bashgemini mcp add -s user -t http -H "Authorization: Bearer gi_your_key_here" gamentic https://mcp.gamentic.net/mcp -
重新啟動 Gemini CLI,讓它載入新的伺服器。
-
在「Do you trust the files in this folder?」選擇「Trust folder」。
-
執行
/mcp list,確認 gamentic 顯示為已連接。
手動編輯設定檔
-
開啟
~/.gemini/settings.json(Windows 為%USERPROFILE%\.gemini\settings.json;沒有這個檔案就新增一個)。 -
保留檔案裡原有的設定,只加入 mcpServers 這一段。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "type": "http", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Gemini CLI,讓它載入新的伺服器。
-
在「Do you trust the files in this folder?」選擇「Trust folder」。
Antigravity CLI 使用金鑰
需要 Antigravity CLI 1.1.16 以上,所有 Antigravity 方案(包括免費)都可以使用。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 Antigravity CLI 更新到最新版本。
-
在終端機執行:
bashagy mcp add --header "Authorization: Bearer gi_your_key_here" gamentic https://mcp.gamentic.net/mcp -
重新啟動 Antigravity CLI,讓它載入新的伺服器。
-
執行
/mcp,確認 gamentic 顯示為已連接。
手動編輯設定檔
-
開啟
~/.gemini/config/mcp_config.json(Windows 為%USERPROFILE%\.gemini\config\mcp_config.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "serverUrl": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Antigravity CLI,讓它載入新的伺服器。
GitHub Copilot CLI 使用金鑰
需要用有 Copilot 方案的帳號登入 GitHub Copilot CLI。組織的 MCP 允許清單可能會封鎖它。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
在終端機執行:
bashcopilot mcp add --transport http --header "Authorization: Bearer gi_your_key_here" --timeout 120000 gamentic https://mcp.gamentic.net/mcp -
執行
copilot mcp list,確認 gamentic 顯示為已連接。
手動編輯設定檔
-
開啟
~/.copilot/mcp-config.json(Windows 為%USERPROFILE%\.copilot\mcp-config.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "type": "http", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" }, "tools": [ "*" ], "timeout": 120000 } } } -
重新啟動 GitHub Copilot CLI,讓它載入新的伺服器。
-
執行
/mcp,確認 gamentic 顯示為已連接。
Qwen Code 使用金鑰
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
在終端機執行:
bashqwen mcp add -s user -t http -H "Authorization: Bearer gi_your_key_here" gamentic https://mcp.gamentic.net/mcp -
重新啟動 Qwen Code,讓它載入新的伺服器。
-
執行
qwen mcp list,確認 gamentic 顯示為已連接。
手動編輯設定檔
-
開啟
~/.qwen/settings.json(Windows 為%USERPROFILE%\.qwen\settings.json;沒有這個檔案就新增一個)。 -
保留檔案裡原有的設定,只加入 mcpServers 這一段。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "httpUrl": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Qwen Code,讓它載入新的伺服器。
Qwen Code 桌面版
-
開啟 ⋮ Workspace actions → MCP。
-
按「Add」。
-
在「Name」填入
gamentic。 -
在「Location」選擇「Global」。
-
先刪除「Configuration (JSON)」中的範例文字,再貼上以下內容。
json{ "httpUrl": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } -
按「Add」。
Cline CLI 使用金鑰
需要 Cline CLI 3.0.30 以上。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
在終端機執行:
bashnpm install -g cline@latest -
在終端機執行:
bashcline mcp install gamentic --transport http https://mcp.gamentic.net/mcp --header "Authorization: Bearer gi_your_key_here" --yes -
重新啟動 Cline CLI,讓它載入新的伺服器。
-
VS Code 和 JetBrains 的 Cline 擴充功能共用這個設定,也會一起加入 gamentic。
使用互動式設定
-
在終端機執行:
bashcline mcp -
在「What would you like to do?」選擇「Add server」。
-
在「Server name」填入
gamentic。 -
在「Server type」選擇「Remote (HTTP)」。
-
在「Server URL」填入
https://mcp.gamentic.net/mcp。 -
在「Authentication」選擇「Static headers」。
-
在「Headers (KEY:VALUE, comma-separated)」填入
Authorization:Bearer gi_your_key_here。 -
在「What would you like to do?」選擇「Exit」。
手動編輯設定檔
-
開啟
~/.cline/data/settings/cline_mcp_settings.json(Windows 為%USERPROFILE%\.cline\data\settings\cline_mcp_settings.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "type": "streamableHttp", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Cline CLI,讓它載入新的伺服器。
OpenCode 使用金鑰
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 OpenCode 更新到最新版本。
-
在終端機執行:
bashopencode mcp add gamentic --url https://mcp.gamentic.net/mcp --header "Authorization=Bearer gi_your_key_here" -
如果 opencode --version 顯示 2.x,請改用「OpenCode 2」的做法。
-
執行
opencode mcp list,確認 gamentic 顯示為已連接。
OpenCode 2(opencode --version 顯示 2.x)
-
在終端機執行:
bashopencode mcp add gamentic --global --url https://mcp.gamentic.net/mcp --header "Authorization=Bearer gi_your_key_here" -
執行
opencode mcp list,確認 gamentic 顯示為已連接。
手動編輯設定檔
-
開啟
~/.config/opencode/opencode.json(Windows 為%USERPROFILE%\.config\opencode\opencode.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "$schema": "https://opencode.ai/config.json", "mcp": { "gamentic": { "type": "remote", "url": "https://mcp.gamentic.net/mcp", "oauth": false, "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 OpenCode,讓它載入新的伺服器。
-
執行
opencode mcp list,確認 gamentic 顯示為已連接。
Amp 使用金鑰
需要 Amp 帳號。企業工作區可能會封鎖不在允許清單上的伺服器。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟
~/.config/amp/settings.json(Windows 為%USERPROFILE%\.config\amp\settings.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "amp.mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Amp,讓它載入新的伺服器。
Crush 使用金鑰
需要 Crush 0.88.0 以上,更舊的版本只讀取 crush.json。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 Crush 更新到最新版本。
-
開啟
~/.config/crush/crushrc(Windows 為%USERPROFILE%\.config\crush\crushrc;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
bashmcp add gamentic --type http --url "https://mcp.gamentic.net/mcp" --header Authorization "Bearer gi_your_key_here" -
重新啟動 Crush,讓它載入新的伺服器。
-
確認 gamentic 在 MCPs 顯示為已連接。
舊版 crush.json(較舊的 Crush)
-
開啟
~/.config/crush/crush.json(Windows 為%USERPROFILE%\.config\crush\crush.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "$schema": "https://charm.land/crush.json", "mcp": { "gamentic": { "type": "http", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Crush,讓它載入新的伺服器。
Warp 使用金鑰
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟 Settings → Agents → MCP servers。
-
按「+ Add」。
-
在開啟的編輯器貼上以下內容,然後存檔。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
按「Start」。
-
確認 gamentic 在 Settings → Agents → MCP servers 顯示為已連接。
手動編輯設定檔
-
開啟
~/.warp/.mcp.json(Windows 為%USERPROFILE%\.warp\.mcp.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
確認 gamentic 在 Settings → Agents → MCP servers 顯示為已連接。
Cursor 使用金鑰
請使用最新版 Cursor,3.5 和更舊的版本可能無法用金鑰連接。MCP 可能需要付費方案。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 Cursor 更新到最新版本。
-
開啟
~/.cursor/mcp.json(Windows 為%USERPROFILE%\.cursor\mcp.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
金鑰只放在這個個人檔案中,不要放進會與他人共用的專案 .cursor/mcp.json。
-
重新啟動 Cursor,讓它載入新的伺服器。
-
確認 gamentic 在 Customize → MCPs 顯示為已連接。
只使用 Cursor CLI(agent)
-
在終端機執行:
bashagent update -
開啟
~/.cursor/mcp.json(Windows 為%USERPROFILE%\.cursor\mcp.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
執行
agent mcp list,確認 gamentic 顯示為已連接。
不把金鑰寫進檔案(使用環境變數)
-
先把 Cursor 更新到最新版本。
-
把金鑰存到環境變數
GAMENTIC_API_KEY(設定後,重新開啟終端機和應用程式才會生效):macOS (zsh)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.zshrcLinux (bash)echo 'export GAMENTIC_API_KEY="gi_your_key_here"' >> ~/.bashrcWindows (PowerShell)setx GAMENTIC_API_KEY "gi_your_key_here" -
開啟
~/.cursor/mcp.json(Windows 為%USERPROFILE%\.cursor\mcp.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer ${env:GAMENTIC_API_KEY}" } } } } -
重新啟動 Cursor,讓它載入新的伺服器。
-
確認 gamentic 在 Customize → MCPs 顯示為已連接。
VS Code 使用金鑰
需要登入 GitHub Copilot。Copilot Business/Enterprise 要由管理員開啟「MCP servers in Copilot」。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟 View → Command Palette... → MCP: Open User Configuration。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "inputs": [ { "type": "promptString", "id": "gamentic_api_key", "description": "Gamentic API key", "password": true } ], "servers": { "gamentic": { "type": "http", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer ${input:gamentic_api_key}" } } } } -
按檔案中 gamentic 上方出現的「Start」。
-
在「Gamentic API key」填入
gi_your_key_here。 -
開啟 View → Command Palette... → Chat: Open Chat。
-
在「Session Target」選擇「Local」。
-
在「agent picker」選擇「Agent」。
-
確認 gamentic 在 View → Command Palette... → MCP: List Servers 顯示為已連接。
命令列(macOS/Linux)
-
Mac 如果找不到 code 指令,請先在 Command Palette 執行「Shell Command: Install 'code' command in PATH」。
-
在終端機執行:
bashcode --add-mcp '{"name":"gamentic","type":"http","url":"https://mcp.gamentic.net/mcp","headers":{"Authorization":"Bearer ${input:gamentic_api_key}"},"inputs":[{"type":"promptString","id":"gamentic_api_key","description":"Gamentic API key","password":true}]}' -
開啟 View → Command Palette... → Chat: Open Chat。
-
在「Session Target」選擇「Local」。
-
在「agent picker」選擇「Agent」。
-
開啟 View → Command Palette... → MCP: List Servers。
-
按「gamentic」。
-
按「Start Server」。
-
按「Trust」。
-
在「Gamentic API key」填入
gi_your_key_here。
Visual Studio 使用金鑰
只限 Windows:Visual Studio 2026,或更新到最新版的 Visual Studio 2022 17.14。需要用有 Copilot 的 GitHub 帳號登入。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 Visual Studio 更新到最新版本。
-
開啟
%USERPROFILE%\.mcp.json(沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "servers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "requestInit": { "headers": { "Authorization": "Bearer gi_your_key_here" } } } } } -
開啟 View → GitHub Copilot Chat。
-
在「mode」選擇「Agent」。
-
按「Tools」。
-
在「Tools」選擇「gamentic」。
從聊天視窗新增
-
開啟 View → GitHub Copilot Chat。
-
在「mode」選擇「Agent」。
-
按「Tools」。
-
按「+」。
-
Visual Studio 2022 按「+」後會直接開啟對話框,請跳過下一步。
-
按「Add custom MCP server」。
-
在「Server ID」填入
gamentic。 -
在「Type」選擇「HTTP/SSE」。
-
在「URL」填入
https://mcp.gamentic.net/mcp。 -
在「Headers」新增一個名為 Authorization 的標頭。
-
在「Authorization」填入
Bearer gi_your_key_here。 -
按「Save」。
-
按「Tools」。
-
在「Tools」選擇「gamentic」。
JetBrains 使用金鑰
Junie 和 AI Assistant 需要 JetBrains AI 授權(試用、付費或 AI Free),Copilot 外掛需要 Copilot 方案。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟 Settings → Tools → Junie → MCP Settings。
-
按「Add」。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
確認 gamentic 在 Settings → Tools → Junie → MCP Settings 顯示為已連接。
AI Assistant 聊天
-
開啟 Settings → Tools → AI Assistant → Model Context Protocol (MCP)。
-
按「Add」。
-
按「HTTP」。
-
把框內的範例文字全部換成以下內容。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
在「Server level」選擇「Global」。
-
按「OK」。
-
按「Apply」。
GitHub Copilot 外掛
-
開啟 GitHub Copilot → Open Chat → Agent。
-
按「Configure your MCP server」。
-
按「Add MCP Tools」。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "servers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "requestInit": { "headers": { "Authorization": "Bearer gi_your_key_here" } } } } }
Devin Desktop (Windsurf) 使用金鑰
需要開啟 Devin Local 代理。單行指令需要 Devin CLI,如果沒有安裝,請改用設定檔的做法。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
在終端機執行:
bashdevin mcp add -s user gamentic https://mcp.gamentic.net/mcp -H "Authorization: Bearer gi_your_key_here" -
重新啟動 Devin Desktop,讓它載入新的伺服器。
-
執行
/mcp,確認 gamentic 顯示為已連接。
手動編輯設定檔
-
開啟
~/.config/devin/mcp_config.json(Windows 為%APPDATA%\devin\mcp_config.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Devin Desktop,讓它載入新的伺服器。
舊版 Windsurf(Cascade)
-
開啟 Cascade → … → MCPs。
-
按「Open MCP config file」。
-
較舊的 Windsurf 如果沒有這個選單,設定檔位於 ~/.codeium/windsurf/mcp_config.json。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "serverUrl": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Windsurf,讓它載入新的伺服器。
-
確認 gamentic 在 Cascade → … → MCPs 顯示為已連接。
Zed 使用金鑰
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟 Settings → AI → MCP Servers。
-
按「Add Server」。
-
按「Add Remote Server」。
-
把框內的範例文字全部換成以下內容。
json{ "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } -
按「Configure Server」。
-
確認 gamentic 在 Settings → AI → MCP Servers 顯示為已連接。
手動編輯設定檔
-
開啟
~/.config/zed/settings.json(Windows 為%APPDATA%\Zed\settings.json;沒有這個檔案就新增一個)。 -
保留其他設定,把 context_servers 放在檔案最外層的大括號裡。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "context_servers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } }
Antigravity 使用金鑰
所有 Antigravity 方案(包括免費)都可以使用。桌面版、IDE 和 Antigravity CLI 共用同一個設定檔。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 Antigravity 更新到最新版本。
-
開啟
~/.gemini/config/mcp_config.json(Windows 為%USERPROFILE%\.gemini\config\mcp_config.json;沒有這個檔案就新增一個)。 -
這是 Antigravity 自己的檔案,不是 Gemini CLI 的 settings.json。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "serverUrl": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Antigravity,讓它載入新的伺服器。
-
確認 gamentic 在 Settings → Customizations → Installed MCP Servers 顯示為已連接。
Antigravity IDE:從 MCP 選單開啟檔案
-
開啟 … → MCP Servers → Manage MCP Servers → View raw config。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "serverUrl": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
重新啟動 Antigravity,讓它載入新的伺服器。
-
確認 gamentic 在 … → MCP Servers → Manage MCP Servers 顯示為已連接。
Cline 使用金鑰
需要 Cline 4.x。企業管理員可能會封鎖個人的遠端 MCP 伺服器。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 Cline 更新到最新版本。
-
開啟 Customize → MCP → Installed。
-
按「Edit Configuration」。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "type": "streamableHttp", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
不要使用「Add Remote Server」表單,因為它沒有填寫金鑰的欄位。
-
確認 gamentic 在 Customize → MCP → Installed 顯示為已連接。
-
如果 gamentic 旁邊出現「Authenticate」按鈕,代表金鑰錯誤或沒有填寫;Cline 無法使用登入連接。
手動編輯設定檔
-
開啟
~/.cline/data/settings/cline_mcp_settings.json(Windows 為%USERPROFILE%\.cline\data\settings\cline_mcp_settings.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "type": "streamableHttp", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } }
Kilo Code 使用金鑰
需要 Kilo Code 7.x。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 Kilo Code 更新到最新版本。
-
開啟 Settings。
-
按「Global Config」。
-
如果出現檔案清單,請選擇 kilo.jsonc。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "$schema": "https://app.kilo.ai/config.json", "mcp": { "gamentic": { "type": "remote", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" }, "oauth": false, "enabled": true } } } -
oauth 這一行請保持 false,Kilo Code 無法使用 Gamentic 的登入連接。
-
重新啟動 VS Code / JetBrains,讓它載入新的伺服器。
-
確認 gamentic 在 Settings → Agent Behaviour → MCP Servers 顯示為已連接。
Kilo CLI
-
在終端機執行:
bashnpm install -g @kilocode/cli@latest -
在終端機執行:
bashkilo mcp add gamentic --url https://mcp.gamentic.net/mcp --header "Authorization=Bearer gi_your_key_here" -
執行
kilo mcp list,確認 gamentic 顯示為已連接。
手動編輯設定檔
-
開啟
~/.config/kilo/kilo.jsonc(Windows 為%USERPROFILE%\.config\kilo\kilo.jsonc;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "$schema": "https://app.kilo.ai/config.json", "mcp": { "gamentic": { "type": "remote", "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" }, "oauth": false, "enabled": true } } } -
重新啟動 VS Code / JetBrains,讓它載入新的伺服器。
Kiro 使用金鑰
請使用最新版 Kiro,並在設定中開啟 MCP 支援。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟 Command Palette → Kiro: Open user MCP config (JSON)。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
如果沒有出現 gamentic,請到設定中搜尋 MCP 並開啟 MCP 支援。
-
確認 gamentic 在 Kiro → MCP Servers 顯示為已連接。
Kiro CLI
-
開啟
~/.kiro/settings/mcp.json(Windows 為%USERPROFILE%\.kiro\settings\mcp.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
執行
/mcp,確認 gamentic 顯示為已連接。
TRAE 使用金鑰
TRAE 交給模型的 MCP 工具上限是 40 個。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟 Settings → MCP。
-
按「Add」。
-
按「Add Manually」。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
按「Confirm」。
-
在代理的工具清單中,取消勾選用不到的 Gamentic 工具。
-
確認 gamentic 在 Settings → MCP 顯示為已連接。
Mistral Le Chat 使用金鑰
只有管理員可以新增自訂連接器,個人方案的帳號擁有者就是管理員。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
開啟 Context → Connectors。
-
按「+ Add Connector」。
-
按「Custom MCP Connector」。
-
在「Connector name」填入
gamentic。 -
在「Server URL」填入
https://mcp.gamentic.net/mcp。 -
在「Authentication method」選擇「API Token Authentication」。
-
Mistral 可能預設選擇 OAuth2.1,這個選項無法連接 Gamentic,一定要改掉。
-
在「Header name」填入
Authorization。 -
在「Header type」選擇「Bearer」。
-
在「Header value」填入
gi_your_key_here。 -
在「Visibility」選擇「Private」。
-
按「Create」。
-
如果 My Connectors 中的 gamentic 要求輸入 Bearer token,請輸入金鑰再按「Connect」。
-
確認 gamentic 在 Connectors → My Connectors 顯示為已連接。
表單只有一個「Default header」欄位
-
開啟 Context → Connectors。
-
按「+ Add Connector」。
-
按「Custom MCP Connector」。
-
在「Connector name」填入
gamentic。 -
在「Server URL」填入
https://mcp.gamentic.net/mcp。 -
在「Authentication method」選擇「API Token Authentication」。
-
在「Default header」填入
Authorization: Bearer gi_your_key_here。 -
在「Visibility」選擇「Private」。
-
按「Create」。
goose 使用金鑰
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
「Extensions」位於側邊欄,按左上角的按鈕即可開啟。
-
開啟 Extensions。
-
按「Add custom extension」。
-
在「Extension Name」填入
gamentic。 -
在「Type」選擇「Streamable HTTP」。
-
在「Endpoint」填入
https://mcp.gamentic.net/mcp。 -
在「Header name」填入
Authorization。 -
在「Value」填入
Bearer gi_your_key_here。 -
按「Add」。
-
按「Add Extension」。
-
確認 gamentic 在 Extensions 顯示為已連接。
手動編輯設定檔
-
開啟
~/.config/goose/config.yaml(Windows 為%APPDATA%\Block\goose\config\config.yaml;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
yamlextensions: gamentic: enabled: true type: streamable_http name: gamentic uri: "https://mcp.gamentic.net/mcp" headers: Authorization: "Bearer gi_your_key_here" env_keys: [] envs: {} timeout: 300 -
重新啟動 goose,讓它載入新的伺服器。
LM Studio 使用金鑰
需要 LM Studio 0.3.17 以上。
把 gi_your_key_here 換成你在帳號頁「MCP 金鑰」建立的金鑰。
-
先把 LM Studio 更新到最新版本。
-
「Program」是右側邊欄中的分頁。
-
開啟 Program → Install → Edit mcp.json。
-
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
確認 gamentic 在 Program 顯示為已連接。
手動編輯設定檔
-
開啟
~/.lmstudio/mcp.json(Windows 為%USERPROFILE%\.lmstudio\mcp.json;沒有這個檔案就新增一個)。 -
加入以下內容並存檔。如果檔案裡已經有其他伺服器,把 gamentic 加在它們旁邊。
json{ "mcpServers": { "gamentic": { "url": "https://mcp.gamentic.net/mcp", "headers": { "Authorization": "Bearer gi_your_key_here" } } } } -
確認 gamentic 在 Program 顯示為已連接。
3. 確認連線成功
開啟一個新的對話,請它執行一項唯讀操作:
List my Gamentic games.
你的助理應該會呼叫 list_games,並回傳你的遊戲庫——如果是新帳號,回傳空清單也算通過。如果你看到的是驗證錯誤,請依序檢查以下項目:
| 症狀 | 原因 |
|---|---|
401,或要求你進行驗證 | 標頭缺少或格式錯誤。內容必須完全是 Bearer gi_…——中間要有空格,也要保留 gi_ 前綴。 |
| 「需要 MCP key 才能使用」 | 伺服器完全沒有收到可用的金鑰。請檢查標頭名稱是否為 Authorization。 |
| 沒有出現 Gamentic 的工具 | 用戶端尚未重新載入設定。請重新啟動用戶端,再到它的 MCP 面板確認伺服器顯示為已連線。 |
| 工具已出現,但任務中途停止 | 這是正常的重新連線。伺服器重新啟動會讓工作階段失效,用戶端會自動在背景重新初始化;如果問題持續,請重新啟動用戶端。 |
4. 為你的 AI 配置模組
在第一次製作之前,請先開啟 gamentic.net/start。這裡是 Agent Lab:共有十一個模組可以接上或拔除,它們會改變每個已連接的 AI 所收到的指示。設定會立即生效——下一次製作就會套用新的配置。
| 模組 | 適合接上的情況… |
|---|---|
| 開新遊戲問卷 | 你希望填寫一份依遊戲類型設計的表單,而不是在對話中被一題一題地詢問。 |
| 玩法藍圖自動讀取 | 面對已知的遊戲類型時,你希望採用經過驗證的藍圖,而不是從零自創機制。建議保持開啟。 |
| 預算模式 | 你想事先說明預算,並在實際花費之前,先知道這筆預算能買到什麼。 |
| Loop engineer | 你希望 AI 持續迭代,朝真正可以發佈的遊戲邁進。請搭配預算模式使用。 |
| 交付前自我測試 | 一律接上。AI 會在宣告完成之前,先執行一遍試玩檢查清單。 |
| 自我學習 | 你希望每次製作都記錄學到的經驗,讓之後的製作有更好的起點。 |
| 連線不穩模式 | 你的連線容易中斷。遊戲會改以可續傳的分段方式上傳,而不是透過一次冗長的呼叫。 |
| 角色設計先行 | 你想在寫任何遊戲程式碼之前,先確認概念圖。 |
| 美術引擎 | 你需要 sprite、背景、CG 與封面。關閉代表完全不生成圖像。 |
| 聲音 | 你需要音效、音樂與語音。關閉代表遊戲完全沒有聲音。 |
5. 開始製作
Make me a bubble shooter. Cute pastel art, about 3000 credits of budget.
Tell me the plan before you spend anything.
一次順利的執行,流程大致如下:
-
先讀規則
get_convention與get_skill會回傳標記規範、平衡建議,以及——若是已知的遊戲類型—— 取自一款真實上市遊戲的玩法藍圖。這一步免費,也正是它讓 AI 不必憑空猜測遊戲機制。 -
先估價,再詢問你
開啟預算模式時,在任何 credits 被扣除之前,你就會先看到製作範圍與小計。
-
先建立外殼
create_game會先建立一個小型的game.html外殼,接著由write_game_file為每個角色、場景與系統各寫入一個檔案。最後一個檔案寫入時,會執行真正的無頭瀏覽器測試。 -
生成美術並接進遊戲
generate_asset、character_sprite、generate_sound、generate_music。檔案資料會直接存入你的遊戲,回傳給模型的只有名稱。 -
交給你一個編輯器連結
https://gamentic.net/edit/<id>。接下來由你親自調校——請參閱編輯器。
Gamentic 不會向你收取模型 token 的費用。這部分你已經付給自己的供應商了。 Gamentic 的 credits 只用於平台上的生成,因此 3,000 credits 的預算幾乎會全部轉換成美術與聲音—— 不需要為思考的開銷預留任何費用。