diff --git a/README.md b/README.md
index d5df6eb..8a6da97 100644
--- a/README.md
+++ b/README.md
@@ -14,9 +14,12 @@ MusicXML sheet music plugin for GUI Chat applications. Displays and plays sheet
 ## Installation
 
 ```bash
-yarn add @gui-chat-plugin/music
+yarn add @gui-chat-plugin/music gui-chat-protocol
 ```
 
+> `gui-chat-protocol` is a peer dependency — install it alongside the plugin; the host application provides the runtime and this plugin only declares the compatible range.
+
+
 ## Usage
 
 ### Vue Integration
diff --git a/package.json b/package.json
index a6e92c5..1bb8ad7 100644
--- a/package.json
+++ b/package.json
@@ -37,11 +37,11 @@
     "tar": ">=7.5.7"
   },
   "peerDependencies": {
-    "vue": "^3.5.0"
+    "vue": "^3.5.0",
+    "gui-chat-protocol": "^1.2.0"
   },
   "dependencies": {
     "@modernized/osmd-audio-player": "^1.0.2",
-    "gui-chat-protocol": "^1.2.0",
     "jspdf": "^4.2.1",
     "svg2pdf.js": "^2.7.0"
   },
@@ -59,7 +59,8 @@
     "vite": "^8.1.5",
     "vue": "^3.5.40",
     "vue-eslint-parser": "^10.4.1",
-    "vue-tsc": "^3.3.8"
+    "vue-tsc": "^3.3.8",
+    "gui-chat-protocol": "^1.2.0"
   },
   "keywords": [
     "guichat",