Come collegare Tamara a Claude via MCP

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

Tamara + Claude

Tamara buy now, pay later (Arabia Saudita, Emirati Arabi Uniti, Kuwait, Bahrein, Oman): consulta gli ordini per tuo numero d'ordine o id Tamara con stato e importi catturati, rimborsati e liquidati, verifica i tipi di pagamento e l'idoneità del cliente. Cattura e rimborso sono inclusi, ma disattivati all'installazione.

Prerequisiti

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

TAMARA_API_URL, TAMARA_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti servono un account merchant Tamara e il suo token API.

1. Accedi al Tamara Partners Portal e apri API Token Management, oppure usa il token API che Tamara ti ha inviato con l'account merchant. Sandbox e produzione hanno token diversi.
2. Incolla il token in TAMARA_API_TOKEN, senza "Bearer" né spazi. Viene inviato come Authorization: Bearer <token>. Il notification token e la chiave pubblica qui non servono.
3. Imposta TAMARA_API_URL su https://api.tamara.co per la produzione o su https://api-sandbox.tamara.co per la sandbox. Deve corrispondere al token.
4. Installa il connettore ed esegui tamara_list_payment_types: elenca i tipi di pagamento offerti dal tuo negozio e conferma il token.

Il tuo numero d'ordine o l'id di Tamara: order_reference_id è il tuo numero d'ordine inviato al checkout, per esempio il numero d'ordine del negozio; order_id è l'UUID emesso da Tamara. La maggior parte delle domande parte dal tuo numero d'ordine, con tamara_get_order_by_reference.

Cosa legge: un ordine per tuo numero d'ordine o per id ordine Tamara, con stato, tipo di pagamento e rate, cliente, indirizzi, articoli, totale, importi catturati, rimborsati, annullati e pagati, stato e data di liquidazione e le sue transazioni (catture, rimborsi e annullamenti); i tipi di pagamento disponibili in un paese (come PAY_BY_INSTALMENTS o PAY_NOW) con importo minimo e massimo dell'ordine e numero di rate supportate, eventualmente solo quelli idonei per un importo; prima del checkout, quali opzioni di pagamento può usare un cliente specifico per un importo, e se Tamara considera attualmente idoneo un cliente (per numero di telefono, e-mail o entrambi); e un webhook registrato con URL, eventi e header.

Stato dell'ordine: new, approved, authorised, poi partially_captured o fully_captured, e partially_refunded o fully_refunded; canceled, declined ed expired sono definitivi. paid_amount è quanto ha pagato finora il cliente; settlement_status e settlement_date indicano se Tamara ti ha già liquidato.

Disattivati all'installazione: tamara_capture_order (cattura un ordine autorizzato in tutto o in parte alla spedizione, così Tamara lo liquida) e tamara_refund_order (rimborsa un ordine catturato in tutto o in parte; il denaro torna al cliente e non si può riprendere). Entrambi muovono denaro, quindi un amministratore li attiva deliberatamente. Anche allora l'AI ti mostra ordine, importo e valuta e aspetta il tuo sì.

Importi e orari: gli importi sono oggetti con amount e currency; SAR e AED hanno 2 decimali, BHD, KWD e OMR 3. Gli orari sono UTC, ISO 8601.

Limiti: Tamara non ha un endpoint per elencare o cercare gli ordini, quindi l'AI li cerca per tuo numero d'ordine o per id Tamara.

Errori comuni: 401 significa token errato o token dell'altro ambiente (sandbox o produzione). 404 su un ordine significa che in questo ambiente non c'è nessun ordine con quel riferimento o id. 400 o 422 su una cattura o un rimborso indicano il campo rifiutato da Tamara, per esempio un importo superiore a quello catturabile. 403 significa che il token funziona ma non può usare questa API; chiedi a Tamara di abilitarla per il tuo account merchant.

Il connettore non crea sessioni di checkout, non autorizza né annulla ordini, non usa la claims API e non scarica report di liquidazione.

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 Claude

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.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Tamara, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Qual è lo stato del nostro ordine 100245 su Tamara, e Tamara ce l'ha già liquidato?"
• "Quanto dell'ordine 100245 è stato finora catturato, rimborsato e pagato dal cliente?"
• "Quali tipi di pagamento Tamara offre il nostro negozio in Arabia Saudita per un ordine da 1.200 SAR?"
• "Il cliente con il numero di telefono +966501234567 può pagare 800 SAR con Tamara?"
• "L'ordine 100245 è stato spedito: catturalo per intero. Prima mostrami ordine e importo."

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot