@kolbo/mcp 1.52.0 → 1.52.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.52.0",
+  "version": "1.52.1",
   "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -109,6 +109,7 @@ function createServer(opts = {}) {
     // The single most common failure mode is project confusion — spell out
     // the project contract here so every client gets it without a skill file.
     instructions: [
+      'LOCAL FILES: never upload a user file yourself with cloud credentials, a shell command, or an S3/Spaces script — Kolbo owns this. Over a remote connector (claude.ai / Claude Desktop) the server cannot see local paths at all: call `media_upload_widget` so the user picks the file, then pass the returned https:// URL to the generation/transcription tool. Use `upload_media` only when the path IS reachable from where the MCP server runs (local stdio installs). `list_media` returns URLs for assets already in the library.',
       'PROMPT CONVENTIONS (Kolbo-specific — these change the OUTPUT, not just the metadata):',
       'A. Visual DNA: passing `visual_dna_ids` is not enough — every DNA in play must ALSO be tagged inside the prompt text as `@Name`, using the DNA name (e.g. "@Kobi walks into frame"). Moodboards are referenced the same way with `#Name`. Resolve names via `list_visual_dnas` / `list_moodboards`.',
       'B. The full Kolbo skill is available to you as MCP RESOURCES under `kolbo://skill/`. Read `kolbo://skill/SKILL.md` first — it is the core rules plus a routing index — then read the matching `kolbo://skill/references/...` file before writing prompts for a specific model or workflow (per-model prompt rules, Visual DNA workflow, Creative Director, marketing, cost validation). Do this instead of guessing; the references exist precisely because the rules differ per model.',

package/src/tools/_shared.js

@@ -186,8 +186,11 @@ async function resolveToBuffer(source, kind, opts = {}) {
   if (!path.isAbsolute(source)) {
     throw new Error(
       `Local file paths must be absolute: ${source}. ` +
-      `If you are using Kolbo over a remote connector (e.g. claude.ai), local files are not reachable — ` +
-      `pass a public https:// URL instead (upload the file somewhere first, or use a URL from list_media).`
+      `If you are using Kolbo over a remote connector (e.g. claude.ai), local files are not reachable. ` +
+      `DO NOT upload the file yourself with cloud credentials or a shell command — Kolbo has a tool for this. ` +
+      `Call \`media_upload_widget\` to have the user pick the file (remote connectors), or \`upload_media\` ` +
+      `when the file IS reachable from where the MCP server runs, then pass the returned https:// URL here. ` +
+      `A URL from \`list_media\` also works if the asset is already in the library.`
     );
   }
   let stat;
@@ -196,8 +199,11 @@ async function resolveToBuffer(source, kind, opts = {}) {
   } catch (err) {
     throw new Error(
       `Local file not found or unreadable: ${source}. ` +
-      `If you are using Kolbo over a remote connector (e.g. claude.ai), local file paths are not reachable — ` +
-      `pass a public https:// URL instead (upload the file somewhere first, or use a URL from list_media).` +
+      `If you are using Kolbo over a remote connector (e.g. claude.ai), local file paths are not reachable. ` +
+      `DO NOT upload the file yourself with cloud credentials or a shell command — Kolbo has a tool for this. ` +
+      `Call \`media_upload_widget\` to have the user pick the file (remote connectors), or \`upload_media\` ` +
+      `when the file IS reachable from where the MCP server runs, then pass the returned https:// URL here. ` +
+      `A URL from \`list_media\` also works if the asset is already in the library.` +
       (err && err.code ? ` [${err.code}]` : '')
     );
   }