为 Cursor、Claude、Windsurf 等编辑器设置 MCP

概述

InsForge MCP 服务器让你的 AI 编程助手可以直接访问你的后端：数据库查询、模式管理、存储等。请按照以下针对你的 AI 客户端的说明进行操作。没有看到你的工具？浏览智能体目录查看完整的已测试集成列表。

前提条件

一个 AI 编程助手（Cursor、Claude Code、GitHub Copilot 等）
一个 InsForge 项目 - 如果还没有，点此创建

本地 MCP 配置（推荐）

如果你更喜欢在本地配置 MCP，请在下方选择你的 AI 编程助手：

Cursor

安装

你可以在 Cursor 中点击下方截图里的 “Add to Cursor” 按钮，一键安装 MCP 服务器：

或者，你也可以手动安装 InsForge MCP 服务器：

打开 Cursor Settings
进入 Tools & MCP
点击 New MCP Server (Add a Custom MCP Server)

粘贴来自你 InsForge 项目的 MCP JSON
保存配置文件
你应该会看到一个绿点，表示 InsForge 已成功安装

验证安装

要验证连接，请在 Cursor 中开始一个新的聊天会话，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 Connected 状态指示。

Claude Code

安装

将 InsForge MCP 服务器添加到你的 Claude Code：

在下拉列表中选择 Claude Code
复制以下安装命令并粘贴到你的终端中
运行该命令

验证安装

要验证连接，请在 Claude Code 中开始一个新的聊天会话，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 MCP Connected 状态指示。

GitHub Copilot

安装

将 InsForge MCP 服务器添加到你的 GitHub Copilot：

在下拉列表中选择 Copilot
打开终端，将以下安装命令粘贴到你的 GitHub 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 状态指示。

Google Antigravity

安装

将 InsForge MCP 服务器添加到你的 Antigravity：

在下拉列表中选择 Antigravity
复制以下安装命令并粘贴到你的 Antigravity 终端中
运行该命令

验证安装

要验证连接，请在 Antigravity 中开始一个新的聊天会话，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 MCP Connected 状态指示。

Kiro

安装

将 InsForge MCP 服务器添加到你的 Kiro：

在下拉列表中选择 Kiro
复制以下安装命令并粘贴到你的 Kiro 终端中
运行该命令

验证安装

要验证连接，请在 Kiro 中开始一个新的聊天会话，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 MCP Connected 状态指示。

Codex

安装

将 InsForge MCP 服务器添加到你的 Codex：

在下拉列表中选择 Codex
复制以下安装命令并粘贴到你的终端中
运行该命令

验证安装

要验证连接，请在 Codex 中开始一个新的聊天会话，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 MCP Connected 状态指示。

Cline

安装

将 InsForge MCP 服务器添加到你的 Cline：

在下拉列表中选择 Cline
复制以下安装命令并粘贴到你的 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 状态指示。

Windsurf

安装

将 InsForge MCP 服务器添加到你的 Windsurf：

在下拉列表中选择 Windsurf
复制以下安装命令并粘贴到你的 Windsurf 终端中
运行该命令

验证安装

要验证连接，请在 Windsurf 中开始一个新的聊天会话，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 MCP Connected 状态指示。

Trae

安装

将 InsForge MCP 服务器添加到你的 Trae：

在下拉列表中选择 Trae
复制以下安装命令并粘贴到你的 Trae 终端中
运行该命令

另外，Trae 还提供与 InsForge 的官方原生集成，你可以直接从 Trae 的官方 MCP 市场安装 InsForge：

打开 Trae 的 Settings → 进入 MCP
点击 Add，然后选择 Add from Marketplace
搜索 “InsForge” 并从市场中添加
所需的凭据 API_KEY 和 API_BASE_URL，可以在你的 InsForge Settings 中的 Connect 选项卡下找到

验证安装

要验证连接，请在 Trae 中开始一个新的聊天，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 MCP Connected 状态指示。

Qoder

安装

将 InsForge MCP 服务器添加到你的 Qoder：

在下拉列表中选择 Qoder
复制以下安装命令并粘贴到你的 Qoder 终端中
运行该命令

验证安装

要验证连接，请在 Qoder 中开始一个新的聊天会话，并向你的智能体发送以下提示词：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

如果连接成功，你会在 InsForge 控制台（右上角）看到 MCP Connected 状态指示。

Roo Code

安装

将 InsForge MCP 服务器添加到你的 Roo Code：

