@crypto512/jicon-mcp 1.0.3 → 1.1.0

package/README.md

@@ -189,10 +189,47 @@ This configuration allows:
 
 The `confluenceWriteHome: true` setting ensures all Confluence write operations (drafts, comments, attachments) can only target your personal space, preventing accidental modifications to shared team spaces.
 
-**Virtual actions** (for whitelist): `jira_read`, `jira_write`, `jira_all`, `confluence_read`, `confluence_write`, `confluence_all`, `tempo_read`, `tempo_write`, `tempo_all`
+**Draft Only** - create new documents without reading existing content:
+```json
+{
+  "permissions": {
+    "mode": "custom",
+    "whitelist": ["confluence_draft"]
+  }
+}
+```
+
+Includes: `confluence_draft_create`, `confluence_draft_save`, `confluence_draft_delete`, plus space discovery (`confluence_get_current_user_space`, `confluence_list_spaces`) to know where to create drafts. No page content is exposed.
+
+**Virtual actions** (for whitelist): `jira_read`, `jira_write`, `jira_all`, `confluence_read`, `confluence_write`, `confluence_draft`, `confluence_all`, `tempo_read`, `tempo_write`, `tempo_all`
 
 **Individual tools** (for blacklist): See [TOOL_LIST.md](TOOL_LIST.md) for all tool names (e.g., `confluence_delete_page`, `tempo_delete_worklog`)
 
+### Docker Configuration
+
+PlantUML validation requires Docker. The container starts when MCP loads and does **not auto-restart** if it stops - you'll need to restart the MCP server.
+
+**Disable Docker/PlantUML** - if you don't need PlantUML validation:
+```json
+{ "disableDocker": true }
+```
+
+When disabled, PlantUML tools return clear errors instead of failing silently.
+
+### PlantUML Include Expansion
+
+C4-PlantUML, AWS icons, and Azure diagrams require `!include` directives. By default, Jicon expands these includes client-side before validation and sending to Confluence.
+
+**Whitelisted URLs:**
+- `https://raw.githubusercontent.com/plantuml-stdlib/` - C4, Azure, Kubernetes, etc.
+- `https://raw.githubusercontent.com/plantuml/` - Official PlantUML stdlib
+- `https://raw.githubusercontent.com/awslabs/aws-icons-for-plantuml/` - AWS icons
+
+**Disable include expansion** (if you encounter issues):
+```json
+{ "plantumlInclude": false }
+```
+
 ## Authentication
 
 ### Atlassian Cloud
@@ -218,7 +255,7 @@ The `confluenceWriteHome: true` setting ensures all Confluence write operations
 
 ## Features
 
-### 63 Tools Across 3 Services
+### 64 Tools Across 3 Services
 
 | Service | Capabilities |
 |---------|--------------|
@@ -240,7 +277,7 @@ This means the AI assistant **never directly publishes** to shared team spaces -
 
 ### PlantUML Diagrams
 
-Create and validate UML diagrams directly in Confluence pages. Requires Docker for full syntax validation.
+Create and validate UML diagrams directly in Confluence pages. The PlantUML Docker container starts automatically when the MCP server loads (if Docker is available). If Docker is unavailable or the container stops, PlantUML tools return clear errors - restart the MCP server to retry. Use `"disableDocker": true` in config to skip PlantUML entirely.
 
 ## Tool Reference