Spectron on SurrealDB Cloud is a managed Spectron data plane per context, orchestrated by the SurrealDB Cloud API and surfaced in Surrealist.
Two planes
| Plane | Base URL | Who uses it | Purpose |
|---|---|---|---|
| Cloud API | https://api.surrealdb.com/v1/… | Surrealist, your automation | Context lifecycle, billing, API keys, admin proxies |
| Spectron data API | https://{context.host}/api/v1/… | Your app, SDKs, MCP | Memory, knowledge, chat, documents |
Customers integrate against the context host and sk-ctx-… API keys from Surrealist. They do not receive Spectron root management keys or SPECTRON_* node configuration.
Organisation roles
| Role | Typical Cloud capabilities |
|---|---|
| Owner | Subscribe to Spectron plans, billing, delete contexts |
| Admin | Create contexts, mint API keys, call admin proxy routes (principals, scopes, grants, usage) |
| Member | Use Playground, Memory, Documents, and Scopes in Surrealist; broker a short-lived access token for SDK use |
Admin proxy routes return 403 for members. See API keys and delegation.
What Surrealist exposes
| Feature | In Surrealist |
|---|---|
| Context list, deploy, billing, delete | Yes |
| API keys + per-context endpoint | Yes |
| Playground (live chat + memory updates) | Yes |
| Memory explorer (entities, relations, traces) | Yes |
| Documents (upload, browse, search) | Yes |
| Scopes (register and browse paths) | Yes |
| Integration snippets (SDK, REST, MCP, frameworks) | Yes |
| Settings — users, configuration, usage | Admins and owners |
For a UI tour, see Surrealist dashboard quickstart. For terminal-first remember / recall, see Hosted quickstart.
Scope on Cloud
Data-plane scope uses hierarchical slash paths — for example [["org/acme/user/alice"]] on writes and lens on reads. Register paths in Surrealist Scopes, via the CLI, or through the Cloud admin scopes proxy.
Cloud vs self-hosted
| Topic | SurrealDB Cloud | Self-hosted |
|---|---|---|
| Provision context | Surrealist → Cloud API | spectrond / management API |
| Data-plane URL | https://{context.host} | Your spectrond api bind address |
| API keys | Surrealist API keys (via Cloud) | spectrond keys / management API |
| Member tokens | POST …/spectron_contexts/{id}/access_tokens | POST …/access-tokens with management key |
| MCP endpoint | https://{context.host}/mcp | https://<your-host>/mcp |