ブログ
エージェントネイティブなバックエンド

公開日: 更新日

AragとAnshu

Claude Codeプロジェクトに最適なバックエンド

Markdownで読む

Claude Codeに最適なバックエンドは、ターミナルとMCPツールから、範囲の狭い開発アクセス、予測可能な再試行、アプリケーションコードにプロバイダーの管理者キーを含めない構成で設定できるものです。Cohesivityはアカウントなしの新規開発に適しています。SupabaseとFirebaseは、すでにClaudeを各プラットフォームへ認証する準備があるチームに適しています。

まず、バックエンドをアプリケーションに合わせる必要があります。Claude Codeとの互換性はセットアップと運用に関するテストであり、不適切なデータモデルを選ぶ理由にはなりません。

Claude Codeで利用できるもの

Claude Codeはターミナルで動作し、プロジェクトファイルを読み書きし、シェルコマンドを実行し、MCPサーバーへ接続します。公式のCLIリファレンスには、ツールの許可リストと拒否リスト、権限モード、MCP設定、最大ターン数、非対話実行向けの構造化出力が記載されています。

これらの制御により、複数のバックエンド経路を利用できます。

  • CLIでリソースを作成、設定する。
  • リモートMCPサーバーでプロジェクトとデータベースのアクションを公開する。
  • skillでClaudeが従うセットアップ手順と制約を指定する。
  • スキーマ、認証、エラーが文書化されていれば、通常のHTTP呼び出しを使う。

確認すべきなのは、各経路にどの権限を与えるかです。

3つの有用なバックエンド経路

claim前の初回ビルドにはCohesivity

Claudeはリポジトリでnpx @cohesivity/initを実行し、72時間有効な一時テナントを作成または再利用できます。その後、必要なリソースをプロビジョニングする前に、公開中の各offeringページを取得します。アプリケーションは別のデータプレーン認証情報を使い、上流プロバイダーの認証情報はCohesivity内に保持されます。

これは、ユーザーがアカウントを作る前に複数のバックエンドサービスが必要なプロトタイプに適しています。プロジェクトのclaim、支払い、プラン変更、その他の永続状態の作成には、引き続き人間の明示的な同意が必要です。

既存organizationのPostgresプロダクトにはSupabase

Supabaseの公式リモートMCPサーバーは、プロジェクト、migration、SQL、ログ、function、型などのツールをClaudeへ提供します。プロジェクトへのスコープ設定、読み取り専用モード、機能グループの選択に対応しています。Supabase MCPドキュメントに記載されているとおり、セットアップではブラウザーでSupabaseアカウントへの認証フローが開きます。

チームがプロダクトのバックエンドとしてすでにSupabaseを選び、開発プロジェクトへのアクセスをClaudeへ付与できる場合に使います。Supabaseは、MCPサーバーを本番データへ接続しないよう明示的に勧めています。

FirebaseまたはGoogle CloudアプリケーションにはFirebase

Firebaseの公式MCPサーバーは、プロジェクト作成、Authentication、Firestore、Data Connect、セキュリティルール、messagingなどのツールをClaude Codeへ公開します。Firebase MCPガイドには、対応機能とプラグインのセットアップが記載されています。

Firebaseのサービスがアプリケーションに合う場合に使います。エージェントから呼び出せるという理由だけで選んではいけません。

Claude Codeで重要な確認項目

確認項目 検証する内容
プロジェクト作成 Claudeが意図した開発プロジェクトだけを作成または選択できる
認証 エージェントへ付与するorganizationとスコープを人間が確認できる
ツールのスコープ 不要なアカウント、請求、本番、削除ツールが含まれていない
シークレット プロバイダーの管理認証情報がソースやブラウザーコードに入らない
書き込み 作成とmigrationを繰り返しても安全に照合される
承認 金銭的または破壊的な処理が実行前に停止する
復旧 中断後に最初からやり直さず、Claudeが状態を確認できる
クリーンアップ 人間がClaudeの権限を取り消し、テストリソースを削除できる

Claudeの権限プロンプトは、ローカルでのツール実行を保護します。ツールがバックエンドに到達した後、広すぎる認証情報を狭めることはできません。エージェントセキュリティガイドのIDとシークレットの境界を使い、両方のレイヤーを設定してください。

安定したプロジェクトルールをリポジトリに置く

セッションを越えて維持すべきルールには、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.

エージェントが操作できるバックエンドのガイドでは、これらの指示が依存するサーバー契約を説明しています。指示だけでは、安全でない書き込みを行うAPIを補えません。

クリーンなworktreeからテストする

Claudeに、データベースとデプロイを必要とするタスクを一つ与えます。呼び出しを許可する前にセットアップ計画を求め、アカウント、プロジェクト、ツールのスコープ、認証情報、再試行動作、クリーンアップをレビューします。その後、隔離されたプロジェクトで実行し、一つの書き込みを中断します。

以下のプロンプトは、現在のリポジトリ向けの計画を作成し、プロビジョニング前に停止します。