From 2e55bae6b3b8bc66f398e5a3bbefa267307a3192 Mon Sep 17 00:00:00 2001 From: vova-ivanov Date: Tue, 26 Aug 2025 09:24:55 -0700 Subject: [PATCH 1/3] Updated docs and blog post to include simplified install buttons in addition to long instructions. --- .../blog/mcp-server-ai-assistants/index.md | 22 +++++---------- content/docs/iac/using-pulumi/mcp-server.md | 28 +++++++++++++------ 2 files changed, 27 insertions(+), 23 deletions(-) diff --git a/content/blog/mcp-server-ai-assistants/index.md b/content/blog/mcp-server-ai-assistants/index.md index e33eb08ab29e..e9ccbb816886 100644 --- a/content/blog/mcp-server-ai-assistants/index.md +++ b/content/blog/mcp-server-ai-assistants/index.md @@ -27,25 +27,17 @@ Several AI coding assistants like GitHub Copilot, Anthropic's Claude Code, Winds ## Setting up the Pulumi MCP Integration in Cursor -Before diving in, you typically need to configure your AI assistant to communicate with the Pulumi MCP server. In Cursor, you create a configuration file named `mcp.json` within the `.cursor` directory in your project's root. +Before diving in, you typically need to configure your AI assistant to communicate with the Pulumi MCP server. For Cursor, you can do so by visiting the following link: -```json -{ - "mcpServers": { - "pulumi": { - "type": "stdio", - "command": "npx", - "args": ["@pulumi/mcp-server"] - } - } -} -``` +[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=pulumi&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IEBwdWx1bWkvbWNwLXNlcnZlciJ9) -3. Validating the connection within the assistant's settings (e.g., Cursor has a dedicated section to check the MCP connection status). +Once set up, validate the connection within the assistant's settings to ensure that the server is properly working. Cursor has a dedicated section to check the MCP connection status: - ![Cursor MCP Settings](cursor-mcp-settings.png) +![Cursor MCP Settings](cursor-mcp-settings.png) -Once configured, the AI assistant can leverage Pulumi tools seamlessly. These tools are specific actions enabled by the MCP server—like searching the Pulumi Registry or running a `pulumi` command—allowing the assistant to gather information or interact with your Pulumi project. +The assistant can now leverage Pulumi tools seamlessly. These tools are specific actions enabled by the MCP server—like searching the Pulumi Registry or running a `pulumi` command—allowing the assistant to gather information or interact with your Pulumi project. + +For help on setting up the MCP server with other IDEs such as Claude Code and Windsurf, see the [Pulumi MCP](https://www.pulumi.com/docs/iac/using-pulumi/mcp-server/) docs. ## The Goal: Provisioning an AKS Cluster diff --git a/content/docs/iac/using-pulumi/mcp-server.md b/content/docs/iac/using-pulumi/mcp-server.md index d5e1a0e76582..ce99769591e3 100644 --- a/content/docs/iac/using-pulumi/mcp-server.md +++ b/content/docs/iac/using-pulumi/mcp-server.md @@ -32,7 +32,7 @@ This enables a more intuitive, conversational approach to infrastructure develop The Pulumi MCP server works with various AI-powered development tools: - **[Cursor](https://cursor.sh/)** - AI-first code editor -- **[Anthropic's Claude Code](https://claude.ai/code)** - AI assistant for coding +- **[Anthropic's Claude](https://claude.ai/code)** - AI assistant for coding - **[GitHub Copilot](https://github.com/features/copilot)** - AI pair programmer - **[Windsurf](https://codeium.com/windsurf)** - AI development environment - **[Devin](https://app.devin.ai/)** - The AI @@ -53,9 +53,13 @@ npx @pulumi/mcp-server ## Configuration -### Cursor setup +### Cursor -To configure the Pulumi MCP server with Cursor, create a `mcp.json` file in the `.cursor` directory at your project root: +Add the Pulumi MCP server to Cursor by clicking the following button: + +[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=pulumi&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IEBwdWx1bWkvbWNwLXNlcnZlciJ9) + +Alternatively, create a `mcp.json` file in the `.cursor` directory at your project root: ```json { @@ -76,9 +80,17 @@ After creating the configuration file: 3. Navigate to the MCP section to verify the connection status 4. The Pulumi MCP server should appear as connected -### Claude Code setup +### Claude Code + +Add the Pulumi MCP server to Claude Code by running the following command: + +```bash +$ claude mcp add -s user pulumi -- npx @pulumi/mcp-server@latest stdio +``` + +### Claude Desktop -For Claude Code, add the MCP server configuration to your Claude configuration file: +For Claude Desktop, add the MCP server to your Claude configuration file: **On macOS/Linux:** Add to `~/.config/claude/mcp_servers.json`: @@ -112,7 +124,7 @@ After adding the configuration: 2. Verify the connection in the MCP section of Claude's settings 3. The Pulumi MCP server should appear as an available tool -### GitHub Copilot setup +### GitHub Copilot GitHub Copilot's MCP support is available through compatible editors. Configure in your editor's MCP settings: @@ -134,7 +146,7 @@ Add to your VS Code settings.json: **Other editors:** Refer to your editor's specific MCP integration documentation for configuration details. -### Windsurf setup +### Windsurf In Windsurf, configure the MCP server through the IDE settings: @@ -151,7 +163,7 @@ In Windsurf, configure the MCP server through the IDE settings: } ``` -### Devin setup +### Devin To configure the Pulumi MCP server for Devin: From 1114ccd5021212adb7b93e71e63c995c216ec4c3 Mon Sep 17 00:00:00 2001 From: vova-ivanov Date: Mon, 8 Sep 2025 16:14:46 -0700 Subject: [PATCH 2/3] Updated link --- content/docs/iac/using-pulumi/mcp-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/iac/using-pulumi/mcp-server.md b/content/docs/iac/using-pulumi/mcp-server.md index ce99769591e3..ec4466bff946 100644 --- a/content/docs/iac/using-pulumi/mcp-server.md +++ b/content/docs/iac/using-pulumi/mcp-server.md @@ -57,7 +57,7 @@ npx @pulumi/mcp-server Add the Pulumi MCP server to Cursor by clicking the following button: -[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=pulumi&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IEBwdWx1bWkvbWNwLXNlcnZlciJ9) +[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=pulumi&config=eyJjb21tYW5kIjoibnB4IEBwdWx1bWkvbWNwLXNlcnZlckBsYXRlc3Qgc3RkaW8ifQ%3D%3D) Alternatively, create a `mcp.json` file in the `.cursor` directory at your project root: From 2120ab7230ec23acf73704a1e1b4a6767909b37c Mon Sep 17 00:00:00 2001 From: vova-ivanov Date: Thu, 2 Oct 2025 13:35:14 -0700 Subject: [PATCH 3/3] Reverted Claude Code line to match URL. --- content/docs/iac/using-pulumi/mcp-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/iac/using-pulumi/mcp-server.md b/content/docs/iac/using-pulumi/mcp-server.md index 8aea6b8782a0..a4b59314f049 100644 --- a/content/docs/iac/using-pulumi/mcp-server.md +++ b/content/docs/iac/using-pulumi/mcp-server.md @@ -33,7 +33,7 @@ This enables a more intuitive, conversational approach to infrastructure develop The Pulumi MCP server works with various AI-powered development tools: - **[Cursor](https://cursor.sh/)** - AI-first code editor -- **[Anthropic's Claude](https://claude.ai/code)** - AI assistant for coding +- **[Anthropic's Claude Code](https://claude.ai/code)** - AI assistant for coding - **[GitHub Copilot](https://github.com/features/copilot)** - AI pair programmer - **[Windsurf](https://codeium.com/windsurf)** - AI development environment - **[Devin](https://app.devin.ai/)** - The AI