Skip to content

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.)

  • What you need
  • The connection URL
  • Connecting your assistant
  • Trying it out
  • Correcting a program error
  • 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.

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>/mcp
Authorization: Bearer asmk_…

You give your assistant two things: this URL and your API key (the asmk_… value) as the bearer token.

The exact steps depend on the app, but the shape is always the same:

  1. In your assistant, add a custom MCP server (sometimes called a “connector” or “tool server”).
  2. Set the server URL to the /mcp URL shown on the API & agent access page.
  3. Set the authorization to a bearer token and paste your asmk_… key.
  4. Save. Your assistant should now list Assemblified’s eight tools: run (the main one), search, describe_api, list_docs, get_doc, whoami, list_skills and get_skill. What each one does is on the overview.

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.

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.