diff --git a/dify-agent/pyproject.toml b/dify-agent/pyproject.toml
index 47fff6256b..662fa89ca5 100644
--- a/dify-agent/pyproject.toml
+++ b/dify-agent/pyproject.toml
@@ -64,7 +64,7 @@ dev = [
     "ruff>=0.15.11",
 ]
 docs = [
-    "mkdocs>=1.6.1",
+    "mkdocs>=1.6.1,<2",
     "mkdocs-glightbox>=0.4.0",
     "mkdocs-material>=9.7.0",
     "mkdocstrings-python>=2.0.0",
diff --git a/dify-agent/uv.lock b/dify-agent/uv.lock
index f30a65fff5..983ca72035 100644
--- a/dify-agent/uv.lock
+++ b/dify-agent/uv.lock
@@ -631,7 +631,7 @@ dev = [
     { name = "ruff", specifier = ">=0.15.11" },
 ]
 docs = [
-    { name = "mkdocs", specifier = ">=1.6.1" },
+    { name = "mkdocs", specifier = ">=1.6.1,<2" },
     { name = "mkdocs-glightbox", specifier = ">=0.4.0" },
     { name = "mkdocs-material", specifier = ">=9.7.0" },
     { name = "mkdocstrings-python", specifier = ">=2.0.0" },