@aws/nx-plugin-mcp 1.0.0-rc.37 → 1.0.0-rc.39

package/bin/aws-nx-mcp.js

@@ -19755,6 +19755,13 @@ const EMPTY_COMPLETION_RESULT = { completion: {
 //#endregion
 //#region ../nx-plugin/generators.json
 var generators$1 = {
+	"init": {
+		"factory": "./src/init/generator",
+		"schema": "./src/init/schema.json",
+		"description": "Configure an existing Nx workspace to use the @aws/nx-plugin",
+		"metric": "g57",
+		"guidePages": ["existing-project"]
+	},
 	"agentcore-gateway": {
 		"factory": "./src/agentcore-gateway/generator",
 		"schema": "./src/agentcore-gateway/schema.json",
@@ -20252,131 +20259,6 @@ const buildGeneratorInfoList = (baseDir) => Object.entries(generators$1).map(([i
 	..."guidePages" in info && info.guidePages ? { guidePages: info.guidePages } : {}
 }));
 //#endregion
-//#region ../nx-plugin/src/utils/commands.ts
-const PACKAGE_MANAGER_COMMANDS = {
-	npm: {
-		exec: "npx",
-		run: "npm run",
-		create: "npm create"
-	},
-	pnpm: {
-		exec: "pnpm",
-		run: "pnpm",
-		create: "pnpm create"
-	},
-	yarn: {
-		exec: "yarn",
-		run: "yarn",
-		create: "yarn create"
-	},
-	bun: {
-		exec: "bunx",
-		run: "bun",
-		create: "bun create"
-	}
-};
-/**
-* Build a package manager exec command (e.g. pnpm cmd, npx cmd, bunx cmd)
-*/
-const buildPackageManagerExecCommand = (pm, command) => {
-	return `${PACKAGE_MANAGER_COMMANDS[pm]?.exec ?? pm} ${command}`;
-};
-/**
-* Build a short package manager command (e.g. pnpm build, npm run build)
-*/
-const buildPackageManagerShortCommand = (pm, command) => {
-	return `${PACKAGE_MANAGER_COMMANDS[pm]?.run ?? pm} ${command}`;
-};
-/**
-* Build an install command for a given package manager
-*/
-const buildInstallCommand = (pm, pkg, dev) => {
-	switch (pm) {
-		case "pnpm": return `pnpm add ${dev ? "-D" : "-"}w ${pkg}`;
-		case "yarn": return `yarn add ${dev ? "-D " : ""}${pkg}`;
-		case "npm": return `npm install --legacy-peer-deps ${dev ? "-D " : ""}${pkg}`;
-		case "bun": return `bun install ${dev ? "-D " : ""}${pkg}`;
-		default: return `${pm} install ${dev ? "-D " : ""}${pkg}`;
-	}
-};
-/**
-* Build a command to create a new workspace using @aws/create-nx-workspace.
-*
-* Uses the `create` shorthand for each package manager:
-*   npm create @aws/nx-workspace my-project
-*   pnpm create @aws/nx-workspace my-project
-*   yarn create @aws/nx-workspace my-project
-*   bun create @aws/nx-workspace my-project
-*
-* The package manager is auto-detected by @aws/create-nx-workspace from the
-* invoking command, so --pm is not needed.
-*/
-const buildCreateNxWorkspaceCommand = (pm, workspace, iac, tag, module) => {
-	return [
-		PACKAGE_MANAGER_COMMANDS[pm]?.create ?? `${pm} create`,
-		tag ? `@aws/nx-workspace@${tag}` : "@aws/nx-workspace",
-		...pm === "npm" ? ["--"] : [],
-		workspace,
-		...iac ? [`--iac=${iac}`] : [],
-		...module ? [`--module=${module}`] : []
-	].join(" ");
-};
-//#endregion
-//#region ../nx-plugin/src/utils/iac-providers.ts
-/**
-* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-* SPDX-License-Identifier: Apache-2.0
-*/
-const IAC_PROVIDERS = ["cdk", "terraform"];
-//#endregion
-//#region ../nx-plugin/src/mcp-server/schema.ts
-/**
-* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-* SPDX-License-Identifier: Apache-2.0
-*/
-const PACKAGE_MANAGERS = [
-	"pnpm",
-	"yarn",
-	"npm",
-	"bun"
-];
-const PackageManagerSchema = _enum(PACKAGE_MANAGERS);
-//#endregion
-//#region ../nx-plugin/src/mcp-server/tools/create-workspace-command.ts
-/**
-* Add a tool which tells a model how to create an Nx workspace
-*/
-const addCreateWorkspaceCommandTool = (server) => {
-	server.registerTool("create-workspace-command", {
-		description: "Tool to discover how to create a workspace to start a new project.",
-		inputSchema: { packageManager: PackageManagerSchema }
-	}, ({ packageManager }) => ({ content: [{
-		type: "text",
-		text: `Run the following command to create a workspace:
-
-\`\`\`bash
-${buildCreateNxWorkspaceCommand(packageManager, "<workspace-name>")} --no-interactive
-\`\`\`
-
-This will create a new workspace within the \`<workspace-name>\` directory.
-
-If you are already inside an empty directory intended for this project, you can pass \`.\` as the workspace name to create the workspace in the current directory:
-
-\`\`\`bash
-${buildCreateNxWorkspaceCommand(packageManager, ".")} --no-interactive
-\`\`\`
-
-Note that this will prompt for an Infrastructure as Code provider (${IAC_PROVIDERS.join(", ")}).
-If you know the preferred option, pass ${IAC_PROVIDERS.map((iac) => `\`--iac=${iac}\``).join(" or ")} to the above command to skip the prompt.
-
-Additional options:
-- \`--no-gitSecrets\`: Opt out of the default git-secrets pre-commit hook (prevents committing AWS credentials)
-
-Refer to the \`general-guidance\` tool for full workspace documentation including structure, common commands, and configuration.
-  `
-	}] }));
-};
-//#endregion
 //#region ../../node_modules/.pnpm/lodash.camelcase@4.3.0/node_modules/lodash.camelcase/index.js
 var require_lodash_camelcase = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	/** `Object#toString` result references. */
@@ -21402,6 +21284,218 @@ const kebabCase = (str) => {
 	return (0, import_lodash_deburr.default)(str).replace(/[^a-zA-Z0-9]+/g, "-").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().replace(/^-+|-+$/g, "");
 };
 //#endregion
+//#region ../nx-plugin/src/utils/commands.ts
+/**
+* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+* SPDX-License-Identifier: Apache-2.0
+*/
+/**
+* The nx version the plugin is built against. Commands that download nx
+* (e.g. `nx init`) pin to this version so the workspace's nx matches the
+* plugin's `@nx/*` packages — a mismatch deadlocks `nx sync`.
+*/
+const NX_VERSION = {
+	"@a2a-js/sdk": "0.3.14",
+	"@aws/aws-distro-opentelemetry-node-autoinstrumentation": "0.12.0",
+	"@aws-sdk/client-dynamodb": "3.1085.0",
+	"@aws-sdk/client-bedrock-runtime": "3.1085.0",
+	"@aws-sdk/client-s3": "3.1085.0",
+	"@aws-sdk/client-sts": "3.1085.0",
+	"@aws-sdk/credential-providers": "3.1085.0",
+	"@aws-sdk/credential-provider-cognito-identity": "3.972.56",
+	"@aws-sdk/client-secrets-manager": "3.1085.0",
+	"@aws-sdk/rds-signer": "3.1085.0",
+	"@aws-smithy/server-apigateway": "1.0.0-alpha.10",
+	"@aws-smithy/server-node": "1.0.0-alpha.10",
+	"@aws-lambda-powertools/logger": "2.34.0",
+	"@aws-lambda-powertools/metrics": "2.34.0",
+	"@aws-lambda-powertools/parameters": "2.34.0",
+	"@aws-lambda-powertools/tracer": "2.34.0",
+	"@aws-lambda-powertools/parser": "2.34.0",
+	"@aws-sdk/client-appconfigdata": "3.1085.0",
+	"@middy/core": "7.7.0",
+	"@nxlv/python": "22.2.1",
+	"@nx-extend/terraform": "10.3.0",
+	"@nx/devkit": "23.0.2",
+	"@nx/react": "23.0.2",
+	"create-nx-workspace": "23.0.2",
+	"@swc-node/register": "1.11.1",
+	"@swc/core": "1.15.43",
+	"@modelcontextprotocol/sdk": "1.29.0",
+	"@modelcontextprotocol/inspector": "0.22.0",
+	"@ag-ui/aws-strands": "0.2.3",
+	"@ag-ui/client": "0.0.57",
+	"@ag-ui/core": "0.0.57",
+	"@ag-ui/encoder": "0.0.57",
+	"agent-chat-cli": "0.3.0",
+	"@copilotkit/react-core": "1.62.3",
+	rxjs: "7.8.2",
+	"@strands-agents/sdk": "1.9.0",
+	"@tanstack/react-router": "1.170.17",
+	"@tanstack/router-plugin": "1.168.19",
+	"@tanstack/router-generator": "1.167.18",
+	"@tanstack/virtual-file-routes": "1.162.0",
+	"@tanstack/router-utils": "1.162.2",
+	"@cloudscape-design/board-components": "3.0.201",
+	"@cloudscape-design/chat-components": "1.0.149",
+	"@cloudscape-design/components": "3.0.1325",
+	"@cloudscape-design/global-styles": "1.0.62",
+	"@tanstack/react-query": "5.101.2",
+	"@tanstack/react-query-devtools": "5.101.2",
+	"@trpc/tanstack-react-query": "11.18.0",
+	"@trpc/client": "11.18.0",
+	"@trpc/server": "11.18.0",
+	"@types/node": "26.1.1",
+	"@types/aws-lambda": "8.10.162",
+	"@types/cors": "2.8.19",
+	"@types/pg": "8.20.0",
+	"@types/ws": "8.18.1",
+	"@types/express": "5.0.6",
+	"@smithy/config-resolver": "4.6.8",
+	"@smithy/node-config-provider": "4.5.8",
+	"@smithy/node-http-handler": "4.9.5",
+	"@smithy/types": "4.16.1",
+	"@vitest/coverage-v8": "4.1.10",
+	"@vitest/ui": "4.1.10",
+	"@astrojs/react": "6.0.1",
+	"@astrojs/starlight": "0.41.3",
+	astro: "7.0.7",
+	aws4fetch: "1.0.20",
+	"aws-cdk": "2.1130.0",
+	"aws-cdk-lib": "2.261.0",
+	"aws-xray-sdk-core": "3.12.0",
+	constructs: "10.6.0",
+	cors: "2.8.6",
+	chalk: "5.6.2",
+	"class-variance-authority": "0.7.1",
+	clsx: "2.1.1",
+	commander: "15.0.0",
+	electrodb: "3.9.1",
+	esbuild: "0.28.1",
+	"event-source-polyfill": "1.0.31",
+	"@types/event-source-polyfill": "1.0.5",
+	"@biomejs/biome": "2.5.3",
+	"@prisma/adapter-mariadb": "7.8.0",
+	"@prisma/adapter-pg": "7.8.0",
+	"@prisma/client": "7.8.0",
+	ejs: "6.0.1",
+	"@types/ejs": "3.1.5",
+	express: "5.2.1",
+	"fast-glob": "3.3.3",
+	husky: "9.1.7",
+	"fs-extra": "11.3.6",
+	"@types/fs-extra": "11.0.4",
+	"make-dir-cli": "4.0.0",
+	mariadb: "3.5.3",
+	ncp: "2.0.0",
+	npm: "12.0.1",
+	"npm-check-updates": "22.2.9",
+	"oidc-client-ts": "3.5.0",
+	pg: "8.22.0",
+	prisma: "7.8.0",
+	"react-oidc-context": "3.3.1",
+	react: "19.2.7",
+	"react-dom": "19.2.7",
+	rimraf: "6.1.3",
+	rolldown: "1.1.5",
+	"simple-git": "3.36.0",
+	"source-map-support": "0.5.21",
+	"starlight-blog": "0.28.0",
+	tailwindcss: "4.3.2",
+	"@tailwindcss/vite": "4.3.2",
+	tsx: "4.23.0",
+	"lucide-react": "1.24.0",
+	"radix-ui": "1.6.2",
+	shadcn: "4.13.0",
+	"tw-animate-css": "1.4.0",
+	"tailwind-merge": "3.6.0",
+	vite: "8.1.4",
+	typescript: "6.0.3",
+	vitest: "4.1.10",
+	zod: "4.4.3",
+	ws: "8.21.0"
+}["@nx/devkit"];
+const PACKAGE_MANAGER_COMMANDS = {
+	npm: {
+		exec: "npx",
+		run: "npm run",
+		create: "npm create"
+	},
+	pnpm: {
+		exec: "pnpm",
+		run: "pnpm",
+		create: "pnpm create"
+	},
+	yarn: {
+		exec: "yarn",
+		run: "yarn",
+		create: "yarn create"
+	},
+	bun: {
+		exec: "bunx",
+		run: "bun",
+		create: "bun create"
+	}
+};
+/**
+* Build a package manager exec command (e.g. pnpm cmd, npx cmd, bunx cmd)
+*/
+const buildPackageManagerExecCommand = (pm, command) => {
+	return `${PACKAGE_MANAGER_COMMANDS[pm]?.exec ?? pm} ${command}`;
+};
+/**
+* Build a short package manager command (e.g. pnpm build, npm run build)
+*/
+const buildPackageManagerShortCommand = (pm, command) => {
+	return `${PACKAGE_MANAGER_COMMANDS[pm]?.run ?? pm} ${command}`;
+};
+/**
+* Build an install command for a given package manager
+*/
+const buildInstallCommand = (pm, pkg, dev) => {
+	switch (pm) {
+		case "pnpm": return `pnpm add ${dev ? "-D" : "-"}w ${pkg}`;
+		case "yarn": return `yarn add ${dev ? "-D " : ""}${pkg}`;
+		case "npm": return `npm install --legacy-peer-deps ${dev ? "-D " : ""}${pkg}`;
+		case "bun": return `bun install ${dev ? "-D " : ""}${pkg}`;
+		default: return `${pm} install ${dev ? "-D " : ""}${pkg}`;
+	}
+};
+/**
+* Build the command that adds Nx to a non-Nx project, pinned to the nx
+* version the plugin is built against.
+*/
+const buildNxInitCommand = (pm) => {
+	return `${{
+		npm: "npx",
+		pnpm: "pnpm dlx",
+		yarn: "yarn dlx",
+		bun: "bunx"
+	}[pm] ?? "npx"} nx@${NX_VERSION} init`;
+};
+/**
+* Build a command to create a new workspace using @aws/create-nx-workspace.
+*
+* Uses the `create` shorthand for each package manager:
+*   npm create @aws/nx-workspace my-project
+*   pnpm create @aws/nx-workspace my-project
+*   yarn create @aws/nx-workspace my-project
+*   bun create @aws/nx-workspace my-project
+*
+* The package manager is auto-detected by @aws/create-nx-workspace from the
+* invoking command, so --pm is not needed.
+*/
+const buildCreateNxWorkspaceCommand = (pm, workspace, iac, tag, module) => {
+	return [
+		PACKAGE_MANAGER_COMMANDS[pm]?.create ?? `${pm} create`,
+		tag ? `@aws/nx-workspace@${tag}` : "@aws/nx-workspace",
+		...pm === "npm" ? ["--"] : [],
+		workspace,
+		...iac ? [`--iac=${iac}`] : [],
+		...module ? [`--module=${module}`] : []
+	].join(" ");
+};
+//#endregion
 //#region ../nx-plugin/src/mcp-server/guide-render.ts
 /**
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
@@ -53532,12 +53626,22 @@ const stringifyMdx = (tree, deps) => String(deps.unified().use(deps.remarkFrontm
 	fences: true,
 	listItemIndent: "one"
 }).stringify(tree));
+/**
+* Remove nodes that are meaningless once the MDX is rendered to plain markdown
+* for an agent: the YAML frontmatter block and the `import`/`export` (ESM)
+* statements at the top of every docs page. They add noise and tokens without
+* conveying guidance.
+*/
+const stripFrontmatterAndEsm = (tree) => {
+	tree.children = tree.children.filter((node) => node.type !== "yaml" && node.type !== "mdxjsEsm");
+};
 const postProcessGuideWithRemark = async (guide, opts) => {
 	const deps = await loadRemarkDeps();
 	const tree = parseMdxWithDeps(guide, deps);
 	await inlineSnippets(tree, opts, deps);
 	applyFilterTransforms(tree, opts.options);
 	applyComponentTransforms(tree, opts, deps);
+	stripFrontmatterAndEsm(tree);
 	return stringifyMdx(tree, deps);
 };
 const inlineSnippets = async (tree, opts, deps) => {
@@ -53781,6 +53885,7 @@ const renderComponent = (node, opts, pm, deps) => {
 			const iac = readStringAttr(node, "iac");
 			return [codeBlock(buildCreateNxWorkspaceCommand(pm, workspace, iac))];
 		}
+		case "NxInitCommand": return [codeBlock(buildNxInitCommand(pm))];
 		case "InstallCommand": {
 			const pkg = readStringAttr(node, "pkg") ?? readExpressionAttr(node, "pkg");
 			if (!pkg) return void 0;
@@ -54086,19 +54191,29 @@ const parseGuide = async (raw) => {
 	};
 };
 /**
-* Probe paths for finding guide MDX files locally. Checked in order:
+* Base directories to probe for guide MDX files, relative to this module.
+* Each is checked in order:
 * 1. Bundled docs in the published @aws/nx-plugin-mcp package
 * 2. Source checkout when running from the monorepo (dev/test)
 * 3. Rolldown-bundled binary in dist/ (monorepo layout)
 */
-const GUIDES_RELATIVE_PROBES = [
-	"../docs/guides",
-	"../../../docs/src/content/docs/en/guides",
-	"../../../../docs/src/content/docs/en/guides"
+const GUIDE_BASE_PROBES = [
+	"../docs",
+	"../../../docs/src/content/docs/en",
+	"../../../../docs/src/content/docs/en"
 ];
+/**
+* Content sub-directories that hold pages a generator may reference via
+* `guidePages`. Both the per-generator reference guides (`guides/`) and the
+* getting-started pages (`get_started/`) are fetchable, so a page can live in
+* whichever section reads best for humans while still being served by the MCP
+* tools. Bare `guidePages` names may also include a sub-path (e.g.
+* `connection/react-trpc`).
+*/
+const GUIDE_SECTIONS = ["guides", "get_started"];
 const fetchLocalGuide = (guide) => {
-	for (const rel of GUIDES_RELATIVE_PROBES) {
-		const candidate = path$3.default.resolve(__dirname, rel, `${guide}.mdx`);
+	for (const base of GUIDE_BASE_PROBES) for (const section of GUIDE_SECTIONS) {
+		const candidate = path$3.default.resolve(__dirname, base, section, `${guide}.mdx`);
 		try {
 			if (fs.default.existsSync(candidate)) return fs.default.readFileSync(candidate, "utf-8");
 		} catch {}
@@ -54145,6 +54260,85 @@ const postProcessGuide = async (guide, generators, packageManager, snippetConten
 	});
 };
 //#endregion
+//#region ../nx-plugin/src/mcp-server/schema.ts
+/**
+* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+* SPDX-License-Identifier: Apache-2.0
+*/
+const PACKAGE_MANAGERS = [
+	"pnpm",
+	"yarn",
+	"npm",
+	"bun"
+];
+const PackageManagerSchema = _enum(PACKAGE_MANAGERS);
+//#endregion
+//#region ../nx-plugin/src/mcp-server/tools/add-to-existing-project.ts
+/**
+* The guide page (under `get_started/`) that backs this tool, so the tool and
+* the published docs never drift.
+*/
+const EXISTING_PROJECT_GUIDE = "existing-project";
+/**
+* Add a tool which guides an agent through adding @aws/nx-plugin to an
+* existing Nx or non-Nx workspace. Returns the `existing-project` docs page,
+* which includes the full adoption steps and troubleshooting reference.
+*/
+const addToExistingProjectTool = (server, generators) => {
+	server.registerTool("add-to-existing-project", {
+		title: "Add to Existing Project",
+		description: "Tool for adding the Nx Plugin for AWS to an existing Nx workspace or non-Nx monorepo. Use this when a user wants to adopt @aws/nx-plugin in a project that was not created with the plugin preset, or hits configuration errors when running generators in such a workspace.",
+		inputSchema: { packageManager: PackageManagerSchema.optional() }
+	}, async ({ packageManager }) => {
+		return { content: [{
+			type: "text",
+			text: await fetchGuidePages([EXISTING_PROJECT_GUIDE], generators, packageManager)
+		}] };
+	});
+};
+//#endregion
+//#region ../nx-plugin/src/utils/iac-providers.ts
+/**
+* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+* SPDX-License-Identifier: Apache-2.0
+*/
+const IAC_PROVIDERS = ["cdk", "terraform"];
+//#endregion
+//#region ../nx-plugin/src/mcp-server/tools/create-workspace-command.ts
+/**
+* Add a tool which tells a model how to create an Nx workspace
+*/
+const addCreateWorkspaceCommandTool = (server) => {
+	server.registerTool("create-workspace-command", {
+		description: "Tool to discover how to create a workspace to start a new project.",
+		inputSchema: { packageManager: PackageManagerSchema }
+	}, ({ packageManager }) => ({ content: [{
+		type: "text",
+		text: `Run the following command to create a workspace:
+
+\`\`\`bash
+${buildCreateNxWorkspaceCommand(packageManager, "<workspace-name>")} --no-interactive
+\`\`\`
+
+This will create a new workspace within the \`<workspace-name>\` directory.
+
+If you are already inside an empty directory intended for this project, you can pass \`.\` as the workspace name to create the workspace in the current directory:
+
+\`\`\`bash
+${buildCreateNxWorkspaceCommand(packageManager, ".")} --no-interactive
+\`\`\`
+
+Note that this will prompt for an Infrastructure as Code provider (${IAC_PROVIDERS.join(", ")}).
+If you know the preferred option, pass ${IAC_PROVIDERS.map((iac) => `\`--iac=${iac}\``).join(" or ")} to the above command to skip the prompt.
+
+Additional options:
+- \`--no-gitSecrets\`: Opt out of the default git-secrets pre-commit hook (prevents committing AWS credentials)
+
+Refer to the \`general-guidance\` tool for full workspace documentation including structure, common commands, and configuration.
+  `
+	}] }));
+};
+//#endregion
 //#region ../nx-plugin/src/mcp-server/tools/list-generators.ts
 /**
 * Adds a tool which lists details about the available generators.
@@ -54217,6 +54411,7 @@ const TOOL_SELECTION_GUIDE = `## Tool Selection Guide
 
 - Use the \`general-guidance\` tool for guidance and best practices for working with Nx and the Nx Plugin for AWS.
 - Use the \`create-workspace-command\` tool to discover how to create a workspace to start a new project.
+- Use the \`add-to-existing-project\` tool when adding the plugin to an existing Nx workspace or non-Nx monorepo, or when troubleshooting configuration errors in such a workspace.
 - Use the \`list-generators\` tool to discover the available generators and how to run them.
 - Use the \`generator-guide\` tool to retrieve detailed information about a specific generator.`;
 /**
@@ -54336,6 +54531,7 @@ ${TOOL_SELECTION_GUIDE}
 	addCreateWorkspaceCommandTool(server);
 	addListGeneratorsTool(server, generators);
 	addGeneratorGuideTool(server, generators);
+	addToExistingProjectTool(server, generators);
 	return server;
 };
 (async () => {

package/docs/get_started/building-with-ai.mdx

@@ -0,0 +1,116 @@
+---
+title: Building with AI
+description: Building with AI and the Nx Plugin for AWS MCP Server
+---
+
+import Link from "@components/link.astro";
+import Snippet from "@components/snippet.astro";
+import { Steps, Tabs, TabItem } from "@astrojs/starlight/components";
+
+Install the [Claude Plugin](https://code.claude.com/docs/en/plugins), [Kiro Power](https://kiro.dev/docs/powers/), or [MCP Server](https://modelcontextprotocol.io/introduction) to enable AI assistants to work effectively with the plugin. By using these, you can accelerate your development workflow with AI while benefitting from your projects being scaffolded in a consistent fashion, spending less time on setting up the main components and benefitting from the security, observability, type-safety and local development built into the plugin.
+
+## Configure your AI Assistant
+
+:::tip[Project-level configuration is automatic]
+Workspaces created with the Nx Plugin for AWS preset already include project-level MCP configuration for common coding agents (Claude Code, Cursor, Kiro, Gemini CLI, GitHub Copilot and OpenAI Codex). Any agent working inside the workspace can use the MCP server without further setup. The steps below configure the MCP server globally for use across all of your projects.
+:::
+
+<Tabs syncKey="ai-assistant">
+  <TabItem label="Kiro">
+    The Nx Plugin for AWS ships as a [Kiro Power](https://kiro.dev/docs/powers/) that bundles the MCP server with steering documentation and workflow guides.
+
+    <Steps>
+
+    1. Open the Powers panel in Kiro and click **Add power from GitHub**
+    2. Enter the following URL:
+
+       ```
+       https://github.com/awslabs/nx-plugin-for-aws/tree/main/powers/nx-plugin-for-aws
+       ```
+
+    3. Click **Install**
+
+    </Steps>
+
+    Kiro automatically configures the MCP server — no additional setup required.
+
+  </TabItem>
+  <TabItem label="Kiro CLI">
+    Run the following command:
+
+    ```bash
+    kiro-cli mcp add \
+      --name nx-plugin-for-aws \
+      --scope global \
+      --command npx \
+      --args "-y,@aws/nx-plugin-mcp"
+    ```
+
+    See the [Kiro CLI MCP docs](https://kiro.dev/docs/cli/mcp/) for more details.
+
+  </TabItem>
+  <TabItem label="Claude Code">
+    The Nx Plugin for AWS is distributed as a [Claude Code plugin](https://code.claude.com/docs/en/plugins) that bundles a [Skill](https://code.claude.com/docs/en/skills) with the MCP server.
+
+    Run the following commands inside Claude Code, one at a time:
+
+    ```
+    /plugin marketplace add awslabs/nx-plugin-for-aws
+    ```
+
+    ```
+    /plugin install nx-plugin-for-aws@nx-plugin-for-aws
+    ```
+
+    Then run `/reload-plugins` to activate the plugin.
+
+  </TabItem>
+  <TabItem label="Cursor">
+    Add the following to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):
+
+    <Snippet name="mcp/config" />
+
+    See the [Cursor MCP docs](https://cursor.com/docs/mcp) for more details.
+
+  </TabItem>
+  <TabItem label="Codex">
+    Add the following to `~/.codex/config.toml`:
+
+    ```toml
+    [mcp_servers.nx-plugin-for-aws]
+    command = "npx"
+    args = ["-y", "@aws/nx-plugin-mcp"]
+    ```
+
+    See the [Codex config docs](https://developers.openai.com/codex/config-reference) for more details.
+
+  </TabItem>
+  <TabItem label="Other">
+    Most MCP-compatible assistants use a JSON configuration file. Add the following entry:
+
+    <Snippet name="mcp/config" />
+
+    If you have issues such as `ENOENT npx`, replace the command with the full path to `npx` (find it with `which npx`).
+
+    For assistant-specific documentation:
+
+    <Snippet name="mcp/assistant-docs" />
+
+  </TabItem>
+</Tabs>
+
+## Start Vibe Coding
+
+Ask your AI Assistant to build something using the `nx-plugin-for-aws`! It will typically create a workspace, scaffold with the applicable generators, then fill in the business logic.
+
+Try a prompt like:
+
+> _"Build a multi-agent application using the Nx Plugin for AWS. I want a React frontend that talks to a backend orchestrator agent which delegates to specialised research and writing agents."_
+
+Or for a smaller starting point:
+
+> _"Use the Nx Plugin for AWS to scaffold a React website backed by a tRPC API, with Cognito auth and CDK infrastructure."_
+
+## Build your own MCP Server
+
+Check out the <Link path="/guides/ts-mcp-server">`ts#mcp-server` generator guide</Link> for details about building your own MCP Server.