The Harmon manual

1. Getting started

Harmon is one platform for running a business online. You get a merchant dashboard to manage everything, a live storefront your customers shop, a visual Studio to design that storefront, and an AI assistant that can do the work for you. Depending on what you sell, you turn on one or more verticals: an online store, services and bookings, or a vehicle dealership.

The pieces fit together like this:

• Dashboard: the admin app where you manage products, orders, customers, promotions, settings and billing. This is your home base.
• Storefront: your public shop, live on your own web address, where customers browse and check out.
• Storefront Studio: the visual editor where you pick a template and design the storefront without code.
• Ask Harmon: the built-in AI assistant that takes actions in your store on your behalf.
• MCP server: the same assistant tools, exposed so you can connect your store to Claude, Cursor or any other AI client you already use.
• Marketplace: where you install extensions and add-ons (payments, chat, reviews, analytics and more).

Create your account

1. Sign up with your work email and a name for your store. Your store gets its own web address straight away.
2. Pick your business type so Harmon turns on the right vertical and sets sensible defaults.
3. Add your products (or vehicles, or services) and a payment method, then open the Studio to make the storefront yours.
4. Publish. Your storefront is live, and you can change anything later as often as you like.

2. The dashboard

The dashboard is where you run the business day to day. The left rail is your navigation; the destinations you see depend on which verticals you have turned on. Most edit screens use a floating save bar: make your changes and a bar appears at the bottom to save or discard them, so you never lose work by clicking away.

Products and inventory

Build your catalog under Products. A product can have options (like size and color) that generate variants, each with its own price and stock. Group products into collections for your storefront navigation, and use facets to tag and filter them.

• Set prices per variant, and choose whether prices include tax under Settings.
• Track stock per location. New stores get a stock location seeded for you; set stock levels explicitly so quantities read back correctly.
• Use low-stock and stock-movement views to know what to reorder.

Orders and fulfillment

Every sale becomes an order you work through its lifecycle: accept payment, fulfill, ship, and if needed refund or cancel. Open an order to see the customer, the line items, payments and the full history, and to move it to its next state.

Customers and promotions

Customers accumulate under Customers with their order history. Promotions let you run discounts (percentage or fixed, whole-order or specific products) on a schedule, for example 20% off a collection for one weekend.

Marketplace and add-ons

The Marketplace is a catalog of extensions you install per store: payment providers, live chat, reviews, analytics pixels, a CMS and more. Some are free, some are paid add-ons, and some are whole verticals. Installing an add-on turns on its capability across the dashboard and storefront; you manage what is installed under Installed add-ons.

Credits and usage

AI features (including the Ask Harmon assistant) run on credits. You can see your credit balance, buy credit packs, and review usage from the dashboard. Credits are consumed as the assistant works; everything it does is metered so there are no surprises.

Settings and billing

Settings holds your store details, currency, tax and pricing basis, team members and access, and your billing. Invite team members and give them roles; a staff member sees and can do only what their role allows, and that same boundary applies everywhere, including the assistant and MCP.

3. The Storefront Studio

The Studio is the visual, no-code editor for your storefront. You start from a free template, then customize it live: everything you change shows immediately in a real preview, and nothing goes public until you publish.

1. Pick a template. Browse the free catalog (Aurora, Roast, Fresh, Monochrome, Boutique, Ledger and more) and open the one that fits your store. Your storefront is populated and ready in seconds.
2. Customize. Swap the copy, drop in your logo and brand colors, and rearrange sections in the live editor until it feels like yours.
3. Publish. Hit publish and your store goes live on your own address. Change anything later, as often as you like, at no extra cost.

The Studio edits your brand (logo, colors, fonts), your page sections and layout, and your storefront content. It sits on top of the same catalog you manage in the dashboard, so products, prices and stock always stay in sync; the Studio controls how they look, not what they are.

4. Ask Harmon (the AI assistant)

Ask Harmon is an AI assistant built into your dashboard. Open it from the floating button, tell it what you want in plain language, and it takes the action for you: creating products, adjusting stock, fulfilling orders, running a promotion, confirming bookings, or answering questions about how your store is doing.

What it can do

A few examples of what you can just ask:

• “Create a product called Aurora Tee in sizes S to XL at $28.”
• “Which products are low on stock, and reorder 50 of each.”
• “Fulfill order #1043 and email the customer a tracking link.”
• “Run 20% off the summer collection this weekend only.”
• “What sold best last month, and how does it compare to May?”

It acts as you, safely

• It runs with your exact permissions. It can only see and do what your seat can, and never reaches another merchant's data.
• Anything destructive or outward-facing (refunds, cancellations, emails to customers) asks you to confirm before it happens.
• Every action it takes is logged, so there is a clear record of what changed.
• You can hand it a file, like a spreadsheet, a product photo or a supplier list, and have it act on the contents.

5. Connecting the MCP server

Ask Harmon is powered by an open MCP (Model Context Protocol) server. You can connect that same server to the AI tools you already use, Claude, Claude Code, Cursor, or any MCP-compatible client, and give your own assistant the exact same secure tools, scoped to your business, across every vertical you run.