在下拉列表中选择 Roo Code
复制以下安装命令并粘贴到你的 Roo Code 终端中
运行该命令

验证安装

要验证连接，请在 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 状态指示。

OpenCode

安装

将 InsForge MCP 服务器添加到你的 OpenCode：

在下拉列表中选择 OpenCode
复制以下安装命令并粘贴到你的终端中
运行该命令

验证安装

要验证连接，请在 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 JSON

安装

使用 MCP JSON 将 InsForge MCP 服务器添加到你的编程智能体：

在下拉列表中选择 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。一条命令即可尝试安装，并会尝试自动处理身份验证和项目绑定，但如果自动流程无法完成，仍可能会提示你手动完成身份验证或项目绑定步骤。在你的终端中运行以下命令：

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

你可以在 .cursor/mcp.json 中找到配置文件，如下所示：

{
  "mcpServers": {
    "insforge": {
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

在菜单 Preferences → Cursor Settings → Tools & MCP 中，你应该会看到 InsForge MCP 服务器已成功添加。 InsForge MCP 服务器状态为 “Needs authentication”，你可以点击 connect 按钮进行身份验证。

Claude Code

安装完成后，你会在 .mcp.json 中找到如下配置文件：

{
  "mcpServers": {
    "insforge": {
      "type": "http",
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

然后在常规终端（而非 IDE 扩展）中运行：

claude /mcp

选择 “insforge” 服务器，然后选择 “Authenticate” 开始身份验证流程。

GitHub Copilot

安装完成后，你会在 .vscode/mcp.json 中找到如下配置文件：

{
  "servers": {
    "insforge": {
      "type": "http",
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

Google Antigravity

将以下配置添加到 ~/.gemini/antigravity/mcp_config.json：

{
  "mcpServers": {
    "insforge": {
      "serverUrl": "https://mcp.insforge.dev/mcp"
    }
  }
}

然后重启 Antigravity，它会自动进行身份验证。

Gemini

安装完成后，你会在 .gemini/settings.json 中找到如下配置文件：

{
  "mcpServers": {
    "insforge": {
      "type": "http",
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

启动 Gemini CLI 并运行以下命令以对服务器进行身份验证：

/mcp auth insforge

Codex

如果你是第一次使用 Codex，可能需要启用 rmcp 功能。为此，请在你的 ~/.codex/config.toml 文件中添加以下内容：

[beta]
rmcp = true

安装完成后，你会在 .codex/config.toml 中找到如下配置文件：

[mcp_servers.insforge]
type = "http"
url = "https://mcp.insforge.dev/mcp"

然后进行身份验证：

codex mcp login insforge

最后，在 Codex 中运行 /mcp 以验证身份验证。或者，你也可以运行以下命令来安装 MCP 服务器：

codex mcp add insforge --url https://mcp.insforge.dev/mcp

Cline

你可以在终端中运行以下命令，将 InsForge MCP 服务器安装到你的 Cline：

npx -y @smithery/cli mcp add devel/insforge --client cline

或者，你也可以参考官方 Cline 文档，通过以下参数添加 InsForge MCP 服务器：

Server Name: insforge
Server URL: https://mcp.insforge.dev/mcp
Transport Type: Streamable HTTP

添加服务器后，你会看到一条要求进行身份验证的错误消息。点击出现的 “Authenticate” 按钮进行身份验证。

Windsurf

将以下配置添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.insforge.dev/mcp"
      ]
    }
  }
}

Windsurf 目前不支持通过 HTTP 传输的远程 MCP 服务器。你需要使用 mcp-remote 包作为代理。

Roo Code

你可以在终端中运行以下命令，将 InsForge MCP 服务器安装到你的 Roo Code：

npx -y @smithery/cli mcp add devel/insforge --client roocode

OpenCode

安装完成后，你会在 ./opencode.json 中找到如下配置文件：

{
  "mcp": {
    "insforge": {
      "type": "remote",
      "url": "https://mcp.insforge.dev/mcp",
      "enabled": true
    }
  }
}

然后运行以下命令进行身份验证：

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 状态指示。

故障排查

更改未生效

大多数 AI 客户端在 MCP 配置更改后需要完全重启。请关闭并重新打开应用程序。

​概述

​前提条件

​本地 MCP 配置（推荐）

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​安装

​验证安装

​远程 MCP

​连接并绑定项目

​验证安装

​故障排查

概述

前提条件

本地 MCP 配置（推荐）

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

安装

验证安装

远程 MCP

连接并绑定项目

验证安装

故障排查