--- title: 模型上下文协议 (MCP) slug: docs-ch/eIEyX0e7WF9xCshy7znem description: 在本综合指南中，通过模型上下文协议 (MCP) 发掘大型语言模型 (LLM) 的潜力。了解如何将 AI 工具如 Cursor、Windsurf 和 Visual Studio Code 与 Back4App 无缝集成。发现分步说明 createdAt: 2025-04-29T20:19:47.638Z --- 模型上下文协议（MCP）是将大型语言模型（LLM）连接到像Back4App这样的平台的标准。本指南涵盖了如何使用MCP将Back4App连接到以下AI工具： - 光标 - 风帆（Codium） - Visual Studio Code（Copilot） - Cline（VS Code扩展） - Claude桌面版 - Claude代码 连接后，您的AI助手可以代表您与Back4App项目进行交互和查询。 :::hint{type="warning"} 使用MCP的AI代理被配置为对您的Back4App应用程序具有完全访问权限，包括创建、修改和删除资源的能力。我们强烈建议您首先在测试帐户和应用程序上进行尝试，以了解其功能和潜在影响，然后再在生产环境中使用。 ::: ## 先决条件 1. 在 back4app.com 创建的帐户。 （每个新帐户的应用程序默认限制，如果您需要更多，请联系我们）； 2. 安装了最新的 NodeJs 版本（16^）； 3. 为了获得更好的结果，我们建议使用最先进的 LLM 模型和编码代理； 4. [激活网络托管](https://www.back4app.com/docs/platform/activating-web-hosting) 以可视化您子域上的部署； ## 1 - 创建帐户密钥 首先，转到您的 Back4App 控制面板并创建个人访问令牌： 1. 登录到您的 Back4App 帐户 2. 将鼠标悬停在 "你好，\[用户名]" 菜单上 3. 转到 **帐户密钥** 并创建一个新密钥 4. 给它一个描述其用途的名称，例如 "AI 助手 MCP" 5. 安全地复制令牌 - 您将无法再次看到它 ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/Vtf9h_neBfwWz0MOTYGb8_screenshot-2024-11-28-at-164118.png" size="56" width="622" height="488" position="center" showCaption="false"} 然后给你的账户密钥令牌命名，然后点击 +。 ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/8PVJ3_IeA8HBRTy-uIO3y_image.png" size="66" width="626" height="251" position="center" showCaption="false"} 此令牌将用于使用您的 Back4app 账户对 MCP 服务器进行身份验证。 ## 2 - 安装 MCP - 自动 按照以下步骤在您首选的 IDE/LLM 上安装 Back4app MCP： ### 2.1- 运行安装命令 在终端中运行此命令，将 `` 替换为您首选的环境，将 YOUR\_ACCOUNT\_KEY 替换为您在 **步骤 1** 中复制的账户密钥。 每个IDE的具体命令如下所示： **光标 ** ```bash npx @back4app/mcp-installer install cursor --account-key YOUR_ACCOUNT_KEY ``` **风筝冲浪 ** ```bash npx @back4app/mcp-installer install windsurf --account-key YOUR_ACCOUNT_KEY ``` **Visual Studio ** ```bash npx @back4app/mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY ``` **** **Cline** ```bash npx @back4app/mcp-installer install cline --account-key YOUR_ACCOUNT_KEY ``` ### 2.2- 验证连接 **光标** : 转到设置 -> 光标设置 -> MCP ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/T0J8l4WXPTFY5NvECNNyE_image.png" size="66" width="1108" height="530" position="center" showCaption="false"} **风筝冲浪:** 找到Cascade输入上方的工具栏并点击刷新 ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/ZDSDM3KpJvUjHSUOXWZNS_image.png" size="84" width="746" height="144" position="center" showCaption="false"} **Visual Studio:** 点击代理模式（Copilot）上的配置工具，找到back4app MCP工具。 ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/K1JQ7h0Akw9R4vkwDLgxT_image.png" size="68" width="998" height="268" position="center" showCaption="false"} ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/XBOptYUJCZrJHYWp51Aij_image.png" size="80" width="1224" height="622" position="center" showCaption="false"} ## 3 - 在您的AI工具中配置 - 手动 MCP兼容工具可以通过Back4App MCP服务器连接到Back4App。以下是使用流行AI工具连接到此服务器的说明： :::ExpandableHeading{isOpen="true"} ### 光标 1. 打开光标并进入光标菜单。 2. 导航到光标->设置->光标设置->MCP 3. 点击 +添加新的全局MCP ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/YzKx3lkm0svvSRTOv6A5W_image.png) 然后添加以下配置： **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **Windows** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. 将 `` 替换为您从back4app复制的帐户密钥。 2. 保存配置文件 ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/yjyGhtyrINZlB9OY9o5rx_image.png) ::: **替代设置** 如果您更喜欢项目设置，您可以创建一个本地项目配置文件： 1. 在你的项目根目录中创建一个 `.cursor` 目录（如果它不存在） 2. 如果不存在，请创建一个 `.cursor/mcp.json` 文件并打开它 3. 添加之前提到的配置 :::ExpandableHeading{isOpen="true"} ### 风帆冲浪 1. 打开风帆冲浪并导航到Cascade助手 2. 点击锤子（MCP）图标，然后配置以打开配置文件 3. 添加以下配置： **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **Windows** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. 用你从back4app复制的账户密钥替换 `` 。 2. 保存配置文件并通过点击Cascade助手中的刷新来重新加载 3. 在服务器成功连接后，你应该看到一个绿色的活动状态 ::: :::ExpandableHeading ### Visual Studio(Copilot) 1. 打开 VS Code 并在项目根目录中创建一个 `.vscode` 目录（如果不存在的话） 2. 如果不存在，请创建一个 `.vscode/mcp.json` 文件并打开它 3. 添加以下配置： **macOS / Linux** ```json { "inputs": [ { "type": "promptString", "id": "back4app-account-key", "description": "Back4App 个人访问令牌", "password": true } ], "servers": { "back4app": { "command": "npx", "args": ["-y", "@back4app/mcp-server-back4app@latest"], "env": { "BACK4APP_ACCOUNT_KEY": "${input:back4app-account-key}" } } } } ``` **Windows** ```json { "inputs": [ { "type": "promptString", "id": "back4app-account-key", "description": "Back4App 个人访问令牌", "password": true } ], "servers": { "back4app": { "command": "npx.cmd", "args": ["-y", "@back4app/mcp-server-back4app@latest"], "env": { "BACK4APP_ACCOUNT_KEY": "${input:back4app-account-key}" } } } } ``` 1. 保存配置文件 2. 打开 Copilot 聊天并切换到 "Agent" 模式。您应该会看到一个工具图标，您可以点击它以确认 MCP 工具可用 3. 一旦您开始使用服务器，系统会提示您输入个人访问令牌。输入您之前创建的令牌 有关在 VS Code 中使用 MCP 的更多信息，请参阅 Copilot 文档。 ::: :::ExpandableHeading ### Cline 1. 在 VS Code 中打开 Cline 扩展并点击 MCP 服务器图标 2. 点击配置 MCP 服务器以打开配置文件 3. 添加以下配置： **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **Windows** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. 将 `` 替换为您从 back4app 复制的帐户密钥。 2. 保存配置文件。Cline 应该会自动重新加载配置 3. 您应该在服务器成功连接后看到绿色的活动状态 ::: ::::ExpandableHeading ### Claude 桌面 1. 打开 Claude 桌面并导航到设置 2. 在开发者选项卡下，点击编辑配置以打开配置文件 3. 添加以下配置： **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **Windows** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. 将 `` 替换为您从 back4app 复制的帐户密钥。 2. 保存配置文件并重启 Claude 桌面 3. 在新的聊天界面中，您应该看到一个锤子（MCP）图标出现，表示新的 MCP 服务器可用 :::hint{type="warning"} 过时的 Node.js 安装可能导致 npx 命令在 Claude 桌面中失败。我们建议卸载任何版本低于 16 的 Node.js，并使用 Node.js v16 或更高版本。 ::: :::: ::::ExpandableHeading ### Claude 代码 1. 如果不存在，请在项目根目录中创建一个 `.mcp.json` 文件 2. 添加以下配置： **macOS / Linux** ```json { "mcpServers": { "back4app": { "command": "npx", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` **Windows** ```json { "mcpServers": { "back4app": { "command": "npx.cmd", "args": [ "-y", "@back4app/mcp-server-back4app@latest", "--account-key", "" ] } } } ``` 1. 将 `` 替换为您从 back4app 复制的帐户密钥。 2. 保存配置文件 3. 重启 Claude 代码以应用新配置 :::hint{type="warning"} 过时的 Node.js 安装可能导致 Claude 代码中的 npx 命令失败。我们建议卸载任何早于 16 的版本，并使用 Node.js v16 或更高版本。 ::: :::: ## 3 - 可用工具 一旦连接，您的AI助手可以在您的Back4App帐户上执行广泛的任务。以下是一些可用的工具： ### 应用管理 - **create\_parse\_app** - 创建一个新的 Parse 应用 - **get\_parse\_apps** - 获取您所有 Parse 应用的列表 - **get\_parse\_app** - 获取特定 Parse 应用的详细信息 - **set\_current\_app** - 设置一个默认应用以供后续操作使用 - **get\_current\_app** - 获取当前设置的默认应用 ### 直接 API 访问 (Parse REST API) - **call\_parse\_api** - 调用 Parse 服务器 REST API 端点以完全管理您的应用。 **数据库操作** – 在任何类中创建、读取、更新、删除对象 – 丰富的查询（过滤、排序、分页、计数、聚合、去重） **用户管理与安全** – 注册 / 登录 / 登出 / 密码重置 – 角色、ACL 和 CLP 用于在对象和类级别锁定数据 **实时与推送** – 通过 WebSockets 的 LiveQuery（订阅创建/更新/删除） – 推送通知和安装记录 **调用云代码函数** – 云函数和定时任务 – 前/后触发器，自定义 Webhook **文件、分析与扩展** – 文件上传/下载 ### Parse 应用上的云代码和网络托管 - **列出云代码和网络托管文件** - 列出所有云代码和网络托管文件 - **获取文件内容** - 查看特定文件的内容 - **部署云代码文件** - 将云代码文件部署到您的应用 - **部署网络托管文件** - 将网络托管文件部署到您的应用 ## 4 - 安全考虑 :::hint{type="danger"} MCP 服务器完全访问您的 Back4App 账户，权限与您的个人访问令牌相同。这意味着 AI 工具可以创建、修改和覆盖您的应用和数据。始终采取以下预防措施： ::: 1. **使用专用测试账户** 进行初步实验 2. **创建单独的访问令牌** 专门用于 MCP 使用 3. **绝不要分享您的配置文件** 包含访问令牌 4. **审查所有代码和 API 调用** 由 AI 生成或修改后再部署到生产环境 5. **立即撤销访问令牌** 如果您怀疑有任何未经授权的使用 ## 5 - 故障排除 ### 常见问题 - **连接失败**: 确保您的个人访问令牌有效且正确输入 - **服务器未响应**: 检查您是否已安装 Node.js，并且 npx 正常工作 - **权限错误**: 验证您的访问令牌是否具有必要的权限 - **更新未出现**: 一些 MCP 客户端在配置更改后需要重启 ## 6 - 下一步 您的 AI 工具现在已通过 MCP 连接到 Back4App。尝试让您的 AI 助手创建一个新应用程序，部署一些云代码，或使用自然语言管理您的数据。 如果您遇到任何问题或有反馈，请通过以下方式给我们发送消息： [community@back4app.com](mailto\:community@back4app.com) ## 结论 通过 Back4App 的 MCP 集成，您可以利用 AI 代理的力量加速开发工作流程。从创建和配置应用程序到部署代码和管理数据，您的 AI 助手现在可以无缝地代表您与 Back4App 平台进行交互。