​
CLI ve MCP

Hemen Builders geliştirici deneyimi, panel kullanımının yanında terminal ve agent araçlarıyla da desteklenir.

​
CLI

Paket: 
packages/SoftwareRises/HemenBuildersCli
Temel komutlar: 
hemen builders init
hemen builders app create --name "ERP Connector" --scopes products:read,orders:read
hemen builders dev
hemen builders webhook listen --port 8787 --secret webhook-secret
hemen builders script publish ./script.json
CLI şu değerleri okur: 
HEMEN_BUILDERS_API_BASE_URL=https://dev.hemenmagaza.com
HEMEN_BUILDERS_TOKEN=YOUR_ACCESS_TOKEN
HEMEN_BUILDERS_TENANT_ID=velunamora

​
SDK

Paket: 
packages/SoftwareRises/HemenBuildersSdk
Başlangıç modülleri: 
client
oauth
webhooks
storefront-scripts
app-bridge
types
SDK default base URL: 
https://dev.hemenmagaza.com

​
MCP server

Servis: 
apps/hemen-builders-mcp
Lokal smoke: 
cd apps/hemen-builders-mcp
HEMEN_BUILDERS_TOKEN=YOUR_ACCESS_TOKEN npm run smoke
Server başlatma: 
node ./src/server.mjs

​
MCP tools

hemen.scopes.list
hemen.products.list
hemen.products.create
hemen.orders.list
hemen.orders.get
hemen.webhooks.create
hemen.webhooks.test
hemen.storefrontScripts.create

​
Cursor örneği

{
  "mcpServers": {
    "hemen-builders": {
      "command": "node",
      "args": ["/absolute/path/apps/hemen-builders-mcp/src/server.mjs"],
      "env": {
        "HEMEN_BUILDERS_API_BASE_URL": "https://dev.hemenmagaza.com",
        "HEMEN_BUILDERS_TOKEN": "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

​
Güvenlik

  • MCP auth Bearer token ile yapılır.
  • Her tool kendi scope kontrolünü uygular.
  • mcp:use scope’u olmadan MCP tool çağrısı kabul edilmez.
  • Tool çağrıları audit log’a yazılır.
  • Tenant dışı ürün, sipariş, webhook veya script erişimi yasaktır.