Come collegare ShipStation a Gemini — via MCP

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

ShipStation + Gemini

Spedizioni multi-corriere con ShipStation: ordini (shipment nell'API v2), etichette, corrieri e i loro servizi, preventivi di tariffa, tracking, magazzini, prodotti, inventario, evasioni, batch, manifest e ritiri. ShipStation API v2 con un header API-Key; acquisto e annullamento delle etichette sono inclusi ma installati disattivati.

Prerequisiti

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

SHIPSTATION_API_KEY

Step 1 — Ottieni le credenziali

Il connettore usa la ShipStation API v2, quindi serve una chiave API V2. La vecchia chiave V1 con secret non funziona.

1. In ShipStation apri Settings → Account → API Settings. Il tuo piano deve includere l'accesso API.
2. Nella sezione V2 clicca Generate API Key e copia la chiave; viene mostrata una sola volta. È attiva una sola chiave V2 per volta: generarne una nuova revoca la vecchia, anche in qualunque altro strumento la usi.
3. Incollala in SHIPSTATION_API_KEY. Viene inviata nell'header API-Key. Funzionano anche le chiavi della ShipStation API (ex ShipEngine) da api-portal.shipstation.com; le chiavi che iniziano con TEST_ vanno sulla sandbox.
4. Chiama per primo shipstation_list_carriers: gli id dei corrieri (se-...) servono per tariffe e servizi. Poi shipstation_list_shipments con shipment_status=pending elenca cosa resta da spedire.

In v2 gli ordini sono shipment. Un ordine nella web app di ShipStation è uno shipment nell'API, e una spedizione nella web app è un'etichetta (label). L'ordine v1 12345678 è se-12345678, e il numero d'ordine è shipment_number. L'API v2 non ha un endpoint che elenca gli store; filtra invece per store_id.

Le etichette costano. I tool delle etichette (shipstation_create_label_from_shipment, shipstation_create_label_from_rate, shipstation_void_label) vengono installati disattivati. Gli account della piattaforma ShipStation non hanno sandbox, quindi un'etichetta acquistata viene addebitata sull'account del corriere. Attivali solo se l'AI deve comprare etichette. Preventivi di tariffa e validazione degli indirizzi non cambiano nulla.

Limite: 200 richieste al minuto per account; un 429 porta l'header Retry-After con i secondi da attendere.

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 ShipStation.

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
• Collega a Cursor
• Collega a Meta Muse