@pega/sdk 0.0.6 → 0.0.7

package/dist/index.js

@@ -1036,6 +1036,35 @@ var SDK_CONFIG_USER_KEYS = [
   "authConfig.mashupUserIdentifier",
   "authConfig.portalClientId"
 ];
+var MCP_CONFIG_USER_KEYS = ["url", "clientId"];
+var MCP_CONFIG_FILES = {
+  copilot: { source: "copilot.mcp.json", dest: path2.join(".vscode", "mcp.json") },
+  cursor: { source: "cursor.mcp.json", dest: path2.join(".cursor", "mcp.json") },
+  "claude-code": { source: "claude-code.mcp.json", dest: ".mcp.json" }
+};
+function resolveMcpConfig(aiCommonSrc, choices) {
+  const { source, dest } = MCP_CONFIG_FILES[choices.aiTool];
+  const srcPath = path2.join(aiCommonSrc, "mcp", source);
+  if (!fs2.existsSync(srcPath)) {
+    throw new Error(`MCP config template not found at ${srcPath}. Ensure the template source is available.`);
+  }
+  const tokens = {
+    "{InfinityURL}": choices.serverUrl,
+    "{AppAlias}": choices.appAlias,
+    "{ClientId}": choices.clientId
+  };
+  if (choices.mcpRuleName) tokens["{MCPRuleName}"] = choices.mcpRuleName;
+  if (choices.mcpRuleInsKey) tokens["{MCPRuleInsKey}"] = choices.mcpRuleInsKey;
+  const content = applyTokens(fs2.readFileSync(srcPath, "utf-8"), tokens);
+  return { config: JSON.parse(content), destRelPath: dest };
+}
+function ensureGitignoreEntry(targetDir, entry) {
+  const gitignorePath = path2.join(targetDir, ".gitignore");
+  const existing = fs2.existsSync(gitignorePath) ? fs2.readFileSync(gitignorePath, "utf-8") : "";
+  if (existing.split(/\r?\n/).some((line) => line.trim() === entry)) return;
+  const separator = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  fs2.writeFileSync(gitignorePath, existing + separator + entry + "\n");
+}
 function buildSdkConfig(choices) {
   return {
     serverConfig: {
@@ -1079,6 +1108,11 @@ function collectEmbeddedConflicts(targetDir, choices) {
   if (isConflict(sdkConfigPath, buildSdkConfig(choices), SDK_CONFIG_USER_KEYS)) {
     conflicts.push(sdkConfigPath);
   }
+  const { config: mcpConfig, destRelPath: mcpDestRelPath } = resolveMcpConfig(aiCommonSrc, choices);
+  const mcpConfigPath = path2.join(targetDir, mcpDestRelPath);
+  if (isConflict(mcpConfigPath, mcpConfig, MCP_CONFIG_USER_KEYS)) {
+    conflicts.push(mcpConfigPath);
+  }
   return conflicts.map((filePath) => path2.relative(targetDir, filePath));
 }
 async function scaffoldEmbedded(choices, targetDir, onProgress) {
@@ -1129,6 +1163,12 @@ async function scaffoldEmbedded(choices, targetDir, onProgress) {
   if (staticDir !== targetDir && fs2.existsSync(path2.join(targetDir, "sdk-config.json"))) {
     report(`\u26A0\uFE0F  A sdk-config.json also exists at the project root. The active one is ${sdkConfigPath}.`);
   }
+  report("Creating MCP server configuration\u2026");
+  const { config: mcpConfig, destRelPath: mcpDestRelPath } = resolveMcpConfig(aiCommonSrc, choices);
+  writeManagedJson(path2.join(targetDir, mcpDestRelPath), mcpConfig, policy, MCP_CONFIG_USER_KEYS);
+  if (aiTool === "cursor") {
+    ensureGitignoreEntry(targetDir, mcpDestRelPath);
+  }
   report("Installing dependencies (this may take a minute)\u2026");
   let installSucceeded = true;
   try {
@@ -1247,7 +1287,7 @@ Usage: ${pc.cyan("npx @pega/sdk init")}`);
       process.exit(0);
     }
     p.log.info(pc.dim("\nNow let's connect to your Pega server."));
-    const serverUrl = await p.text({
+    const serverUrlResult = await p.text({
       message: "What is your Pega server URL?",
       placeholder: "https://your-pega-server.com/prweb",
       validate(value) {
@@ -1255,10 +1295,11 @@ Usage: ${pc.cyan("npx @pega/sdk init")}`);
         if (!value.startsWith("http")) return "Must be a valid URL starting with http:// or https://";
       }
     });
-    if (p.isCancel(serverUrl)) {
+    if (p.isCancel(serverUrlResult)) {
       p.cancel("Operation cancelled.");
       process.exit(0);
     }
+    const serverUrl = serverUrlResult.replace(/\/+$/, "");
     const appAlias = await p.text({
       message: "What is your Pega application alias?",
       placeholder: "MyApp",
@@ -1292,6 +1333,25 @@ Usage: ${pc.cyan("npx @pega/sdk init")}`);
       p.cancel("Operation cancelled.");
       process.exit(0);
     }
+    p.log.info(pc.dim("\nIf you've configured an MCP server for this app, we can wire it up too (optional)."));
+    const mcpRuleNameResult = await p.text({
+      message: "What is your Pega MCP rule name? (press Enter to skip)",
+      placeholder: "SDKMCP"
+    });
+    if (p.isCancel(mcpRuleNameResult)) {
+      p.cancel("Operation cancelled.");
+      process.exit(0);
+    }
+    const mcpRuleInsKeyResult = await p.text({
+      message: "What is your Pega MCP rule instance key? (press Enter to skip)",
+      placeholder: "@baseclass!SDKMCP"
+    });
+    if (p.isCancel(mcpRuleInsKeyResult)) {
+      p.cancel("Operation cancelled.");
+      process.exit(0);
+    }
+    const mcpRuleName = mcpRuleNameResult || void 0;
+    const mcpRuleInsKey = mcpRuleInsKeyResult || void 0;
     const embeddedTargetDir = cwd;
     p.note(
       [
@@ -1301,7 +1361,9 @@ Usage: ${pc.cyan("npx @pega/sdk init")}`);
         `${pc.bold("Server")}:        ${serverUrl}`,
         `${pc.bold("App Alias")}:     ${appAlias}`,
         `${pc.bold("Client ID")}:     ${clientId}`,
-        `${pc.bold("Operator")}:      ${userIdentifier}`
+        `${pc.bold("Operator")}:      ${userIdentifier}`,
+        `${pc.bold("MCP Rule")}:      ${mcpRuleName ?? pc.dim("(not configured \u2014 markers left in generated file)")}`,
+        `${pc.bold("MCP Ins Key")}:   ${mcpRuleInsKey ?? pc.dim("(not configured \u2014 markers left in generated file)")}`
       ].join("\n"),
       "Configuration"
     );
@@ -1318,7 +1380,9 @@ Usage: ${pc.cyan("npx @pega/sdk init")}`);
       serverUrl,
       appAlias,
       clientId,
-      userIdentifier
+      userIdentifier,
+      mcpRuleName,
+      mcpRuleInsKey
     };
     let conflicts = [];
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pega/sdk",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Scaffold a Pega SDK application project",
   "type": "module",
   "bin": {

package/templates/react-sdk-reference/.ai-common/mcp/claude-code.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "pega-{MCPRuleName}": {
+      "type": "http",
+      "url": "{InfinityURL}/app/{AppAlias}/api/service/v1/mcp/{MCPRuleInsKey}"
+    }
+  }
+}

package/templates/react-sdk-reference/.ai-common/mcp/copilot.mcp.json

@@ -0,0 +1,8 @@
+{
+  "servers": {
+    "pega-{MCPRuleName}": {
+      "type": "http",
+      "url": "{InfinityURL}/app/{AppAlias}/api/service/v1/mcp/{MCPRuleInsKey}"
+    }
+  }
+}

package/templates/react-sdk-reference/.ai-common/mcp/cursor.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "pega-{MCPRuleName}": {
+      "url": "{InfinityURL}/app/{AppAlias}/api/service/v1/mcp/{MCPRuleInsKey}",
+      "auth": {
+        "clientId": "{ClientId}",
+        "clientSecret": "<YOUR_CLIENT_SECRET>"
+      }
+    }
+  }
+}