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:

bkend-quickstart