> ## Documentation Index > Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt > Use this file to discover all available pages before exploring further. # 為 Cursor、Claude、Windsurf 等編輯器設定 MCP > 透過 MCP 將 Cursor、Claude、Windsurf 與其他編輯器連接到 InsForge，讓 AI 代理可以查詢你的資料庫、身份驗證、儲存與函式。 ## 概觀 InsForge MCP 伺服器讓你的 AI 程式碼助手可以直接存取你的後端：資料庫查詢、結構描述管理、儲存空間等等。 請依照以下針對你所使用 AI 用戶端的說明操作。找不到你的工具？瀏覽[代理目錄](https://insforge.dev/agents)查看完整的已測試整合清單。 ## 先決條件 * 一個 **AI 程式碼助手**（Cursor、Claude Code、GitHub Copilot 等） * 一個 **InsForge 專案** - 如果還沒有，[點此建立](https://insforge.dev) ## 本機 MCP 設定（建議） 如果你偏好在本機設定 MCP，請在下方選擇你的 AI 程式碼助手： ### 安裝 你可以在 Cursor 中點選下方截圖裡的「Add to Cursor」按鈕，一鍵安裝 MCP 伺服器： 連接專案 或者，你也可以手動安裝 InsForge MCP 伺服器： 1. 開啟 **Cursor Settings** 2. 前往 **Tools & MCP** 3. 點選 **New MCP Server (Add a Custom MCP Server)** ### 安裝 將 InsForge MCP 伺服器新增到你的 **Claude Code**： 1. 在下拉選單中選擇 **Claude Code** 2. 複製以下安裝指令並貼到你的終端機中 Claude Code 連接 3. 執行該指令 ### 安裝 將 InsForge MCP 伺服器新增到你的 **GitHub Copilot**： 1. 在下拉選單中選擇 **Copilot** 2. 開啟終端機，將以下安裝指令貼到你的 **GitHub Copilot** 終端機中 Copilot 設定 3. 執行該指令 Copilot 安裝 ### 驗證安裝 要驗證連接，請在 **Copilot** 中開啟一個新的聊天工作階段，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Antigravity**： 1. 在下拉選單中選擇 **Antigravity** 2. 複製以下安裝指令並貼到你的 **Antigravity** 終端機中 Antigravity 設定 3. 執行該指令 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Kiro**： 1. 在下拉選單中選擇 **Kiro** 2. 複製以下安裝指令並貼到你的 **Kiro** 終端機中 Kiro 設定 3. 執行該指令 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Codex**： 1. 在下拉選單中選擇 **Codex** 2. 複製以下安裝指令並貼到你的終端機中 Codex 設定 3. 執行該指令 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Cline**： 1. 在下拉選單中選擇 **Cline** 2. 複製以下安裝指令並貼到你的 **Cline** 終端機中 Cline 設定 3. 執行該指令 Cline 安裝 ### 驗證安裝 要驗證連接，請在 **Cline** 中開啟一個新的聊天工作階段，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Windsurf**： 1. 在下拉選單中選擇 **Windsurf** 2. 複製以下安裝指令並貼到你的 Windsurf 終端機中 Windsurf 設定 3. 執行該指令 ### 驗證安裝 要驗證連接，請在 **Windsurf** 中開啟一個新的聊天工作階段，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Trae**： 1. 在下拉選單中選擇 **Trae** 2. 複製以下安裝指令並貼到你的 **Trae** 終端機中 Trae 設定 3. 執行該指令 Trae 安裝 此外，Trae 也提供與 InsForge 的第一方整合，讓你可以直接從 Trae 的官方 MCP 市集安裝 InsForge： 1. 開啟 Trae 的 **Settings** → 前往 **MCP** 2. 點選 **Add**，然後選擇 **Add from Marketplace** 3. 搜尋「InsForge」並從市集中新增 Trae 市集 4. 所需的憑證 API\_KEY 與 API\_BASE\_URL，可以在你的 InsForge **Settings** 中的 **Connect** 分頁下找到 Trae 憑證 ### 驗證安裝 要驗證連接，請在 **Trae** 中開啟一個新的聊天，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Qoder**： 1. 在下拉選單中選擇 **Qoder** 2. 複製以下安裝指令並貼到你的 **Qoder** 終端機中 Qoder 設定 3. 執行該指令 ### 驗證安裝 要驗證連接，請在 **Qoder** 中開啟一個新的聊天工作階段，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ### 安裝 將 InsForge MCP 伺服器新增到你的 **Roo Code**： 1. 在下拉選單中選擇 **Roo Code** 2. 複製以下安裝指令並貼到你的 **Roo Code** 終端機中 Roo Code 設定 3. 執行該指令 ### 驗證安裝 要驗證連接，請在 **Roo Code** 中開啟一個新的聊天工作階段，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ### 安裝 將 InsForge MCP 伺服器新增到你的 **OpenCode**： 1. 在下拉選單中選擇 **OpenCode** 2. 複製以下安裝指令並貼到你的終端機中 連接專案 3. 執行該指令 ### 驗證安裝 要驗證連接，請在 **OpenCode** 中開啟一個新的聊天工作階段，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ### 安裝 使用 MCP JSON 將 InsForge MCP 伺服器新增到你的程式碼代理： 1. 在下拉選單中選擇 **MCP JSON** 2. 將以下 **MCP JSON** 設定複製並貼到你的代理中 MCP JSON 設定 ### 驗證安裝 要驗證連接，請開啟一個新的聊天工作階段，並將以下提示詞傳送給你的代理： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ## 遠端 MCP 最快的入門方式是使用遠端 MCP。單一指令即可嘗試安裝，並會嘗試自動處理身份驗證與專案綁定，但如果自動流程無法完成，仍可能會提示你手動完成身份驗證或專案綁定步驟。 在你的終端機中執行以下指令： ```bash theme={null} npx add-mcp https://mcp.insforge.dev/mcp ``` `add-mcp` 指令適用於大多數程式碼代理，但並非全部。目前它支援： Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Goose、GitHub Copilot、OpenCode、VS Code、Zed。 執行該指令後，系統會自動為你的程式碼代理產生一份設定檔。 ### 連接並綁定專案 有些 MCP 用戶端會在設定過程中自動提示你登入，而其他用戶端若自動流程無法完成，則可能需要手動進行身份驗證或專案綁定步驟。無論哪種方式，身份驗證都會開啟一個瀏覽器視窗，你可以在其中登入你的 InsForge 帳戶，並授予 MCP 用戶端組織/專案存取權限。 你可以在 `.cursor/mcp.json` 中找到設定檔，如下所示： ```json theme={null} { "mcpServers": { "insforge": { "url": "https://mcp.insforge.dev/mcp" } } } ``` 在選單 **Preferences → Cursor Settings → Tools & MCP** 中，你應該會看到 InsForge MCP 伺服器已成功新增。 InsForge MCP 伺服器狀態為「Needs authentication」，你可以點選 `connect` 按鈕進行身份驗證。 安裝完成後，你會在 `.mcp.json` 中找到如下設定檔： ```json theme={null} { "mcpServers": { "insforge": { "type": "http", "url": "https://mcp.insforge.dev/mcp" } } } ``` 然後在一般終端機（而非 IDE 擴充功能）中執行： ```sh theme={null} claude /mcp ``` 選擇「insforge」伺服器，然後選擇「Authenticate」以開始身份驗證流程。 安裝完成後，你會在 `.vscode/mcp.json` 中找到如下設定檔： ```json theme={null} { "servers": { "insforge": { "type": "http", "url": "https://mcp.insforge.dev/mcp" } } } ``` 將以下設定新增到 `~/.gemini/antigravity/mcp_config.json`： ```json theme={null} { "mcpServers": { "insforge": { "serverUrl": "https://mcp.insforge.dev/mcp" } } } ``` 然後重新啟動 Antigravity，它會自動進行身份驗證。 安裝完成後，你會在 `.gemini/settings.json` 中找到如下設定檔： ```json theme={null} { "mcpServers": { "insforge": { "type": "http", "url": "https://mcp.insforge.dev/mcp" } } } ``` 啟動 Gemini CLI 並執行以下指令以對伺服器進行身份驗證： ```sh theme={null} /mcp auth insforge ``` 如果你是第一次使用 Codex，可能需要啟用 rmcp 功能。請在你的 `~/.codex/config.toml` 檔案中加入以下內容： ```toml theme={null} [beta] rmcp = true ``` 安裝完成後，你會在 `.codex/config.toml` 中找到如下設定檔： ```toml theme={null} [mcp_servers.insforge] type = "http" url = "https://mcp.insforge.dev/mcp" ``` 然後進行身份驗證： ```sh theme={null} codex mcp login insforge ``` 最後，在 Codex 中執行 /mcp 以驗證身份驗證。 或者，你也可以執行以下指令來安裝 MCP 伺服器： ```sh theme={null} codex mcp add insforge --url https://mcp.insforge.dev/mcp ``` 你可以在終端機中執行以下指令，將 InsForge MCP 伺服器安裝到你的 **Cline**： ```bash theme={null} npx -y @smithery/cli mcp add devel/insforge --client cline ``` 或者，你也可以參考官方 [Cline 文件](https://docs.cline.bot/mcp/connecting-to-a-remote-server)，以下列參數新增 InsForge MCP 伺服器： * Server Name: `insforge` * Server URL: `https://mcp.insforge.dev/mcp` * Transport Type: `Streamable HTTP` 新增伺服器後，你會看到一則要求進行身份驗證的錯誤訊息。點選出現的「Authenticate」按鈕進行身份驗證。 將以下設定新增到 `~/.codeium/windsurf/mcp_config.json`： ```json theme={null} { "mcpServers": { "insforge": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.insforge.dev/mcp" ] } } } ``` Windsurf 目前不支援透過 HTTP 傳輸的遠端 MCP 伺服器。你需要使用 mcp-remote 套件作為代理伺服器。 你可以在終端機中執行以下指令，將 InsForge MCP 伺服器安裝到你的 **Roo Code**： ```bash theme={null} npx -y @smithery/cli mcp add devel/insforge --client roocode ``` 安裝完成後，你會在 `./opencode.json` 中找到如下設定檔： ```json theme={null} { "mcp": { "insforge": { "type": "remote", "url": "https://mcp.insforge.dev/mcp", "enabled": true } } } ``` 然後執行以下指令進行身份驗證： ```sh theme={null} opencode mcp auth insforge ``` 這將開啟你的瀏覽器以完成 OAuth 身份驗證流程。 ### 驗證安裝 要驗證連接，請在你的 AI 程式碼助手中開啟一個新的聊天工作階段，並傳送以下提示詞： ``` I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions. ``` 如果連接成功，你會在 InsForge 儀表板（右上角）看到 **MCP Connected** 狀態指示。 MCP 已連接 ## 疑難排解 大多數 AI 用戶端在 MCP 設定變更後需要完全重新啟動。請關閉並重新開啟應用程式。