Skip to main content
Version: Next (nightly)

Personal connections

A personal connection is a credential you own, like an AI provider key, that you can grant to the workspaces you choose.

  1. Under Your account, open the Connections card and press + Add a connection.
  2. Pick the service from the catalogue and enter the credential once.
  3. Choose which of your workspaces may use it. Take a grant back whenever you like.

Yours, not the workspace's​

  • Set up under your own account, separate from any workspace's shared settings.
  • The credential stays yours, and you decide which workspaces are allowed to use it. The workspace sees the capability, never the credential.
  • Leave a workspace and your connection doesn't go with it.

Bring your own AI, and more​

  • AI is the common use: connect your own key once and grant it to a workspace, so its AI features run on your account instead of a shared one.
  • Parcel tracking: parcels on your orders are followed with your credentials rather than the instance operator's.
  • Your own edge bridge, which follows you between workspaces rather than being re-added in each one.
  • A service you installed yourself, such as a slicer.

Granting is per workspace, from your side.

Add a service​

A service is a program that does a job for Cobblr, such as slicing a model, which you run yourself, on your own network or on a server you control. Connect it once, under Your account → Connections → Add a service.

  1. Where it is. Choose At an address and give its address, starting http:// or https://. For a service on your own network, choose On my network, through my bridge and give its address there. Your edge bridge reaches it, so nothing on your network is opened to the outside. If the bridge is not running, the form says so.

  2. Read what it offers. Press Read what it offers. Cobblr reads the service's own description from /.well-known/cobblr-service.json at that address and lists its name, its version, and each job it can do. Every job says what it may do:

    • changes nothing elsewhere
    • changes things you own elsewhere, which asks you first
    • costs money per use, which asks you first
    • acts in the world, which always asks you first

    If the description is missing or broken, the form names the part that is wrong.

  3. Key. On the service, run its mint-key command. It shows one string once, a key id and a secret joined by a dot. Paste that string and press Test. A key the service does not accept says so. A service that is down or out of reach says that instead. Each person or workspace can have its own key, and the service can revoke one without touching the others.

  4. Where it works. Choose the workspaces it serves, as for any personal connection.

Some services are other companies' products that Cobblr already knows how to talk to, such as a print-failure detector. They appear on the same Add a service form under their own names, each asking only for what it needs (usually an address and a key), with the same Test.

When something in Cobblr needs a job no connected service does, it links here with that job already chosen: a Make that stops for want of a slicer opens Add a service asking for a slicer.