Product Associations
Products can now be linked to personas, company ICPs and competitor products through a generic association model. MCP server v2.0.0 replaces the old flat…
## 🚀 What's New Products are no longer limited to one ideal company profile and a bare list of persona IDs. Any object in a brand kit can now be associated with any other object in the same brand kit under a labelled relationship. ### The Problem Product targeting lived in two flat columns on the product record: a single **target company ICP** and an array of **persona IDs**. Neither was editable through the MCP server, neither could express a competitor comparison, and adding a fourth kind of link meant adding a fifth column. ### What's New **A generic association model.** One table holds every link, with a source object, a target object and a relationship type. Products are the first type wired up: product to persona, product to company ICP, product to competitor product. Adding a new object type later is configuration, not a schema change. **Manual linking in the product editor.** The product dialog has an **Associations** panel with one picker per target type. Every picker is scoped to the current brand kit, and a product can now target more than one company ICP. **Reciprocal views.** A persona, a company ICP and a competitor product each show the products linked to them, read from the same rows in the other direction. **MCP writes.** `update_brand_kit_product` takes an `associations` parameter with `add` and `remove` lists. These are diffs, not a full-array replace, so editing one link cannot clobber a concurrent change to the rest. Both `dry_run` and `confirm` work as they do on every other write tool. ### ⚠️ Breaking change for MCP clients Server **v2.0.0**. `get_brand_kit_products` no longer returns `target_company_icp_id` or `target_persona_ids`. Read targeting from the new `associations` array instead: ```json "associations": [ { "target_type": "persona", "target_id": "…", "relationship_type": "targets_persona" }, { "target_type": "company_icp", "target_id": "…", "relationship_type": "targets_company_icp" } ] ``` Existing links were migrated with no data loss; the old columns have been removed rather than left dead. ### How to Verify 1. Open a brand kit, go to **Products** and edit a product. 2. Scroll to **Associations** and link a persona, a company ICP and a competitor product. 3. Open that persona and confirm the product appears under **Associated Products**. 4. From an MCP client, call `get_brand_kit_products` and confirm the `associations` array reflects what you linked.