模型上下文协议 (MCP)
模型上下文协议（MCP）是将大型语言模型（LLM）连接到像Back4App这样的平台的标准。本指南涵盖了如何使用MCP将Back4App连接到以下AI工具：
- 光标
- 风帆（Codium）
- Visual Studio Code（Copilot）
- Cline（VS Code扩展）
- Claude桌面版
- Claude代码
连接后，您的AI助手可以代表您与Back4App项目进行交互和查询。
使用MCP的AI代理被配置为对您的Back4App应用程序具有完全访问权限，包括创建、修改和删除资源的能力。我们强烈建议您首先在测试帐户和应用程序上进行尝试，以了解其功能和潜在影响，然后再在生产环境中使用。
先决条件
- 在 back4app.com 创建的帐户。 （每个新帐户的应用程序默认限制，如果您需要更多，请联系我们）；
- 安装了最新的 NodeJs 版本（16^）；
- 为了获得更好的结果，我们建议使用最先进的 LLM 模型和编码代理；
1 - 创建帐户密钥
首先，转到您的 Back4App 控制面板并创建个人访问令牌：
- 登录到您的 Back4App 帐户
- 将鼠标悬停在 "你好，[用户名]" 菜单上
- 转到 帐户密钥 并创建一个新密钥
- 给它一个描述其用途的名称，例如 "AI 助手 MCP"
- 安全地复制令牌 - 您将无法再次看到它
然后给你的账户密钥令牌命名，然后点击 +。
此令牌将用于使用您的 Back4app 账户对 MCP 服务器进行身份验证。
2 - 安装 MCP - 自动
按照以下步骤在您首选的 IDE/LLM 上安装 Back4app MCP：
2.1- 运行安装命令
在终端中运行此命令，将 <ide> 替换为您首选的环境，将 YOUR_ACCOUNT_KEY 替换为您在 步骤 1 中复制的账户密钥。
每个IDE的具体命令如下所示：
光标
npx @back4app/mcp-installer install cursor --account-key YOUR_ACCOUNT_KEY风筝冲浪
npx @back4app/mcp-installer install windsurf --account-key YOUR_ACCOUNT_KEYVisual Studio
npx @back4app/mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY
Cline
npx @back4app/mcp-installer install cline --account-key YOUR_ACCOUNT_KEY2.2- 验证连接
光标 : 转到设置 -> 光标设置 -> MCP
风筝冲浪: 找到Cascade输入上方的工具栏并点击刷新
Visual Studio: 点击代理模式（Copilot）上的配置工具，找到back4app MCP工具。
3 - 在您的AI工具中配置 - 手动
MCP兼容工具可以通过Back4App MCP服务器连接到Back4App。以下是使用流行AI工具连接到此服务器的说明：
- 打开光标并进入光标菜单。
- 导航到光标->设置->光标设置->MCP
- 点击 +添加新的全局MCP
然后添加以下配置：
macOS / Linux
{
"mcpServers": {
"back4app": {
"command": "npx",
"args": [
"-y",
"@back4app/mcp-server-back4app@latest",
"--account-key",
"<account-key>"
]
}
}
}Windows
{
"mcpServers": {
"back4app": {
"command": "npx.cmd",
"args": [
"-y",
"@back4app/mcp-server-back4app@latest",
"--account-key",
"<account-key>"
]
}
}
}- 将 <account-key> 替换为您从back4app复制的帐户密钥。
- 保存配置文件
替代设置
如果您更喜欢项目设置，您可以创建一个本地项目配置文件：
- 在你的项目根目录中创建一个 .cursor 目录（如果它不存在）
- 如果不存在，请创建一个 .cursor/mcp.json 文件并打开它
- 添加之前提到的配置
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 - 安全考虑
MCP 服务器完全访问您的 Back4App 账户，权限与您的个人访问令牌相同。这意味着 AI 工具可以创建、修改和覆盖您的应用和数据。始终采取以下预防措施：
- 使用专用测试账户 进行初步实验
- 创建单独的访问令牌 专门用于 MCP 使用
- 绝不要分享您的配置文件 包含访问令牌
- 审查所有代码和 API 调用 由 AI 生成或修改后再部署到生产环境
- 立即撤销访问令牌 如果您怀疑有任何未经授权的使用
5 - 故障排除
常见问题
- 连接失败: 确保您的个人访问令牌有效且正确输入
- 服务器未响应: 检查您是否已安装 Node.js，并且 npx 正常工作
- 权限错误: 验证您的访问令牌是否具有必要的权限
- 更新未出现: 一些 MCP 客户端在配置更改后需要重启
6 - 下一步
您的 AI 工具现在已通过 MCP 连接到 Back4App。尝试让您的 AI 助手创建一个新应用程序，部署一些云代码，或使用自然语言管理您的数据。
如果您遇到任何问题或有反馈，请通过以下方式给我们发送消息： [email protected]
结论
通过 Back4App 的 MCP 集成，您可以利用 AI 代理的力量加速开发工作流程。从创建和配置应用程序到部署代码和管理数据，您的 AI 助手现在可以无缝地代表您与 Back4App 平台进行交互。