Connect a desktop or CLI client
Desktop and command-line assistants — Claude Desktop, Claude Code, Codex, and custom agents — connect to Assemblified with an API key sent as a bearer token. (Web-chat apps like claude.ai and ChatGPT connect differently — see Connect claude.ai or ChatGPT.)
On this page
Section titled “On this page”- What you need
- The connection URL
- Connecting your assistant
- Trying it out
- Correcting a program error
What you need
Section titled “What you need”- An active Assemblified subscription (API & agent access is in open beta).
- An API key you’ve already created and copied.
- An MCP-capable assistant that lets you add a custom MCP server with a bearer token. Assemblified supports the MCP protocol versions 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25 and 2026-07-28. Protocol support alone does not guarantee that every client or version can connect; see connection troubleshooting.
The connection URL
Section titled “The connection URL”Your store has a single MCP connection URL. Open Settings → Connections → API & agent access. The exact URL is shown in its Connect your LLM card and ends in /mcp:
POST https://<your-assemblified-app-url>/mcpAuthorization: Bearer asmk_…You give your assistant two things: this URL and your API key (the asmk_… value) as the bearer token.
Connecting your assistant
Section titled “Connecting your assistant”The exact steps depend on the app, but the shape is always the same:
- In your assistant, add a custom MCP server (sometimes called a “connector” or “tool server”).
- Set the server URL to the
/mcpURL shown on the API & agent access page. - Set the authorization to a bearer token and paste your
asmk_…key. - Save. Your assistant should now list Assemblified’s eight tools:
run(the main one),search,describe_api,list_docs,get_doc,whoami,list_skillsandget_skill. What each one does is on the overview.
Trying it out
Section titled “Trying it out”Once connected, ask your assistant a question in plain language, such as “List my materials.” Behind the scenes it calls the run tool with a short program:
run("return await app.rawMaterials.list({});");If it comes back with your real materials, you’re connected. You can also ask “Which store am I connected to?”: the assistant answers with your store, the key’s scope and the label you gave the key. If Assemblified returns 401 with a JSON unauthorized message, check the URL, bearer-token configuration and revocation state. Replace a key only if it is unusable or lost. For other refusals or connection failures, follow connection troubleshooting.
Correcting a program error
Section titled “Correcting a program error”If your assistant reports a JavaScript syntax error, ask it to correct the program before trying again. Some short programs include a line and column or a hint to check the end of the code. Other errors may have less specific guidance. Programs must use JavaScript; TypeScript examples describing available actions are reference material.
Before repeating a program that changes data, ask your assistant to inspect its call report and check whether any changes already happened. A failed program can still have completed an earlier change. Read back the affected material or bill before approving another attempt; an error alone does not mean it is safe to repeat the whole program.
See also
Section titled “See also”- API keys — creating and revoking the key you paste here.
- What the assistant can read — the full list of data it can reach.
- Build and stock BOMs from your catalog via the API — the end-to-end assistant workflow.