# Gelato Sync

> Gelato Sync is a print-on-demand connector for OpoShop stores. A merchant connects their own Gelato account, puts their artwork on a Gelato blank, sets a price and imports it as a product. When a buyer orders, Gelato Sync places the fulfillment order on that merchant’s Gelato account, Gelato prints and ships it from a facility in the buyer’s own country, and the tracking is pushed back into OpoShop automatically.

This app is built on the OpoShop platform. It is agent-friendly: the full
API is described in OpenAPI and wrapped by an MCP server so an LLM can drive it
directly.

## Machine interfaces
- API contract (OpenAPI): https://gelatosync.fly.dev/openapi.json
- API docs (Swagger): https://gelatosync.fly.dev/docs
- Fuller LLM context: https://gelatosync.fly.dev/llms-full.txt
- Release notes: https://gelatosync.fly.dev/api/release-notes
- MCP endpoint (hosted): https://gelatosync.fly.dev/mcp — add this URL to Claude or any LLM
  client to drive the app in natural language. Auth with your own OpoShop store
  token via Authorization: Bearer <token>.

## Auth
Get an access token via POST /api/auth/login, then send it as
`Authorization: Bearer <token>` on /api/* requests (and to the /mcp endpoint).