From a6fa5825916d063feccab57e1d31bd90b379cdfe Mon Sep 17 00:00:00 2001
From: Anthony LC <anthony.le-courric@mail.numerique.gouv.fr>
Date: Fri, 31 Jul 2026 23:17:57 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=A7=91=E2=80=8D=F0=9F=92=BB(mcp)=20add=20?=
 =?UTF-8?q?an=20mcp-inspector=20helper?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add a `yarn mcp-inspector` script that launches
`@modelcontextprotocol/inspector` against the local
docs-mcp server, with a checked-in config pre-filling
the URL and the `docs-mcp-client`
OAuth client and scopes so there is nothing to type
in by hand.
---
 src/frontend/servers/mcp/mcp-inspector.config.json | 12 ++++++++++++
 src/frontend/servers/mcp/package.json              |  3 ++-
 2 files changed, 14 insertions(+), 1 deletion(-)
 create mode 100644 src/frontend/servers/mcp/mcp-inspector.config.json

diff --git a/src/frontend/servers/mcp/mcp-inspector.config.json b/src/frontend/servers/mcp/mcp-inspector.config.json
new file mode 100644
index 000000000..056811f76
--- /dev/null
+++ b/src/frontend/servers/mcp/mcp-inspector.config.json
@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "docs-mcp": {
+      "type": "http",
+      "url": "http://localhost:4455/mcp",
+      "oauth": {
+        "clientId": "docs-mcp-client",
+        "scopes": "openid docs:documents:search docs:documents:read docs:documents:create docs-mcp"
+      }
+    }
+  }
+}
diff --git a/src/frontend/servers/mcp/package.json b/src/frontend/servers/mcp/package.json
index d06a789ea..376052019 100644
--- a/src/frontend/servers/mcp/package.json
+++ b/src/frontend/servers/mcp/package.json
@@ -10,7 +10,8 @@
     "dev": "nodemon --config nodemon.json",
     "start": "node ./dist/start-server.js",
     "lint": "eslint",
-    "test": "vitest run"
+    "test": "vitest run",
+    "mcp-inspector": "npx @modelcontextprotocol/inspector --config mcp-inspector.config.json"
   },
   "engines": {
     "node": ">=22"