ww-w-ai/bkit-claude-code

bkend-quickstart

bkend.ai onboarding — MCP setup, resource hierarchy, tenant/user model, first project.

First seen Feb 13, 2026

Installation

$ npx skills add ww-w-ai/bkit-claude-code --skill bkend-quickstart

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from ww-w-ai/bkit-claude-code · top by installs.

npx skills add ww-w-ai/bkit-claude-code

Browse all from ww-w-ai/bkit-claude-code

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 594
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsRead, WebFetch, mcp__bkend__*
Declared agents claude-code cursor

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,018 B
  • docs SUMMARY.md 181 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 41 installs

SKILL.md

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

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

``json { "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
getoperationschema 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
backendorglist List organizations None
backendprojectlist List projects organizationId
backendprojectget Get project detail organizationId, projectId
backendprojectcreate Create project organizationId, name, description?
backendprojectupdate Update project organizationId, projectId, name?, description?
backendprojectdelete Delete project (irreversible!) organizationId, projectId
backendenvlist List environments organizationId, projectId
backendenvget Get environment detail organizationId, projectId, environmentId
backendenvcreate 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

  1. Sign up at bkend.ai -> Create Organization
  2. Create Project -> dev environment auto-created
  3. Connect MCP -> claude mcp add bkend
  4. Create first table -> "Create a users table"
  5. 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: