From a0425903c73d135afb59cd11d87a1b616c8b7685 Mon Sep 17 00:00:00 2001
From: "molecule-ai[bot]" <276602405+molecule-ai[bot]@users.noreply.github.com>
Date: Fri, 17 Apr 2026 22:06:37 +0000
Subject: [PATCH] fix(opencode): update URL example in opencode.md + add
 WORKSPACE_ID env var

The inline JSON example still showed the bare ${MOLECULE_MCP_URL} without
the /workspaces/${WORKSPACE_ID}/mcp path. Updated to match opencode.json fix
in previous commit (bf80f15). Added WORKSPACE_ID to the env section.
---
 docs/integrations/opencode.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/integrations/opencode.md b/docs/integrations/opencode.md
index d659af78..741be90c 100644
--- a/docs/integrations/opencode.md
+++ b/docs/integrations/opencode.md
@@ -16,7 +16,7 @@ Create (or extend) `opencode.json` in your project root:
   "mcpServers": {
     "molecule": {
       "type": "remote",
-      "url": "${MOLECULE_MCP_URL}",
+      "url": "${MOLECULE_MCP_URL}/workspaces/${WORKSPACE_ID}/mcp",
       "headers": { "Authorization": "Bearer ${MOLECULE_MCP_TOKEN}" },
       "description": "Molecule AI A2A orchestration — delegate_task, list_peers, check_task_status"
     }
@@ -89,6 +89,8 @@ Add to your `.env`:
 ```bash
 MOLECULE_MCP_URL=https://api.molecule.ai   # or http://localhost:8080 for local dev
 MOLECULE_MCP_TOKEN=                         # workspace-scoped bearer token from step 2
+WORKSPACE_ID=                               # UUID of the agent workspace opencode acts as
+                                            # find it in Canvas sidebar or GET /workspaces
 ```
 
 See `.env.example` for the canonical reference.