Chit Chats MCP con Gemini CLI

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

Chit Chats + Gemini

Fai gestire alla tua AI le spedizioni Chit Chats: crea spedizioni, confronta le tariffe di affrancatura, stampa le etichette, raggruppa i pacchi in batch per la consegna, segui le consegne e vedi i resi. L'acquisto dell'affrancatura e i rimborsi restano disattivati finché non li consenti.

Prerequisiti

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

CHIT_CHATS_ACCESS_TOKEN, CHIT_CHATS_CLIENT_ID

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Chit Chats: un API access token dalle impostazioni e il client ID dall'indirizzo della tua dashboard.

1. Accedi a chitchats.com e apri Settings, Account (chitchats.com/settings/account). Crea un API access token e copialo in CHIT_CHATS_ACCESS_TOKEN. Incolla solo il token: viene inviato così com'è come header Authorization, senza il prefisso Bearer.
2. Copia il tuo client ID in CHIT_CHATS_CLIENT_ID. È il numero nell'indirizzo della tua dashboard Chit Chats, https://chitchats.com/clients/<client id>/..., ad esempio 999999.
3. Installa il connettore e verifica la connessione con chit_chats_list_shipments.

Cloud e self-hosting funzionano allo stesso modo: in entrambi i casi il connettore chiama chitchats.com con il tuo token e non c'è altro da configurare. Se elimini il token in Chit Chats, l'accesso è revocato subito.

Nulla viene addebitato finché non compri l'affrancatura: chit_chats_create_shipment con postage_type impostato su unknown crea una spedizione senza affrancatura, e chit_chats_get_shipment mostra poi le tariffe disponibili con i prezzi. chit_chats_refresh_shipment aggiorna le tariffe scadute o cambia assicurazione, firma e data di spedizione. Creare spedizioni, aggiornare le tariffe e formare batch non costa nulla. Le destinazioni fuori da Canada e Stati Uniti richiedono le righe doganali (line items).

L'acquisto dell'affrancatura avviene in background: dopo chit_chats_buy_postage lo stato della spedizione è prima postage_requested; rileggila finché non diventa ready o postage_purchase_failed. Una spedizione pronta contiene l'etichetta come link PNG e ZPL (postage_label_png_url, postage_label_zpl_url): il connettore restituisce link, non file.

Batch per la consegna: un batch raggruppa i pacchi che consegni insieme e ha una sua etichetta. Crealo con chit_chats_create_batch, aggiungi le spedizioni con chit_chats_add_shipments_to_batch (o toglile con chit_chats_remove_shipments_from_batch) e stampa l'etichetta del batch da chit_chats_get_batch.

Id, importi e paginazione: l'id di una spedizione è di 10 lettere e cifre (8ERNJ8SCQ9); l'id di un batch è un numero. Gli importi sono stringhe decimali nella valuta dell'account e le date sono nel formato YYYY-MM-DD. I tool di elenco accettano limit (predefinito 100, al massimo 1000) e page; una pagina più corta di limit è l'ultima.

Limite di richieste: Chit Chats consente 2000 richieste ogni 5 minuti per indirizzo IP e account e oltre risponde 429. Aspetta i secondi indicati nell'header Retry-After e riprova.

Errori frequenti: 401 vuol dire che Chit Chats ha rifiutato l'access token: creane uno nuovo in Settings, Account e incollalo senza la parola Bearer. 403 vuol dire che il token non appartiene a questo client ID: controlla il numero nell'indirizzo della dashboard. 404 vuol dire che non esiste un client, una spedizione o un batch con quell'id: controlla CHIT_CHATS_CLIENT_ID e prendi gli id delle spedizioni da chit_chats_list_shipments.

Solo l'account reale: la sandbox di staging di Chit Chats (staging.chitchats.com) richiede un account separato e questo connettore non la usa. Saldo dell'account, fatture e prenotazione dei ritiri non fanno parte dell'API pubblica.

Cosa legge: spedizioni con stato, indirizzo del destinatario, contenuto, valore dichiarato, dimensioni e peso del pacco, tipo di affrancatura, corriere e relativo codice di tracking, data di spedizione, importi addebitati, link delle etichette, tariffe disponibili con i prezzi ed eventi di tracking; il numero di spedizioni e di batch; i batch con stato ed etichetta per la consegna; i resi che tornano a te, con stato ed esito; e il tracking pubblico di qualsiasi spedizione Chit Chats recente, con consegna prevista e ogni evento con ora e luogo.

Disattivati all'installazione: chit_chats_buy_postage, chit_chats_refund_shipment, chit_chats_delete_shipment e chit_chats_delete_batch. L'acquisto dell'affrancatura addebita il saldo del tuo account Chit Chats; un rimborso annulla la spedizione, che non può più essere spedita; l'eliminazione cancella definitivamente una spedizione in attesa (ancora senza affrancatura) o un batch vuoto. Attiva nella pagina del connettore solo quelli che ti servono; l'AI ti chiede conferma prima di ogni modifica e, prima di ogni acquisto, anche di spedizione, tariffa e prezzo. Creare e aggiornare spedizioni, creare batch e spostarvi dentro o fuori le spedizioni è attivo: non costa nulla.

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 Chit Chats.

Tool disponibili

Esempi di prompt

• "Quali spedizioni sono ancora in attesa senza affrancatura e quali sono pronte da consegnare?"
• "Crea una spedizione per l'ordine 1042 all'indirizzo qui sotto e confronta le tariffe prima di comprare qualsiasi cosa."
• "Metti tutte le spedizioni pronte in un nuovo batch e dammi l'etichetta del batch da stampare."
• "Dov'è adesso la spedizione 8ERNJ8SCQ9 e quando dovrebbe arrivare?"
• "Mostrami i resi in sospeso per cui devo ancora scegliere come farli tornare."

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
• Collegare a Claude