AI / Agent access (MCP)
AI / Agent access lets you connect your own AI assistant — Claude (desktop, web, or CLI), ChatGPT, or a custom agent — to your Assemblified data over MCP (the Model Context Protocol). Once connected, you can ask your assistant about your bills of materialsBill of MaterialsA bill of materials tells Assemblified how to build one unit of a finished good. When a customer orders the finished-good variant, Assemblified deducts the right component quantities from inventory automatically. Read more → , sub-assembliesSub-AssemblyA reusable assembly block that composes into bigger BOMs. Define it once, include it in any BOM. At execution time, Assemblified expands the sub-assembly into its own components recursively. Read more → , and raw materialsRaw materialThe atomic component of a BOM or sub-assembly. Two flavors: a Shopify-linked variant (inventory tracked in Shopify) or a virtual material (DO-side inventory only). Both kinds appear in the same component picker and are consumed identically when a BOM fires — except virtual materials never trigger a Shopify call. Read more → in plain language — and, if you allow it, have the assistant build and update them for you.
In the Assemblified admin this is the LLM / API Access section under Settings.
On this page
Section titled “On this page”- What you can do with it
- How it works (code mode)
- Read-only by default
- Where to next
What you can do with it
Section titled “What you can do with it”Connect an AI assistant and ask things like:
- “Which of my finished goods can I build right now, and what’s the limiting component?”
- “List every raw material that isn’t used in any BOM yet.”
- “Register these Shopify variants as raw materials and build a BOM for the Gift Box Deluxe.”
- “Set the pre-assembled count for this sub-assembly to 12 at my main location — I just counted them.”
- “How many units of this component do I have on hand across all locations?”
The assistant reads live data from your store — and, with write access, makes the changes for you — so there’s no copy-pasting product IDs or exporting spreadsheets.
How it works (code mode)
Section titled “How it works (code mode)”Assemblified exposes a single, powerful tool to your assistant called run. Instead of the assistant chaining dozens of small requests, it writes a short program against a typed app API and Assemblified runs it once, safely, in an isolated sandbox:
run("return await app.rawMaterials.list({});")This “code mode” approach lets the assistant search, filter, join, and summarise your data in one step — for example, finding the right Shopify variants, registering them as raw materials, and composing a BOM from them — without you writing any code yourself. You just ask in plain language; the assistant writes the program.
The app API is organised into five areas:
billOfMaterials— your finished goods and their composition, including per-location pre-assembled stockPre-Assembled InventoryStock of finished sub-assemblies and BOM items that have already been built and are sitting on the shelf. When a work order needs a sub-assembly, it draws from pre-assembled inventory first and only builds fresh ones if the shelf comes up short. Read more → and a buildable calculator (“how many can I build right now?”) that matches the app’s Max Buildable column.assemblyBills— your reusable sub-assembliesSub-AssemblyA reusable assembly block that composes into bigger BOMs. Define it once, include it in any BOM. At execution time, Assemblified expands the sub-assembly into its own components recursively. Read more → , including their pre-assembled stock.rawMaterials— your Shopify-linked and virtualVirtual MaterialA material tracked entirely inside Assemblified — not a Shopify variant. Useful for shop-floor consumables (glue, packaging, labour units) where you need quantity tracking but don't want a Shopify product on your storefront. Read more → raw materials, including per-location virtual stock levels.shopify— read-only access to your live Shopify catalog (search products and variants, list locations) so the assistant can find the right variants before registering them.inventory— real per-location stock levels for any material, plus pre-assembled levels.
Your assistant can also read this very documentation site through two helper tools (list_docs and get_doc), so it can ground its answers in how Assemblified actually works.
Read-only by default
Section titled “Read-only by default”By default, AI / Agent access is read-only: your assistant can look at your data but cannot change anything. If you explicitly grant write access (a write-scope API key, or a web-chat connection granted write when it’s linked), the assistant can also create and update your bills of materials, sub-assemblies, and raw materials — add components, adjust pre-assembled stock, set virtual inventory levels, and toggle BOM settings. Your live Shopify catalog and real inventory levels stay read-only. See the operating pages below for exactly what write access covers.