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

• What you need
• The endpoint
• Connecting your assistant
• Trying it out

What you need

• An active Assemblified subscription (LLM / API 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.

The endpoint

Your store has a single MCP endpoint. The exact URL is shown on the LLM / API Access page in the Connect your LLM card; it 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.

Connecting your assistant

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 endpoint shown on the LLM / API Access page.
3. Set the authorization to a bearer token and paste your asmk_… key.
4. Save. Your assistant should now list Assemblified’s tools — the main one is run.

Note

Each assistant has its own way of storing MCP servers (a config file, a settings screen, or a CLI command). Check that app’s own documentation for where to add a custom MCP server with a bearer token; the values to enter are the URL and key above.

Trying it out

Once connected, ask your assistant a question in plain language, such as “List my raw 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. If you get an authorization error, the key may be wrong or revoked — create a fresh key and try again.

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.