From dd92721b9df556909ac2dc656dc78ea9727210d5 Mon Sep 17 00:00:00 2001
From: isshaddad <issamhaddad47@gmail.com>
Date: Tue, 28 Apr 2026 09:15:02 -0400
Subject: [PATCH 1/2] docs(mcp): clarify --readonly is a runtime flag, not an
 install-mcp option

---
 docs/mcp-introduction.mdx | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/docs/mcp-introduction.mdx b/docs/mcp-introduction.mdx
index 13a5de7a47b..69e0f0908e5 100644
--- a/docs/mcp-introduction.mdx
+++ b/docs/mcp-introduction.mdx
@@ -310,7 +310,6 @@ The `install-mcp` command supports these options:
 - `-p, --project-ref <project ref>` — Scope the MCP server to a specific project
 - `-t, --tag <package tag>` — CLI package version to use (default: latest)
 - `--dev-only` — Restrict to the dev environment only
-- `--readonly` — Read-only mode. Hides write tools (`deploy`, `trigger_task`, `cancel_run`) so the AI cannot make changes to your account
 - `--yolo` — Install into all supported clients automatically
 - `--scope <scope>` — `user`, `project`, or `local`
 - `--client <clients...>` — Install into specific client(s)
@@ -341,17 +340,17 @@ Restrict to dev environment for a specific project:
 npx trigger.dev@latest install-mcp --dev-only --project-ref proj_abc123
 ```
 
-Read-only mode (prevents AI from deploying or triggering tasks):
+**Runtime-only flags**
 
-```bash
-npx trigger.dev@latest install-mcp --readonly
-```
+Some flags apply only to the running MCP server, not to `install-mcp`. Add these to the `args` array of the generated MCP config after installation:
+
+- `--readonly` — Read-only mode. Hides write tools (`deploy`, `trigger_task`, `cancel_run`) so the AI cannot make changes to your account.
 
-To add these options to a manual config, append them to the `args` array:
+For example, to enable read-only mode together with `--dev-only` and a project ref:
 
 ```json
 {
-  "args": ["trigger.dev@latest", "mcp", "--dev-only", "--project-ref", "proj_abc123"]
+  "args": ["trigger.dev@latest", "mcp", "--readonly", "--dev-only", "--project-ref", "proj_abc123"]
 }
 ```
 

From 6589b455bc00b2d79e335e720a8adb538eeee07c Mon Sep 17 00:00:00 2001
From: isshaddad <issamhaddad47@gmail.com>
Date: Tue, 28 Apr 2026 09:27:28 -0400
Subject: [PATCH 2/2] coderabbit fixes

---
 docs/mcp-introduction.mdx | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/docs/mcp-introduction.mdx b/docs/mcp-introduction.mdx
index 69e0f0908e5..3505285a8b8 100644
--- a/docs/mcp-introduction.mdx
+++ b/docs/mcp-introduction.mdx
@@ -346,14 +346,28 @@ Some flags apply only to the running MCP server, not to `install-mcp`. Add these
 
 - `--readonly` — Read-only mode. Hides write tools (`deploy`, `trigger_task`, `cancel_run`) so the AI cannot make changes to your account.
 
-For example, to enable read-only mode together with `--dev-only` and a project ref:
+For example, to enable read-only mode in Claude Code together with `--dev-only` and a project ref, edit `~/.claude.json` (user) or `.mcp.json` (project):
 
 ```json
 {
-  "args": ["trigger.dev@latest", "mcp", "--readonly", "--dev-only", "--project-ref", "proj_abc123"]
+  "mcpServers": {
+    "trigger": {
+      "command": "npx",
+      "args": [
+        "trigger.dev@latest",
+        "mcp",
+        "--readonly",
+        "--dev-only",
+        "--project-ref",
+        "proj_abc123"
+      ]
+    }
+  }
 }
 ```
 
+For other clients, use the config shape shown in the corresponding tab in [Client Configuration](#client-configuration) and append the same flags to that entry's `args` array (or to the `command` array, for opencode).
+
 </Accordion>
 
 ## Getting Started