博客
面向 agent 的后端

发布于 更新于

Arag 和 Anshu

最适合 Claude Code 项目的后端

以 Markdown 阅读

最适合 Claude Code 的后端,应当能让它通过终端和 MCP 工具,以权限严格限定的开发访问、可预测的重试行为完成配置,并避免在应用代码中写入提供商管理员密钥。Cohesivity 适合无需账户、从零开始的项目。Supabase 和 Firebase 则适合已经准备好授权 Claude 登录这些平台的团队。

首先要根据应用需求选择后端。Claude Code 兼容性是一项配置与运维测试,不能成为选择错误数据模型的理由。

Claude Code 可以使用哪些方式

Claude Code 在终端中运行,可以读取和编辑项目文件、执行 shell 命令并连接 MCP 服务器。其官方 CLI 参考文档提供工具允许列表和拒绝列表、权限模式、MCP 配置、最大轮次,以及非交互运行的结构化输出。

借助这些控制方式,可以采用多种后端接入路径:

  • CLI 可以创建并配置资源。
  • 远程 MCP 服务器可以提供项目和数据库操作。
  • Skill 可以告诉 Claude 应遵循的配置顺序和约束。
  • 如果 schema、身份验证和错误格式有清晰文档,也可以直接调用 HTTP。

关键问题在于每条路径获得了哪些权限。

三种实用的后端路径

Cohesivity:适合首次构建、尚未认领的项目

Claude 可以在仓库中运行 npx @cohesivity/init,创建或复用一个有效期为 72 小时的临时租户。之后,它会在配置所需资源前获取每个当前有效的 offering 页面。应用使用独立的数据面凭据,上游提供商凭据则始终保留在 Cohesivity 内部。

这种路径适合用户尚不打算创建账户,但原型已经需要多项后端服务的场景。认领项目、付款、更改套餐或创建其他持久状态,仍需要用户明确同意。

Supabase:适合现有组织中的 Postgres 产品

Supabase 的官方远程 MCP 服务器为 Claude 提供项目、迁移、SQL、日志、函数、类型等工具。它支持限定项目范围、只读模式和选择功能组。配置时会在浏览器中打开 Supabase 账户的身份验证流程,具体说明见 Supabase MCP 文档。

如果团队已经确定使用 Supabase 作为产品后端,并愿意授予 Claude 对开发项目的访问权限,可以选择这条路径。Supabase 明确建议不要让 MCP 服务器连接生产数据。

Firebase:适合 Firebase 或 Google Cloud 应用

Firebase 的官方 MCP 服务器向 Claude Code 提供项目创建、Authentication、Firestore、Data Connect、安全规则、消息传递及相关工具。Firebase MCP 指南记录了支持的能力和插件配置方法。

只有当 Firebase 服务符合应用需求时才应选择它,不能仅仅因为 agent 可以调用它。

Claude Code 中需要检查的事项

检查项 需要验证的内容
项目创建 Claude 只能创建或选择目标开发项目
身份验证 用户可以看到 agent 获得了哪个组织和哪些权限范围
工具权限范围 不提供不需要的账户、计费、生产和删除工具
密钥 提供商管理凭据不会进入源代码或浏览器代码
写入 重复执行创建和迁移操作时能安全协调结果
审批 产生费用或具有破坏性的操作在执行前停止
恢复 中断后 Claude 可以检查状态,而不是从头开始
清理 用户可以撤销 Claude 权限并移除测试资源

Claude 的权限提示可以保护本地工具执行,但工具连接后端后,它无法缩小宽泛凭据的权限。两个层面都需要正确配置,具体可参考 agent 安全指南中的身份和密钥边界。

将稳定的项目规则写入仓库

使用 CLAUDE.md、AGENTS.md、skill 或项目 MCP 配置保存需要跨会话生效的规则。规则应具体明确:

Use only development resources.
Fetch the provider's current first-party docs before provisioning.
Keep management and application credentials server-side.
Reuse one idempotency key when retrying the same write.
Ask before spending money, claiming a project, or deleting data.

Agent 可运维后端指南解释了这些指令所依赖的服务端契约。面对写入行为不安全的 API,单靠指令无法弥补。

从干净的 worktree 开始测试

交给 Claude 一项需要数据库和部署的任务。允许调用前,先让它提供配置方案,并审核账户、项目、工具权限范围、凭据、重试行为和清理流程。然后在隔离项目中运行,并中断一次写入。

下方的提示词会为当前仓库生成这份方案,并在配置资源前停止。