Come collegare Prom.ua a Gemini — via MCP

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

Prom.ua + Gemini

API venditore di Prom.ua per i negozi sul marketplace ucraino: ordini con dati di acquirente e consegna, cambi di stato degli ordini, prodotti e gruppi di prodotti, clienti e messaggi degli acquirenti. Bearer token dall'area venditore.

Prerequisiti

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

PROM_UA_API_TOKEN

Step 1 — Ottieni le credenziali

1. Nell'area venditore di Prom.ua apri Settings → API token management (Налаштування → Управління API-токенами) e crea un token.
2. Concedigli l'accesso alle sezioni che l'assistente deve usare (ordini, prodotti, clienti, messaggi) e incollalo in PROM_UA_API_TOKEN. Un token vede solo l'azienda per cui è stato creato; a un token errato o revocato l'API risponde con HTTP 401.
3. Inizia con prom_ua_list_orders (filtra per stato o date), poi usa prom_ua_get_order per acquirente, consegna e articoli. prom_ua_list_order_statuses mostra gli stati di questa azienda, inclusi quelli personalizzati.

prom_ua_set_order_status modifica ordini reali e l'acquirente vede la modifica, quindi l'assistente mostra gli ID degli ordini e il nuovo stato e attende il tuo sì; per annullare un ordine serve un cancellation_reason. Le date sono in UTC (2026-10-01T12:00:00). Gli elenchi partono dai più recenti e si paginano con limit più last_id: per la pagina successiva, passa come last_id l'ID più basso che hai ricevuto.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Prom.ua.

Tool disponibili

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collega a Claude
• Collega a ChatGPT