Skill

bkend-quickstart

Guides bkend.ai BaaS onboarding: MCP setup in Claude Code via bash commands, Org/Project/Env hierarchy, Tenant/User roles, project tools like backend_project_create.

Bash

backend

devops

Install

npx claudepluginhub popup-studio-ai/bkit-claude-code --plugin bkit

Tool Access

This skill is limited to using the following tools:

ReadWebFetchmcp__bkend__*

Preview

MCP-based BaaS platform providing Database, Authentication, and Storage services.

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Stars513

Forks130

Last CommitApr 8, 2026

Actions

View Source View Plugin View on GitHub View README

bkend.ai Quick Start Guide

What is bkend.ai

MCP-based BaaS platform providing Database, Authentication, and Storage services. Manage backend via natural language from AI tools (Claude Code, Cursor).

Resource Hierarchy

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

Tenant vs User

Tenant: Service builder (OAuth 2.1 auth, MCP/Management API access)
User: App end-user (JWT auth, Service API access)
One person can have both roles

MCP Setup (Claude Code)

Quick Setup (One Command)

claude mcp add bkend --transport http https://api.bkend.ai/mcp

Step-by-Step Guide

Prerequisites: bkend.ai account (signup at https://console.bkend.ai)
Run setup command: claude mcp add bkend --transport http https://api.bkend.ai/mcp
OAuth authentication: Browser auto-opens for OAuth 2.1 + PKCE auth (no API key needed)
Verify connection: Ask "Show my connected bkend projects" or use get_context MCP tool

Create .mcp.json (optional, for team sharing):

{
  "mcpServers": {
    "bkend": {
      "type": "http",
      "url": "https://api.bkend.ai/mcp"
    }
  }
}

Troubleshooting MCP Connection

Problem	Solution
OAuth popup not appearing	Check browser popup blocker
MCP tools not visible	Run `claude mcp list` to verify, re-add if needed
Connection lost	Re-authenticate (automatic on next MCP call)
Wrong project/env	Use `get_context` to check current session

MCP Fixed Tools

Tool	Purpose
`get_context`	Session context (org/project/env, API endpoint)
`search_docs`	Search bkend documentation
`get_operation_schema`	Get tool input/output schema

Searchable Guides (via search_docs)

Doc ID	Content
`1_concepts`	BSON schema, permissions, hierarchy
`2_tutorial`	Project~table creation tutorial

MCP Project Management Tools

Tool	Purpose	Key Parameters
`backend_org_list`	List organizations	None
`backend_project_list`	List projects	organizationId
`backend_project_get`	Get project detail	organizationId, projectId
`backend_project_create`	Create project	organizationId, name, description?
`backend_project_update`	Update project	organizationId, projectId, name?, description?
`backend_project_delete`	Delete project (irreversible!)	organizationId, projectId
`backend_env_list`	List environments	organizationId, projectId
`backend_env_get`	Get environment detail	organizationId, projectId, environmentId
`backend_env_create`	Create environment	organizationId, projectId, name

MCP Resources (Read-Only)

Lightweight, cached (60s TTL) read-only queries via bkend:// URI:

URI	Description
`bkend://orgs`	Organization list
`bkend://orgs/{orgId}/projects`	Project list
`bkend://orgs/{orgId}/projects/{pId}/environments`	Environment list
`bkend://orgs/{orgId}/projects/{pId}/environments/{eId}/tables`	Table list with schema

Tip: Prefer Resources over Tools for listing operations (lighter, cached).

First Project Checklist

Sign up at bkend.ai -> Create Organization
Create Project -> dev environment auto-created
Connect MCP -> claude mcp add bkend
Create first table -> "Create a users table"
Start data operations -> CRUD via natural language

Console URL

https://console.bkend.ai

Next Steps

Database operations: refer to bkend-data skill
Authentication: refer to bkend-auth skill
File storage: refer to bkend-storage skill
Practical tutorials: refer to bkend-cookbook skill

Official Documentation (Live Reference)

For the latest bkend documentation, use WebFetch: