From c4e77ada454cac4259da2a357cc391cfbea248c8 Mon Sep 17 00:00:00 2001
From: Mendon Kissling <59585235+mendonk@users.noreply.github.com>
Date: Thu, 30 Oct 2025 17:28:50 -0400
Subject: [PATCH] docs: add partials for npx requirements and podman (#10453)
* add-partial-for-mcp-note
* use-podman-option
* reword
---
docs/docs/Agents/mcp-client.mdx | 8 +++-----
docs/docs/Agents/mcp-component-astra.mdx | 3 +++
docs/docs/Deployment/deployment-docker.mdx | 4 ++++
docs/docs/Deployment/develop-application.mdx | 3 +++
docs/docs/_partial-mcp-node-tip.mdx | 8 ++++++++
docs/docs/_partial-podman-alt.mdx | 3 +++
6 files changed, 24 insertions(+), 5 deletions(-)
create mode 100644 docs/docs/_partial-mcp-node-tip.mdx
create mode 100644 docs/docs/_partial-podman-alt.mdx
diff --git a/docs/docs/Agents/mcp-client.mdx b/docs/docs/Agents/mcp-client.mdx
index 806781c7be..f358813453 100644
--- a/docs/docs/Agents/mcp-client.mdx
+++ b/docs/docs/Agents/mcp-client.mdx
@@ -5,6 +5,7 @@ slug: /mcp-client
import Icon from "@site/src/components/icon";
import McpIcon from '@site/static/logos/mcp-icon.svg';
+import PartialMcpNodeTip from '@site/docs/_partial-mcp-node-tip.mdx';
Langflow integrates with the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) as both an MCP server and an MCP client.
@@ -35,11 +36,8 @@ This component has two modes, depending on the type of server you want to access
* **SSE**: Enter your Langflow MCP server's **Name**, **SSE URL**, and any **Headers** and **Environment Variables** the server uses, and then click **Add Server**.
The default **SSE URL** is `http://localhost:7860/api/v1/mcp/sse`. For more information, see [Use SSE mode](#mcp-sse-mode).
- :::tip
- `uvx` is included with `uv` in the Langflow package.
- To use `npx` server commands, you must first install an LTS release of [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
- For an example of an `npx` MCP server in Langflow, see [Connect an Astra DB MCP server to Langflow](/mcp-component-astra).
- :::
+
+
3. To use environment variables in your server command, enter each variable in the **Env** fields as key-value pairs.
diff --git a/docs/docs/Agents/mcp-component-astra.mdx b/docs/docs/Agents/mcp-component-astra.mdx
index b45f84d740..8ef93c7fe5 100644
--- a/docs/docs/Agents/mcp-component-astra.mdx
+++ b/docs/docs/Agents/mcp-component-astra.mdx
@@ -4,11 +4,14 @@ slug: /mcp-component-astra
---
import Icon from "@site/src/components/icon";
+import PartialMcpNodeTip from '@site/docs/_partial-mcp-node-tip.mdx';
This guide demonstrates how to [use Langflow as an MCP client](/mcp-client) by using the **MCP Tools** component to run a [DataStax Astra DB MCP server](https://github.com/datastax/astra-db-mcp) in an agent flow.
1. Install an LTS release of [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
+
+
2. Create an [OpenAI](https://platform.openai.com/) API key.
3. Create an [Astra DB Serverless (Vector) database](https://docs.datastax.com/en/astra-db-serverless/databases/create-database.html#create-vector-database), if you don't already have one.
diff --git a/docs/docs/Deployment/deployment-docker.mdx b/docs/docs/Deployment/deployment-docker.mdx
index 4ff9461a7c..bbd92921bd 100644
--- a/docs/docs/Deployment/deployment-docker.mdx
+++ b/docs/docs/Deployment/deployment-docker.mdx
@@ -3,6 +3,10 @@ title: Deploy Langflow on Docker
slug: /deployment-docker
---
+import PartialPodmanAlt from '@site/docs/_partial-podman-alt.mdx';
+
+
+
Running applications in Docker containers ensures consistent behavior across different systems and eliminates dependency conflicts.
You can use the Langflow Docker image to start a Langflow container.
diff --git a/docs/docs/Deployment/develop-application.mdx b/docs/docs/Deployment/develop-application.mdx
index 0b5f17d535..bb66aef6c5 100644
--- a/docs/docs/Deployment/develop-application.mdx
+++ b/docs/docs/Deployment/develop-application.mdx
@@ -4,6 +4,9 @@ slug: /develop-application
---
import Icon from "@site/src/components/icon";
+import PartialPodmanAlt from '@site/docs/_partial-podman-alt.mdx';
+
+
Designing flows in the visual editor is only the first step in building an application that uses Langflow.
diff --git a/docs/docs/_partial-mcp-node-tip.mdx b/docs/docs/_partial-mcp-node-tip.mdx
new file mode 100644
index 0000000000..08b69ca928
--- /dev/null
+++ b/docs/docs/_partial-mcp-node-tip.mdx
@@ -0,0 +1,8 @@
+:::tip
+`uvx` is included with `uv` in the Langflow package.
+
+To use `npx` server commands, you must first install an LTS release of [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm). If you run Langflow in Docker, install Node.js inside the container image and rebuild so that `npx`-based MCP servers are available at runtime. For more information, see [Package management](/develop-application#package-management).
+
+For an example of an `npx` MCP server in Langflow, see [Connect an Astra DB MCP server to Langflow](/mcp-component-astra).
+:::
+
diff --git a/docs/docs/_partial-podman-alt.mdx b/docs/docs/_partial-podman-alt.mdx
new file mode 100644
index 0000000000..59fbeea9b1
--- /dev/null
+++ b/docs/docs/_partial-podman-alt.mdx
@@ -0,0 +1,3 @@
+:::tip
+Podman can be used instead of Docker for all commands shown here. For more information, see the [Podman documentation](https://podman.io/docs).
+:::
\ No newline at end of file