Connect a client

1. In your MCP client, add a custom connector (also called an MCP server) and paste the Harmon MCP endpoint below. There are no API keys to paste or rotate.
2. The client detects it needs to sign in and opens the Harmon consent screen in your browser. Sign in as your store and review what the client is asking for.
3. Click Approve. The client now lists and can use the tools your seat is allowed to use. You can revoke access at any time.

https://mcp.harmoncommerce.com/mcp

Authorization uses standard OAuth 2.1: your client registers itself and walks you through sign-in and a consent screen, so nothing sensitive is ever pasted into the client and you can revoke access whenever you want. For scripted or command-line agents that cannot open a browser, create a personal access token instead under Settings › Access tokens and present it to the server as a bearer token.

Scope and safety

• A connection is bound to your seat. It inherits your role and your store's capabilities, and can never do more than you can in the dashboard.
• The tools a client sees are filtered by your role and what you have installed; a staff seat, for example, never sees owner-only tools.
• Read-only stays read-only: things like buying credits, installing add-ons and changing billing remain dashboard-only. The MCP layer can read that state but not change it.
• Revoke a token, reset the seat's password, or change its role and the connection stops working within minutes.

6. Storefront shortcodes

Shortcodes let you drop live, interactive features into your storefront without writing code. A shortcode is a small tag, always starting with x-, that you place in your storefront content; when the page renders, Harmon swaps it for the real working component (a product grid, a gallery, a reviews section, a checkout form) wired to your store's live data. They are how the Studio's building blocks are expressed under the hood, and you can hand-write them wherever you author storefront HTML.

How to write one

A shortcode looks like an HTML tag. Simple ones are self-closing; ones that wrap content (x-section, x-if, x-animate, x-link, x-checkout) have an opening and closing tag. Tag names are lowercase and hyphenated. Attributes configure them: quoted or bare values, a bare name for an on/off flag, and comma-separated values for lists.

<!-- self-closing: a 4-up product grid from a collection -->
<x-products collection="summer" columns="4" show-rating />

<!-- wrapping: only show this to signed-in customers -->
<x-if authenticated>
  <x-button label="Reorder" href="/account/orders" />
</x-if>

<!-- comma-separated list of facets to filter by -->
<x-collection-filters facets="Brand, Colour, Size" show-counts />

Where they go

Shortcodes belong in the storefront's HTML/Code block, which is the power-user surface behind the Studio. You use them when authoring page-type templates (Product Detail, Collection, Checkout and so on), CMS page bodies, reusable snippets, and custom header or footer HTML.

Two rules keep pages safe. First, some shortcodes need a page context: a product tag like x-add-to-cart only works on a Product Detail template, and the editor stops you publishing it somewhere without that context. Second, some belong to a vertical or add-on (dealership, services, B2B); if that is not part of your plan the tag is hidden from you and simply renders nothing, so a page is never broken by one.

A tour of the toolkit

There are around ninety shortcodes. The most useful, grouped by what they do:

• Layout and content: x-section (a full-width band), x-animate (scroll reveal), x-if (conditional content), x-divider, x-button, x-media / x-image, x-video, x-icon, x-snippet (reuse a saved block), x-faqs.
• Merchandising: x-products (grid or carousel from a collection, search or hand-picked handles), x-collection-list, x-recently-viewed, x-search-box.
• Product page: x-title, x-price, x-gallery, x-variant-picker, x-add-to-cart, x-buy-now, x-buy-box, x-quantity, x-stock-badge, x-description, x-specs.
• Ratings and reviews: x-rating (a compact aggregate) and x-reviews (the full reviews section with the verified-buyer form). Reviews are always on, no add-on needed.
• Collection and search: x-product-list, x-collection-filters (alias x-filters), x-sort, x-advanced-filters, x-search-results.
• Cart and checkout: x-cart-line-items, x-cart-summary, x-checkout-form (all-in-one) or the composable x-checkout wrapper with x-checkout-contact / -shipping / -payment / -summary inside it.
• Account: x-account-overview, x-profile-form, x-address-book, x-order-detail.
• Business info and footer: x-var (alias x-info, prints a saved detail like phone or hours), x-social, x-copyright, x-logo.

Shortcodes for your vertical

Turn on a vertical or add-on and its shortcodes become available:

• Dealership: x-vehicles (the vehicle listing), plus the showroom and Vehicle Detail tags (x-vehicle-gallery, x-vehicle-price, x-vehicle-enquiry, x-vehicle-test-drive and more). Vehicles are kept separate from products, so never mix the two tag families.
• Services and bookings: x-services (the service listing) and x-service-booking (the booking widget), alongside x-service-title, x-service-price and x-service-meta.
• B2B: x-business-portal, x-account-invoices and x-organization-request for organization accounts and invoicing.

7. Getting more help

If something is not covered here, the fastest path is often Ask Harmon itself: open the assistant and describe what you are trying to do. For anything it cannot handle, the team is one message away.

• Reach the team by email for account, billing or anything the assistant cannot resolve.