@groundfloorcloud/mcp 0.2.1 → 0.2.2

package/dist/index.js

@@ -516,8 +516,9 @@ the provider.
 
 ## Users and roles (Groundfloor mode)
 
-- **Invite user**: they set their own password (email needs Branding set up).
-- **Add user**: you set a password now; no email is sent.
+- **Invite user**: they set their own password from an emailed invitation.
+- **Add user**: you set a password now; they get an email with their sign-in
+  address and role (never the password).
 - Each user has a role: built-in \`viewer\`, \`user\`, \`admin\`, or a custom role
   created on the **Roles** tab. Roles here are unrelated to Portal team roles.
 - The role decides what the user reaches once granted on **Site access**
@@ -530,6 +531,24 @@ the provider.
 - SSO (OIDC or SAML) can be connected per workspace; role names in the
   provider's tokens must match the roles granted on Site access.
 
+## Sign-in email (invites, password resets, email verification)
+
+- Sent by **Groundfloor email** by default in every workspace: a Groundfloor
+  no-reply address with the organization's name as sender. Nothing to set up;
+  do not tell the user to configure email before inviting.
+- To use their own mail server, the user chooses **Your own email server**
+  under **Branding \u2192 Email sending** (host, port and from address required;
+  port 25, 465, 587 or 2525), then **Send test email** (goes to their own
+  verified address). API: \`PUT /v1/workspaces/{id}/auth\` with
+  \`mail: {mode: "custom", ...}\`; test with
+  \`POST /v1/workspaces/{id}/auth/mail/test\`.
+- A failing custom server does not fall back to Groundfloor email; the send
+  fails. Changing host or port needs the password again.
+- **Warning:** saving a \`mail\` block with no \`host\` (or
+  \`mode: "groundfloor"\`) switches back to Groundfloor email and deletes the
+  stored custom server settings and password. Only send \`mail\` when the user
+  means to change email settings.
+
 ## Multi-tenant (customer companies inside one workspace)
 
 Turn on **Multi-tenant** in Settings to get a Tenants tab: one tenant per
@@ -1420,9 +1439,9 @@ var DOC_CATALOG = [
     id: "authentication",
     title: "Workspace Authentication",
     path: "/docs/access/app-authentication",
-    summary: "App end users sign in only to the app via the workspace App Authentication realm; no Groundfloor console account or workspace membership. Modes none / Groundfloor / external, users and roles, SSO, multi-tenant. Optional; not required to create Apps or Coderunners. Separate from portal Team.",
+    summary: "App end users sign in only to the app via the workspace App Authentication realm; no Groundfloor console account or workspace membership. Modes none / Groundfloor / external, users and roles, SSO, multi-tenant, sign-in email (Groundfloor email by default, or your own server). Optional; not required to create Apps or Coderunners. Separate from portal Team.",
     embedded: APP_AUTHENTICATION_GUIDE,
-    lastUpdated: "2026-10-12"
+    lastUpdated: "2026-10-13"
   },
   {
     id: "access",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundfloorcloud/mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Groundfloor MCP — inspect workspace state and docs; take actions with the gf CLI.",
   "type": "module",
   "bin": {