From 4467a3fd75b1d19bba5221c0b1e5ecc1ab0a2359 Mon Sep 17 00:00:00 2001
From: Ethan Ruhe <ethan.ruhe@temporal.io>
Date: Wed, 21 Jan 2026 14:25:44 -0500
Subject: [PATCH 1/3] docs: add "Use with AI" page for MCP server setup

Add documentation for connecting Temporal docs to AI tools via the
MCP server at temporal.mcp.kapa.ai. Includes setup instructions for
Claude Code, Claude Desktop, and other MCP-compatible tools.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/with-ai.mdx | 56 ++++++++++++++++++++++++++++++++++++++++++++++++
 sidebars.js      |  1 +
 2 files changed, 57 insertions(+)
 create mode 100644 docs/with-ai.mdx

diff --git a/docs/with-ai.mdx b/docs/with-ai.mdx
new file mode 100644
index 0000000000..c8f607e6d0
--- /dev/null
+++ b/docs/with-ai.mdx
@@ -0,0 +1,56 @@
+---
+id: with-ai
+title: Use These Docs with AI
+sidebar_label: Use with AI
+description: Connect Temporal documentation to your AI tools for real-time, accurate answers.
+---
+
+# Use These Docs with AI
+
+Connect Temporal documentation directly to your AI assistant for accurate, up-to-date answers about Temporal.
+The Temporal docs MCP server gives AI tools real-time access to our documentation, so responses draw from current docs rather than training data.
+
+## Claude Code
+
+Add the Temporal docs MCP server to Claude Code with a single command:
+
+```bash
+claude mcp add --scope user --transport http temporal-docs https://temporal.mcp.kapa.ai
+```
+
+This adds the server globally so it's available in all your projects.
+
+To add it to a specific project only (stored in `.mcp.json`):
+
+```bash
+claude mcp add --transport http temporal-docs https://temporal.mcp.kapa.ai
+```
+
+After adding, restart Claude Code for the changes to take effect.
+
+## Claude Desktop
+
+1. Open Claude Desktop settings
+2. Navigate to **Settings > Connectors**
+3. Add a new MCP server with the URL: `https://temporal.mcp.kapa.ai`
+
+## Other MCP-compatible tools
+
+For any tool that supports the Model Context Protocol, use the following server URL:
+
+```
+https://temporal.mcp.kapa.ai
+```
+
+Configuration format varies by tool. Here's a generic JSON configuration:
+
+```json
+{
+  "mcpServers": {
+    "temporal-docs": {
+      "transport": "http",
+      "url": "https://temporal.mcp.kapa.ai"
+    }
+  }
+}
+```
diff --git a/sidebars.js b/sidebars.js
index b807a27210..67262e86e8 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -861,6 +861,7 @@ module.exports = {
       ],
     },
     'glossary',
+    'with-ai',
     // {
     //   type: "autogenerated",
     //   dirName: "./dev-guide", // '.' means the current docs folder

From cd7dca50b33d2be7546c3d6b29faaa08ace8b076 Mon Sep 17 00:00:00 2001
From: Ethan Ruhe <ethan.ruhe@temporal.io>
Date: Thu, 22 Jan 2026 20:04:46 -0500
Subject: [PATCH 2/3] Add note about anonymous Google auth requirement for MCP
 server

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/with-ai.mdx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/with-ai.mdx b/docs/with-ai.mdx
index c8f607e6d0..ce2ccc502e 100644
--- a/docs/with-ai.mdx
+++ b/docs/with-ai.mdx
@@ -10,6 +10,9 @@ description: Connect Temporal documentation to your AI tools for real-time, accu
 Connect Temporal documentation directly to your AI assistant for accurate, up-to-date answers about Temporal.
 The Temporal docs MCP server gives AI tools real-time access to our documentation, so responses draw from current docs rather than training data.
 
+The server requires anonymous authentication using any Google account to enforce rate limits and prevent abuse.
+We cannot see nor do we collect any contact information from this.
+
 ## Claude Code
 
 Add the Temporal docs MCP server to Claude Code with a single command:

From af7331c7370ff228e4971ab0ed970ce6a70d421a Mon Sep 17 00:00:00 2001
From: Ethan Ruhe <ethan.ruhe@temporal.io>
Date: Sat, 24 Jan 2026 00:01:10 -0500
Subject: [PATCH 3/3] Add /mcp authentication instruction for Claude Code

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/with-ai.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/with-ai.mdx b/docs/with-ai.mdx
index ce2ccc502e..d253a2df4f 100644
--- a/docs/with-ai.mdx
+++ b/docs/with-ai.mdx
@@ -29,7 +29,7 @@ To add it to a specific project only (stored in `.mcp.json`):
 claude mcp add --transport http temporal-docs https://temporal.mcp.kapa.ai
 ```
 
-After adding, restart Claude Code for the changes to take effect.
+After adding, restart Claude Code and run `/mcp` to authenticate with your Google account.
 
 ## Claude Desktop