模型上下文协议 (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 key visual studio npx @back4app/mcp installer install vscode account key your account key cline npx @back4app/mcp installer install cline account key your account key 2 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 文件并打开它 添加之前提到的配置 风帆冲浪 打开风帆冲浪并导航到cascade助手 点击锤子（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>" ] } } } 用你从back4app复制的账户密钥替换 \<account key> 。 保存配置文件并通过点击cascade助手中的刷新来重新加载 在服务器成功连接后，你应该看到一个绿色的活动状态 visual studio(copilot) 打开 vs code 并在项目根目录中创建一个 vscode 目录（如果不存在的话） 如果不存在，请创建一个 vscode/mcp json 文件并打开它 添加以下配置： macos / linux { "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 { "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}" } } } } 保存配置文件 打开 copilot 聊天并切换到 "agent" 模式。您应该会看到一个工具图标，您可以点击它以确认 mcp 工具可用 一旦您开始使用服务器，系统会提示您输入个人访问令牌。输入您之前创建的令牌 有关在 vs code 中使用 mcp 的更多信息，请参阅 copilot 文档。 cline 在 vs code 中打开 cline 扩展并点击 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 复制的帐户密钥。 保存配置文件。cline 应该会自动重新加载配置 您应该在服务器成功连接后看到绿色的活动状态 claude 桌面 打开 claude 桌面并导航到设置 在开发者选项卡下，点击编辑配置以打开配置文件 添加以下配置： 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 复制的帐户密钥。 保存配置文件并重启 claude 桌面 在新的聊天界面中，您应该看到一个锤子（mcp）图标出现，表示新的 mcp 服务器可用 过时的 node js 安装可能导致 npx 命令在 claude 桌面中失败。我们建议卸载任何版本低于 16 的 node js，并使用 node js v16 或更高版本。 claude 代码 如果不存在，请在项目根目录中创建一个 mcp json 文件 添加以下配置： 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 复制的帐户密钥。 保存配置文件 重启 claude 代码以应用新配置 过时的 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 安全考虑 mcp 服务器完全访问您的 back4app 账户，权限与您的个人访问令牌相同。这意味着 ai 工具可以创建、修改和覆盖您的应用和数据。始终采取以下预防措施： 使用专用测试账户 进行初步实验 创建单独的访问令牌 专门用于 mcp 使用 绝不要分享您的配置文件 包含访问令牌 审查所有代码和 api 调用 由 ai 生成或修改后再部署到生产环境 立即撤销访问令牌 如果您怀疑有任何未经授权的使用 5 故障排除 常见问题 连接失败 确保您的个人访问令牌有效且正确输入 服务器未响应 检查您是否已安装 node js，并且 npx 正常工作 权限错误 验证您的访问令牌是否具有必要的权限 更新未出现 一些 mcp 客户端在配置更改后需要重启 6 下一步 您的 ai 工具现在已通过 mcp 连接到 back4app。尝试让您的 ai 助手创建一个新应用程序，部署一些云代码，或使用自然语言管理您的数据。 如果您遇到任何问题或有反馈，请通过以下方式给我们发送消息： community\@back4app com 结论 通过 back4app 的 mcp 集成，您可以利用 ai 代理的力量加速开发工作流程。从创建和配置应用程序到部署代码和管理数据，您的 ai 助手现在可以无缝地代表您与 back4app 平台进行交互。