0 Fork 0

Files

T

ahnyongjooandClaude Sonnet 5.5 964a841de1 chore(rebar): Pier_T_rebar 작업 폴더 초기 구성 및 외부 의존 파일 통합

- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환
- Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용
- pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관)
- worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md)
- D:\Rhino-MCP 경로 참조를 새 위치로 치환

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

2026-10-28 11:20:18 +09:00

3.7 KiB

Raw Blame History

bkend.ai Common Patterns

MCP Fixed Tools (Always Available)

Tool	Purpose	Parameters
`get_context`	Session context (org/project/env, API endpoint)	None
`search_docs`	Search bkend documentation (Auth/Storage guides)	query: string
`get_operation_schema`	Get tool input/output schema	operation: string, schemaType: "input" \| "output"

Important: get_context MUST be called first. It returns the API endpoint URL dynamically.

MCP Resources (Read-Only, Cached)

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

Access via resources/list and resources/read MCP methods. Prefer Resources over Tools for read-only listing (lighter, cached).

REST Service API

Base URL is provided dynamically by get_context response. Typical endpoints:

MCP: https://api.bkend.ai/mcp
Service API: Use the endpoint from get_context (e.g., https://api-client.bkend.ai/v1)

Important: Do NOT hardcode the Service API base URL. Always reference get_context output.

Required Headers (REST Service API)

x-project-id: {projectId}
x-environment: dev | staging | prod
Authorization: Bearer {accessToken}
Content-Type: application/json

API Response Format

List responses use consistent pagination:

{
  "items": [...],
  "pagination": { "page": 1, "limit": 20, "total": 100, "totalPages": 5 }
}

ID Field: Always use id (NOT _id).

Query Parameters

Filtering

AND filter: ?filter[field]=value (multiple fields = AND)
Operators: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin
Text search: ?search=keyword

Pagination & Sorting

Page: ?page=1 (default: 1)
Limit: ?limit=20 (default: 20, max: 100)
Sort: ?sort=field:asc (or desc)

File Upload (Presigned URL)

Presigned URL validity: 15 minutes
Upload via PUT method with Content-Type header
Complete upload by registering metadata: POST /v1/files

Error Response Format

{ "error": { "code": "ERROR_CODE", "message": "Human readable message" } }

HTTP Status Mapping

Status	Meaning
200	Success
400	Bad Request (validation)
401	Unauthorized (token expired/missing)
403	Forbidden (insufficient permissions)
404	Not Found
409	Conflict (unique constraint violation)
429	Rate Limit Exceeded (100 requests/hour)
500	Internal Server Error

MCP Endpoint

URL: https://api.bkend.ai/mcp
Transport: Streamable HTTP
Protocol: JSON-RPC 2.0
Auth: OAuth 2.1 + PKCE

MCP Setup (Antigravity Platform)

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

.mcp.json (Project Config)

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

Authentication

OAuth 2.1 + PKCE (browser auto-auth)
No API Key needed
Access Token: 1 hour
Refresh Token: 30 days

Environment Auto-Provisioning

Plan	Available Environments
Free	dev (1)
Pro	dev, staging, prod
Enterprise	dev, staging, prod + custom

Resource Hierarchy

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

3.7 KiB Raw Blame History