Getting started / Add your first connection

Add your first connection

Connect one OAuth or token-backed MCP server and verify its tool catalog.

From the console

  1. Open a connection namespace, choose Add connection, and select a provider. Higgsfield is available as an OAuth quick-add alongside Notion, Linear, GitHub, Slack, and Sentry; any compatible remote MCP URL can be added manually.
  2. Keep the suggested stable tool prefix or choose one before saving. For example, two Notion connections can become lelapa_notion__search and personal_notion__search.
  3. Complete upstream consent separately for each connection. Each authorization is stored and refreshed independently.
  4. Review the discovered tools, then grant the owning namespace to an MCP client or publish an eligible connection to a shared endpoint.

Choose the connection scope

  • Personal is visible only to its exact owner through a subject-bound client endpoint. A label such as “Personal” does not create this boundary; the stored scope and owner do.
  • Shared is workspace-owned and can appear on shared delivery surfaces. Operators need an explicitly delegated namespace to create one.
  • Service is an owner- or admin-created workspace credential for automation and can be placed on shared delivery surfaces.

Choose upstream authentication

Use a bearer token when the upstream issues one directly. For OAuth, prefer Dynamic Client Registration when the provider supports it; otherwise provide the upstream client ID, requested scope, and client secret when that provider requires one.