Começar

Sandbox e claim

Como o Infi provisiona um tenant na hora e como você reivindica (claim) a conta.

O Infi provisiona um sandbox na hora, um tenant pronto, com produto e chave de API, antes mesmo de você ter conta. Depois você reivindica (claim) esse sandbox para virar dono. É assim que os construtores de IA (Lovable, Cursor, Bolt, Claude) conectam seu app ao Infi sem fricção.

O que é provisionado

Uma chamada de provisionamento cria, numa transação só:

Tenant anônimo

Slug aleatório, ex. sandbox-a1b2c3d4.

App padrão

allowed_origins e redirect_uris vazios, você preenche no claim.

Produto rascunho

"App usage" (tipo agent, cobrança por usage), pronto pra medir.

Chave sk_test_*

Retornada uma única vez no provisionamento. Guarde com cuidado.

Ciclo de vida

| Estado | Como chega | O que acontece | | --- | --- | --- | | UNCLAIMED | Provisionamento (ex. via MCP) | Tenant existe, produto semeado, sk_test_* emitida | | CLAIMED | POST /auth/sandbox/{id}/claim com login | Vincula um user (dono), grava signup_source, marca claimed_at | | Expirado | 72h sem claim | Sandbox não reivindicado expira |

Expira em 72h

Um sandbox não reivindicado expira em ~72 horas. Faça o claim antes disso pra não perder o tenant e a chave.

O fluxo de claim

  1. O construtor (ou a CLI) provisiona o sandbox e recebe a claimUrl: https://new.beinfi.com/claim/{id}.
  2. Você abre a URL e faz login (Clerk).
  3. O Infi vincula sua conta como dono e marca o sandbox como CLAIMED.
  4. Você define os domínios do app (origens e redirects) e copia o SDK.
  5. Pronto, cai no painel em app.beinfi.com.

signup_source

A origem do provisionamento vira o signup_source do tenant. Valores comuns:

type SignupSource = "lovable" | "cursor" | "bolt" | "claude" | "cli" | "web";

Veio do Lovable? Veja o guia de integração com Lovable.