@cplace/mcp-server 1.5.1 → 1.5.2

package/README.md

@@ -35,8 +35,6 @@ claude mcp add --transport http cplace https://mcp.cplace.com --header "cplace-u
 }
 ```
 
-Authentication is handled through the remote server's OAuth flow — no API token configuration needed in the MCP client.
-
 ### Local Installation (Alternative)
 
 If you prefer to run the MCP server locally (e.g., for development or air-gapped environments), you can install it via npx.

package/dist/widget-specifications/_research_from_ga_products/cf-cplace-treeTableWidget/research.md

@@ -62,6 +62,7 @@ The `cf.cplace.treeTableWidget` is a concrete implementation of the platform's a
    - Create dashboard pages with hierarchical navigation
    - Provide overview pages showing entire page structures
    - Serve as entry points to complex information architectures
+   - Place on type layout pages where the embedding page is a concrete data instance
 
 ### When to Use This Widget:
 
@@ -385,6 +386,7 @@ src/main/resources/
 2. **Single Hierarchy**: Uses one parent attribute at a time (no multiple relationship types)
 3. **Platform Rendering**: Limited to platform's rendering capabilities (can't customize without TypeScript)
 4. **Error Handling**: Throws `TreeUnconstructableException` if embedded in a TypeDefinition page
+5. **Dashboard limitation without explicit root**: Root node resolves as: (1) connected table selection, (2) configured `rootNode`, (3) embedding page fallback. On dashboards without a configured root, the fallback uses the dashboard page — which has no hierarchy children — resulting in a single empty row. Configure an explicit `rootNode` to use on dashboards, or prefer `cf.platform.embeddedSearchAsTable` with grouping.
 
 ### Best Practices:
 

package/dist/widget-specifications/cf.cplace.dynamicCodeBlockWidget.dynamicCodeBlockWidget/_overview.md

@@ -2,6 +2,8 @@
 
 Represents a dynamically generated code block with content defined using cplaceJS. The widget displays formatted code snippets with syntax highlighting, where the code content is generated dynamically through a cplaceJS script. This widget is useful for showing code examples, configuration snippets, or any text content that benefits from code formatting, with the content determined at runtime based on page data or other dynamic criteria.
 
+> **Text-only rendering**: This widget renders content as **plain text** inside `<pre><code>` using `ng-bind` (equivalent to `textContent`). It does **not** render HTML. Any HTML tags in the script return value are displayed as literal text, not rendered. For scripted HTML output (KPI cards, pivot tables, dynamic banners, formatted content), use the **Low-Code Text** widget (`cf.cplace.lowCodeWidgets.lowCodeText`) embedded inside a **Rich String** or **Text without Widget Frame** container.
+
 **Use when you need to:**
 - Display code examples or snippets that change based on page context
 - Show dynamically generated configuration files or scripts
@@ -10,7 +12,7 @@ Represents a dynamically generated code block with content defined using cplaceJ
 
 **Alternatives:**
 - **Rich Text Widget** - For static code blocks or when content doesn't need to be generated dynamically
-- **Low-Code Text Widget** - For plain text output without code formatting
+- **Low-Code Text Widget** (`cf.cplace.lowCodeWidgets.lowCodeText`) - For scripted HTML output rendered inline within a rich string container
 
 ## Operating Modes
 
@@ -40,6 +42,7 @@ Use the Dynamic Code Block when:
 
 Avoid when:
 - The code content is static and doesn't change (use Rich Text instead)
+- You need rendered HTML output such as KPI cards, formatted tables, or styled content (use Low-Code Text embedded in a Rich String instead)
 - You need user interaction with the code (editing, copying with click)
 - The output is better suited to table or structured display
 - Performance is critical and the script is computationally expensive

package/dist/widget-specifications/cf.cplace.lowCodeWidgets.lowCodeText/_overview.md

@@ -53,6 +53,7 @@ This widget can **only** be embedded inside rich string widgets. It cannot be pl
 ## Design Considerations
 
 ### When to Use This Widget
+- You need scripted HTML output — this is the correct widget for rendering HTML from cplaceJS scripts (not `dynamicCodeBlockWidget`, which is text-only)
 - You need dynamic, script-computed content within a rich text layout
 - The content should update reactively based on connected table interactions
 - You want inline computed values (metrics, status text, formatted data) mixed with static rich text

package/dist/widget-specifications/cf.cplace.treeTableWidget/_overview.md

@@ -19,7 +19,10 @@ Show document folder structures and content hierarchies such as chapters, sectio
 Display product hierarchies, component breakdowns, and system architectures. Navigate through technical structures and dependencies.
 
 ### Navigation and Overview Pages
-Create dashboard pages with hierarchical navigation, provide overview pages showing entire page structures, and serve as entry points to complex information architectures.
+Provide overview pages showing entire page structures and serve as entry points to complex information architectures. Place this widget on type layout pages where the embedding page is a concrete data instance with hierarchy relationships.
+
+### Limitations
+- **Not suitable for dashboards without explicit root node configuration**: The widget resolves its root node in priority order: (1) connected table selection, (2) explicitly configured `rootNode`, (3) embedding page fallback. On a dashboard page without a configured root node, the fallback uses the dashboard page itself as root. Since no data pages reference the dashboard page through hierarchy attributes, the tree shows only the dashboard page as a single empty row. To use this widget on a dashboard, configure an explicit `rootNode` — or prefer `cf.platform.embeddedSearchAsTable` with grouping for dashboard-based hierarchical views.
 
 ## Design Considerations
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cplace/mcp-server",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "MCP server that provides Claude Desktop with tools to interact with cplace APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",