mcpField
B
bkend-quickstart

bkend-quickstart

github.com/ww-w-ai開発60641 回インストール4 週間前に更新
リポジトリ

bkend-quickstart について

bkend-quickstartは、MCPベースのバックエンドプラットフォームbkend.aiをClaude Codeで設定するガイドです。OAuth接続、プロジェクトと環境の管理、利用できるMCPツールとリソースを説明します。

主な機能

  1. 01Claude CodeのMCP設定
  2. 02OAuth 2.1とPKCE
  3. 03組織とプロジェクトの管理
  4. 04環境管理
  5. 05キャッシュ付き読み取り専用リソース
  6. 06最初のテーブル作成チェックリスト

活用シーン

  1. 01Claude Codeをbkend.aiに接続
  2. 02プロジェクトと環境の作成・確認
  3. 03ドキュメントとツールスキーマの検索
  4. 04テーブルとスキーマの一覧表示

MCP 対応

HTTPトランスポートとOAuth 2.1 + PKCEを使い、Claude Codeをhttps://api.bkend.ai/mcpに接続する方法を説明します。組織、プロジェクト、環境を管理するツールと、読み取り専用リソースも紹介します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ww-w-ai/bkit-claude-code --skill bkend-quickstart

インストール後、Claude Code で/bkend-quickstartを入力して読み込まれたか確認します。

詳細

bkend.ai クイックスタートガイド

bkend.ai とは

データベース、認証、ストレージのサービスを提供する、MCP ベースの BaaS プラットフォームです。 AI ツール（Claude Code、Cursor）から自然言語でバックエンドを管理できます。

リソース階層

Organization (team/billing) -> Project (service unit) -> Environment (dev/staging/prod, data isolation)

テナントとユーザー

  • テナント：サービスの構築者（OAuth 2.1 認証、MCP／Management API へのアクセス）
  • ユーザー：アプリのエンドユーザー（JWT 認証、Service API へのアクセス）
  • 1 人が両方の役割を担うことができます

MCP のセットアップ（Claude Code）

クイックセットアップ（1 つのコマンド）
claude mcp add bkend --transport http https://api.bkend.ai/mcp
ステップごとのガイド
  1. 前提条件：bkend.ai アカウント（https://console.bkend.ai で登録）
  2. セットアップコマンドを実行：claude mcp add bkend --transport http https://api.bkend.ai/mcp
  3. OAuth 認証：OAuth 2.1 + PKCE 認証のため、ブラウザーが自動的に開きます（API キーは不要です）
  4. 接続を確認：「接続済みの bkend プロジェクトを表示して」と尋ねるか、get_context MCP ツールを使用します
  5. .mcp.json を作成（任意、チームで共有する場合）： 
    {
  "mcpServers": {
    "bkend": {
      "type": "http",
      "url": "https://api.bkend.ai/mcp"
    }
  }
}
MCP 接続のトラブルシューティング
問題解決策
OAuth ポップアップが表示されないブラウザーのポップアップブロッカーを確認してください
MCP ツールが表示されないclaude mcp list を実行して確認し、必要に応じて再追加してください
接続が失われた再認証してください（次回の MCP 呼び出し時に自動で行われます）
プロジェクト／環境が違うget_context を使用して現在のセッションを確認してください

MCP 固定ツール

ツール用途
get_contextセッションのコンテキスト（組織／プロジェクト／環境、API エンドポイント）
search_docsbkend のドキュメントを検索
get_operation_schemaツールの入力／出力スキーマを取得

検索可能なガイド（search_docs 経由）

ドキュメント ID内容
1_conceptsBSON スキーマ、権限、階層
2_tutorialプロジェクトからテーブルを作成するチュートリアル

MCP プロジェクト管理ツール

ツール用途主なパラメーター
backend_org_list組織の一覧表示なし
backend_project_listプロジェクトの一覧表示organizationId
backend_project_getプロジェクトの詳細を取得organizationId, projectId
backend_project_createプロジェクトを作成organizationId, name, description?
backend_project_updateプロジェクトを更新organizationId, projectId, name?, description?
backend_project_deleteプロジェクトを削除（元に戻せません！）organizationId, projectId
backend_env_list環境の一覧表示organizationId, projectId
backend_env_get環境の詳細を取得organizationId, projectId, environmentId
backend_env_create環境を作成organizationId, projectId, name

MCP リソース（読み取り専用）

bkend:// URI を介した、軽量でキャッシュされる（TTL 60 秒）読み取り専用のクエリです：

URI説明
bkend://orgs組織一覧
bkend://orgs/{orgId}/projectsプロジェクト一覧
bkend://orgs/{orgId}/projects/{pId}/environments環境一覧
bkend://orgs/{orgId}/projects/{pId}/environments/{eId}/tablesスキーマ付きテーブル一覧

ヒント：一覧表示の操作には、ツールよりもリソースを優先してください（軽量でキャッシュされます）。

最初のプロジェクトのチェックリスト

  1. bkend.ai に登録 -> 組織を作成
  2. プロジェクトを作成 -> dev 環境が自動作成されます
  3. MCP を接続 -> claude mcp add bkend
  4. 最初のテーブルを作成 -> 「users テーブルを作成して」
  5. データ操作を開始 -> 自然言語で CRUD を実行

コンソール URL

https://console.bkend.ai

次のステップ

  • データベース操作：bkend-data スキルを参照してください
  • 認証：bkend-auth スキルを参照してください
  • ファイルストレージ：bkend-storage スキルを参照してください
  • 実践的なチュートリアル：bkend-cookbook スキルを参照してください

公式ドキュメント（最新の参照情報）

bkend の最新ドキュメントについては、WebFetch を使用してください。

コメント

Markdown 対応