Come collegare Nova Poshta a Meta Muse — via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Nova Poshta, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Nova Poshta + Meta Muse

Nova Poshta (Нова Пошта), il corriere ucraino per pacchi: traccia fino a 100 lettere di vettura alla volta, trova città e filiali o locker per pacchi, calcola prezzo e data di consegna ed elenca le tue spedizioni. Tracking e ricerche funzionano senza chiave API.

Prerequisiti

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

(none — public API)

Step 1 — Ottieni le credenziali

1. Il tracking, la ricerca di città e filiali e il calcolo di prezzo e data di consegna funzionano senza chiave: non c'è nulla da configurare.
2. Solo nova_poshta_list_shipments (le tue lettere di vettura) richiede una chiave. Nell'account business di Nova Poshta su new.novaposhta.ua apri Settings → Security, fai clic su Create key, accetta i termini dell'API e inserisci la chiave in NOVA_POSHTA_API_KEY. Una chiave è valida per un anno; con una chiave scaduta ogni chiamata fallisce, quindi rinnovala o svuota la variabile.
3. nova_poshta_track_parcels accetta fino a 100 numeri di lettera di vettura (TTN). Aggiungi il telefono del mittente o del destinatario per ottenere il record completo; senza, ottieni solo lo stato.
4. Per prezzo e data di consegna, individua la città con nova_poshta_search_settlements e passa il suo valore DeliveryCity (non Ref) a nova_poshta_get_delivery_price o nova_poshta_get_delivery_date, insieme a un tipo di servizio: Warehouse (filiale), Doors (indirizzo) o Postomat (locker per pacchi).

Le date sono nel formato DD.MM.YYYY, il peso è in kg e il valore dichiarato in UAH. Nova Poshta risponde HTTP 200 anche quando una chiamata fallisce, quindi l'assistente legge success e errors; per un numero di tracking sconosciuto la risposta è "Номер не знайдено" (numero non trovato). I testi sono in ucraino, e molti record contengono anche un DescriptionRu in russo.

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 Nova Poshta.

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

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
• Collega a Claude
• Collega a ChatGPT