@groundfloorcloud/mcp 0.1.0 → 0.1.1

package/README.md

@@ -22,6 +22,8 @@ Switch workspace: `gf workspaces use <uuid>` (then MCP sees it). Expired session
 
 `gf` must be on `PATH` and you must have run `gf login` (and usually `gf workspaces use`).
 
+Clients that spawn a real Node (Claude Code, some IDEs) can use:
+
 ```json
 {
   "mcpServers": {
@@ -33,7 +35,28 @@ Switch workspace: `gf workspaces use <uuid>` (then MCP sees it). Expired session
 }
 ```
 
-Optional: `"GROUNDFLOOR_API_URL"` only if you are not using the cell from `gf login`. Do not put a JWT in mcp.json.
+**Cursor on macOS:** do not use bare `npx`. Cursor runs npm with its bundled Node, which then looks for `Cursor.app/.../resources/lib` and fails with `ENOENT`. Install the package with *your* Node, then point MCP at that binary:
+
+```bash
+npm i -g @groundfloorcloud/mcp
+which node
+# → /Users/you/.nvm/versions/node/v20.x.x/bin/node
+```
+
+```json
+{
+  "mcpServers": {
+    "groundfloor": {
+      "command": "/FULL/PATH/TO/node",
+      "args": [
+        "/FULL/PATH/TO/lib/node_modules/@groundfloorcloud/mcp/dist/index.js"
+      ]
+    }
+  }
+}
+```
+
+The `command` must be your Node (from `which node`), not `npx` and not Cursor’s helper Node. Do not put a JWT in mcp.json.
 
 ## Tools
 
@@ -45,7 +68,7 @@ Optional: `"GROUNDFLOOR_API_URL"` only if you are not using the cell from `gf lo
 | `apps_list` / `apps_get` | Inspect product Apps |
 | `secrets_list` / `files_list` / `domains_list` / `dataplane_status` | Inspect (no secrets values) |
 | `docs_list` / `docs_get` | Product docs |
-| `suggest_cli` | Command to run: login, deploy, run, … |
+| `suggest_cli` | Command to run: login, deploy, init_app, publish_app, … |
 
 Never create `app_kind=coderunner`. Deploy with `gf deploy`.
 

package/dist/index.js

@@ -296,17 +296,20 @@ var CELLS = {
   production: {
     apiUrl: "https://platform.groundfloor.cloud",
     issuer: "https://auth.groundfloor.cloud/realms/groundfloor",
-    clientId: "groundfloor-cli"
+    clientId: "groundfloor-cli",
+    consoleUrl: "https://console.groundfloor.cloud"
   },
   stage: {
     apiUrl: "https://platform.stage.groundfloor.cloud",
     issuer: "https://auth.stage.groundfloor.cloud/realms/groundfloor_pico_stage-realm",
-    clientId: "groundfloor-cli"
+    clientId: "groundfloor-cli",
+    consoleUrl: "https://console.stage.groundfloor.cloud"
   },
   dev: {
     apiUrl: "https://platform.dev.groundfloor.cloud",
     issuer: "https://auth.dev.groundfloor.cloud/realms/groundfloor_dev",
-    clientId: "groundfloor-cli"
+    clientId: "groundfloor-cli",
+    consoleUrl: "https://console.dev.groundfloor.cloud"
   }
 };
 function inferCell(apiUrl, issuer) {
@@ -384,7 +387,7 @@ var DOC_CATALOG = [
     id: "agents",
     title: "Deploy with agents",
     path: "/docs/customer-portal/agents",
-    summary: "How agents should deploy Coderunner workloads with gf / MCP."
+    summary: "How agents should deploy Coderunner workloads and init/publish Shell apps with gf / MCP."
   },
   {
     id: "developers",
@@ -479,10 +482,18 @@ function suggestCli(intent, args) {
         why: "Inspect build/deploy state.",
         docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
       };
+    case "init_app": {
+      const slug = args?.slug?.trim();
+      return {
+        command: slug ? `gf apps init --slug ${slug}` : "gf apps init --slug <portal-slug>",
+        why: "Download the official Shell starter-kit and stamp APP_ID. Never scaffold a federated App.tsx from memory \u2014 BrowserRouter in App.tsx crashes the Shell.",
+        docs: "https://docs.groundfloor.cloud/docs/integrations/shell"
+      };
+    }
     case "publish_app":
       return {
-        command: "gf apps publish --path release.zip",
-        why: "Ship a Shell federated product App (not a Coderunner workload).",
+        command: args?.slug ? `gf apps init --slug ${args.slug} && cd ${args.slug} && npm install && npm run release && gf apps publish --path release.zip` : "gf apps init --slug <portal-slug> && cd <slug> && npm install && npm run release && gf apps publish --path release.zip",
+        why: "Ship a Shell federated product App. Init the starter-kit first; run npm run release (do not zip Vite dist/). Do not gf deploy and do not invent App.tsx.",
         docs: "https://docs.groundfloor.cloud/docs/integrations/shell"
       };
     case "secrets":
@@ -500,7 +511,7 @@ function suggestCli(intent, args) {
     default:
       return {
         command: "gf --help",
-        why: `Unknown intent "${intent}". Use login | switch_workspace | deploy | run | status | publish_app | secrets | dataplane.`,
+        why: `Unknown intent "${intent}". Use login | switch_workspace | deploy | run | status | init_app | publish_app | secrets | dataplane.`,
         docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
       };
   }
@@ -838,12 +849,14 @@ server.tool(
       "deploy",
       "run",
       "status",
+      "init_app",
       "publish_app",
       "secrets",
       "dataplane"
     ]),
     workspace: z.string().optional(),
     name: z.string().optional().describe("Coderunner name/id for deploy/run/status"),
+    slug: z.string().optional().describe("Portal app slug for init_app / publish_app"),
     cell: z.enum(["production", "stage", "dev"]).optional()
   },
   async (args) => {
@@ -852,7 +865,8 @@ server.tool(
         workspace: args.workspace ?? "",
         name: args.name ?? "",
         coderunner: args.name ?? "",
-        cell: args.cell ?? ""
+        cell: args.cell ?? "",
+        slug: args.slug ?? ""
       })
     );
   }

package/package.json

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