@superblocksteam/mcp-server 2.0.156 → 2.0.157-next.0

package/README.md

@@ -156,7 +156,8 @@ Materialize an application to disk. Supports historical snapshots via `commit_id
 ### Integration Management
 
 - `get_integration` - fetch an integration by ID
-- `create_integration` - create an integration from API payload
+- `get_integration_config_schema` - JSON schema for a plugin's configuration
+- `create_integration` - create an integration from name, plugin_id, and configuration; returns `integration_url` when the dashboard shares the API origin
 - `update_integration` - update an integration by ID
 - `delete_integration` - delete an integration by ID
 - `get_integration_access` - list users/groups with integration access

package/dist/tools/create-integration.d.ts

@@ -1,3 +1,10 @@
 import type { ToolDefinition } from "./registry.js";
+export declare function buildCreateIntegrationPayload(input: {
+    configuration: Record<string, unknown>;
+    kind?: "PLUGIN" | "SECRET";
+    name: string;
+    plugin_id: string;
+    slug?: string;
+}): Record<string, unknown>;
 export declare const createIntegration: ToolDefinition;
 //# sourceMappingURL=create-integration.d.ts.map

package/dist/tools/create-integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-integration.d.ts","sourceRoot":"","sources":["../../src/tools/create-integration.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAWpD,eAAO,MAAM,iBAAiB,EAAE,cA2B/B,CAAC"}
+{"version":3,"file":"create-integration.d.ts","sourceRoot":"","sources":["../../src/tools/create-integration.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAepD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmB1B;AAsBD,eAAO,MAAM,iBAAiB,EAAE,cAgC/B,CAAC"}

package/dist/tools/create-integration.js

@@ -1,4 +1,6 @@
+import { randomUUID } from "node:crypto";
 import { z } from "zod";
+import { IntegrationKind } from "@superblocksteam/shared";
 import { resolveAuthForOrigin } from "../auth/resolve-auth.js";
 import { createSdk } from "../sdk/create-sdk.js";
 import { detectEnvironment, normalizeBaseUrl } from "../urls.js";
@@ -7,13 +9,53 @@ import { parseToolInput } from "./validation.js";
 const createIntegrationInputSchema = z
     .object({
     base_url: z.string().url(),
-    payload: z.record(z.string(), z.unknown()),
+    configuration: z.record(z.string(), z.unknown()),
+    kind: z.enum(["PLUGIN", "SECRET"]).optional(),
+    name: z.string().trim().min(1),
+    plugin_id: z.string().trim().min(1),
+    slug: z.string().trim().min(1).optional(),
 })
     .strict();
+export function buildCreateIntegrationPayload(input) {
+    const id = randomUUID();
+    const configurationId = randomUUID();
+    return {
+        configurations: [
+            {
+                configuration: input.configuration,
+                created: new Date().toISOString(),
+                id: configurationId,
+                integrationId: id,
+                isDefault: true,
+            },
+        ],
+        id,
+        kind: input.kind ?? IntegrationKind.PLUGIN,
+        name: input.name,
+        pluginId: input.plugin_id,
+        ...(input.slug ? { slug: input.slug } : {}),
+    };
+}
+// Hosted deployments serve the dashboard from the same origin as the API, so
+// base_url is a usable link. Local dev splits them across ports, and we have no
+// way to learn the UI port here, so we link nothing rather than link wrong.
+function integrationPageUrl(baseUrl, integration) {
+    if (detectEnvironment(baseUrl) === "local") {
+        return undefined;
+    }
+    if (typeof integration !== "object" || integration === null) {
+        return undefined;
+    }
+    const { id, pluginId } = integration;
+    if (typeof id !== "string" || typeof pluginId !== "string") {
+        return undefined;
+    }
+    return `${baseUrl}/integrations/${pluginId}/${id}`;
+}
 export const createIntegration = {
     name: "create_integration",
     title: "Create Integration",
-    description: "Create a new integration. Pass the integration payload expected by the integrations API.",
+    description: "Create a new integration. Call get_integration_config_schema first for the plugin_id, then pass name, plugin_id, and configuration. Do not send the integrations API envelope (id, created, configurations wrapper). When the result carries integration_url, show it so the user can open the new integration.",
     inputSchema: schemas.createIntegrationToolInputSchema,
     annotations: {
         readOnlyHint: false,
@@ -27,9 +69,11 @@ export const createIntegration = {
         const baseUrl = normalizeBaseUrl(input.base_url);
         const auth = await resolveAuthForOrigin(baseUrl);
         const sdk = createSdk(auth.token, baseUrl);
-        const integration = await sdk.createIntegration(input.payload);
+        const integration = await sdk.createIntegration(buildCreateIntegrationPayload(input));
+        const integrationUrl = integrationPageUrl(baseUrl, integration);
         return {
             integration,
+            ...(integrationUrl ? { integration_url: integrationUrl } : {}),
             auth_source: auth.source,
             base_url: baseUrl,
             environment: detectEnvironment(baseUrl),

package/dist/tools/create-integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-integration.js","sourceRoot":"","sources":["../../src/tools/create-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,4BAA4B,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAC3C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,0FAA0F;IAC5F,WAAW,EAAE,OAAO,CAAC,gCAAgC;IACrD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB;IACD,QAAQ,EAAE,UAAU;IACpB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,cAAc,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE/D,OAAO;YACL,WAAW;YACX,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC;SACxC,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-integration.js","sourceRoot":"","sources":["../../src/tools/create-integration.ts"],"names":[],"mappings":"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"}