Come collegare Billbee a Meta Muse via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Billbee Order Management, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Billbee + Meta Muse

Fai lavorare la tua AI con Billbee: trova gli ordini di tutti i tuoi marketplace e shop per data o numero d'ordine del marketplace, cerca gli articoli per SKU o EAN con prezzo e giacenza, controlla lo storico ordini di un cliente ed elenca i tuoi corrieri. Solo lettura, con API key, email di accesso e password API.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

BILLBEE_API_KEY, BILLBEE_LOGIN_EMAIL, BILLBEE_API_PASSWORD

Step 1 — Ottieni le credenziali

1. Accedi a Billbee e apri Einstellungen (Settings) → Billbee API. Nelle impostazioni generali di quella pagina attiva l'accesso API e imposta una password API. È una password separata, solo per l'API, non quella con cui accedi.
2. Richiedi una API key a Billbee: usa il loro modulo di richiesta API oppure scrivi a [email protected] descrivendo in breve cosa vuoi collegare (qui: la tua AI che legge gli ordini tramite AnythingMCP). Billbee ti invia la chiave.
3. Inserisci la chiave in BILLBEE_API_KEY, l'indirizzo email con cui accedi a Billbee in BILLBEE_LOGIN_EMAIL e la password API del passo 1 in BILLBEE_API_PASSWORD.
4. Installa il connettore. Non c'è nessun passaggio Authorize with Provider: ogni chiamata invia la API key nell'header X-Billbee-Api-Key, più email e password API come HTTP Basic auth.
5. Comincia con billbee_list_shipping_providers: non richiede parametri ed elenca i corrieri configurati nel tuo account. Se risponde, tutti e tre i valori funzionano.

Tre valori, tutti obbligatori: Billbee rifiuta una chiamata che porta solo la API key, oppure solo email e password API. Sul connettore devono essere impostati tutti e tre.

Restare connessi: non ci sono token da rinnovare, il connettore invia i tre valori a ogni chiamata. Se cambi la password API in Billbee o ricevi una nuova API key, aggiorna BILLBEE_API_PASSWORD o BILLBEE_API_KEY nella pagina del connettore.

Solo lettura: tutti gli 8 strumenti leggono soltanto ordini, articoli, clienti e corrieri. Il connettore non può creare né modificare nulla in Billbee, quindi per un setup in sola lettura non c'è niente da disattivare. Puoi comunque disattivare singoli strumenti nella pagina del connettore, per esempio billbee_list_customers e billbee_get_customer_orders se l'AI non deve vedere i dati dei clienti.

Ordini: billbee_list_orders filtra per data dell'ordine (minOrderDate, maxOrderDate) e per ultima modifica (modifiedAtMin, modifiedAtMax), con date in ISO 8601 come 2026-01-01. billbee_get_order restituisce l'ordine completo con righe, indirizzi, dati di pagamento e di spedizione a partire dall'id Billbee. billbee_get_order_by_extref trova un ordine con il numero d'ordine del marketplace o dello shop, per esempio un numero d'ordine Amazon o eBay. Gli stati degli ordini tornano come numeri.

Articoli e clienti: billbee_get_product cerca un articolo per id Billbee, oppure per SKU o EAN se lookupBy vale sku o ean, e restituisce prezzi e giacenza. billbee_list_products si può limitare agli articoli creati dopo una data (minCreatedAt). billbee_list_customers non ha una ricerca, quindi per trovare un cliente per nome bisogna scorrere l'elenco pagina per pagina; con l'id del cliente, billbee_get_customer_orders elenca i suoi ordini.

Pagine e limiti di frequenza: gli strumenti di elenco restituiscono fino a 250 righe per pagina (pageSize), con Page, TotalPages e TotalRows nella risposta, e l'AI chiede la page successiva fino all'ultima. Billbee consente 2 richieste al secondo per API key e utente e oltre risponde 429: aspetta un attimo e riprova. Billbee fa pagare l'uso dell'API oltre una quota gratuita, quindi intervalli di date stretti e modifiedAtMin sono meglio che rileggere tutto ogni volta.

Errori comuni: se Billbee rifiuta le credenziali, controlla che tutte e tre le variabili siano impostate, che l'accesso API sia attivo in Einstellungen → Billbee API e che BILLBEE_API_PASSWORD contenga la password API e non quella di accesso. 429 significa che è stato superato il limite di 2 richieste al secondo.

Il connettore non crea né modifica ordini, non cambia gli stati degli ordini, non aggiorna le giacenze, non crea spedizioni o etichette e non crea fatture o altri documenti.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Muse

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Billbee.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Quali ordini sono arrivati negli ultimi 7 giorni e quali non sono ancora stati spediti?"
• "Trova l'ordine con il numero d'ordine del marketplace 302-1234567-1234567 e mostrami le righe, l'indirizzo di consegna e i dati di pagamento."
• "Quanti pezzi dello SKU ABC-123 abbiamo in magazzino e qual è il prezzo di vendita?"
• "Elenca tutti gli ordini del cliente Billbee 4567 con data e totale, dal più recente."

FAQ

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini