Collegare Re:amaze MCP a Cursor

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

Re:amaze + Cursor

L'helpdesk Re:amaze da qualsiasi agente AI: leggi e rispondi alle conversazioni da email, chat e canali social, pubblica risposte e note interne, gestisci i contatti e le loro note, articoli FAQ, canali, staff, modelli di risposta, valutazioni di soddisfazione e report del supporto.

Prerequisiti

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

REAMAZE_BRAND, REAMAZE_LOGIN_EMAIL, REAMAZE_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un account Re:amaze con un utente dello staff, di cui il connettore usa il token API, e il nome host del brand.

1. In Re:amaze apri Settings, Developer, API Token e clicca Generate New Token. Copia il token in REAMAZE_API_TOKEN. Ogni utente dello staff ha il proprio token e il connettore agisce come quell'utente.
2. Imposta REAMAZE_LOGIN_EMAIL sull'indirizzo email con cui proprio quell'utente accede a Re:amaze. Un token funziona solo insieme all'email dell'utente che l'ha generato.
3. Imposta REAMAZE_BRAND sul nome host del brand: la parte prima di .reamaze.io nell'indirizzo del brand, visibile in Settings, Brand Settings. Per mybrand.reamaze.io è mybrand: solo il nome, fatto di lettere, cifre e trattini, senza https:// né .reamaze.io.
4. Installa il connettore. Verifica la connessione con reamaze_list_channels: elenca i canali del brand con i loro slug, che gli altri tool usano come category.

Cloud e self-hosting funzionano allo stesso modo: il connettore si autentica in HTTP Basic su HTTPS, con l'email di login come nome utente e il token API come password. Non servono Redirect URL né liste di IP consentiti.

Un brand per connettore: le chiamate vanno a https://<brand>.reamaze.io/api/v1. Conversazioni, messaggi, canali, articoli FAQ e modelli di risposta sono quelli di quel brand; contatti e staff appartengono all'intero account. Report e valutazioni di soddisfazione coprono tutti i brand dell'account, a meno che tu non ne indichi uno. Per la casella di un altro brand configura un secondo connettore con il suo nome host.

Il connettore agisce come l'utente del token: ciò che quell'utente può vedere e fare in Re:amaze è ciò che può vedere e fare l'AI. Risposte e note partono a suo nome, se non viene indicato un altro mittente. Report e valutazioni di soddisfazione richiedono il permesso access_reports per quell'utente.

Le risposte partono subito: reamaze_create_message con visibility 0 invia subito una risposta al cliente sul canale della conversazione (email, chat, SMS e così via), quindi l'AI ti mostra il testo e aspetta il tuo sì. Con visibility 1 aggiunge una nota interna visibile solo allo staff. Dopo una risposta dello staff Re:amaze segna la conversazione come Done, a meno che l'AI non passi suppress_autoresolve; allo stesso modo si possono evitare sondaggi di soddisfazione e notifiche. Una nuova conversazione creata con reamaze_create_conversation invia le notifiche abituali, a meno che non sia impostato suppress_notifications.

Alcune modifiche sostituiscono: tag_list in reamaze_update_conversation sostituisce tutti i tag della conversazione, un nuovo testo dell'articolo sostituisce il precedente e user_data in reamaze_create_conversation sostituisce gli attributi esistenti del cliente.

Id e codici: una conversazione si identifica con il suo slug (ad esempio knock-knock-a1b2c3), un canale con il suo slug (ad esempio support); un contatto con l'indirizzo email, oppure con il numero di cellulare in formato E.164 (+12223334444) e il tipo di identificativo mobile; gli articoli con lo slug, i modelli di risposta con l'id numerico. Stato della conversazione: 0 Open, 1 Responded, 2 Done, 3 Spam, 4 Archived, 5 On Hold, 6 Auto-Done, 7 AI Agent Assigned, 8 AI Agent Done, 9 Spam (AI).

Date, paginazione e limiti: i filtri delle liste accettano date e ore ISO 8601; i report accettano due giorni in formato YYYY-MM-DD, di default gli ultimi 30 giorni, al massimo a un anno di distanza. Le liste restituiscono 30 elementi per pagina; l'AI chiede la successiva con page. L'API limita le richieste per token al minuto e oltre il limite risponde 429: attendi e riprova.

Errori frequenti: 401 vuol dire che email o token sono sbagliati, spesso perché l'email non è quella dell'utente che ha generato il token. 403 vuol dire che il token funziona ma al suo utente manca un permesso (report e valutazioni richiedono access_reports). 404 vuol dire slug sconosciuto o nome host del brand sbagliato. 422 vuol dire che Re:amaze ha rifiutato una creazione o una modifica, ad esempio un contatto che esiste già; la risposta spiega il motivo.

Cosa legge: conversazioni con oggetto, stato, tag, assegnatario, canale, campi personalizzati e follower, e ogni messaggio di un thread, risposte e note interne, con mittente, destinatari e allegati; messaggi di tutte le conversazioni per mittente, canale, tag o data; contatti con le loro identità (email, cellulare, account social) e note; articoli FAQ pubblicati, in bozza o interni; canali e relative impostazioni; utenti dello staff e ruoli; modelli di risposta; valutazioni di soddisfazione con commenti; e report su volumi, tempi di risposta, staff, tag e canali.

I tool di scrittura sono attivi dall'installazione: nessun tool è disattivato. L'AI può rispondere ai clienti e aggiungere note interne (reamaze_create_message), aprire conversazioni (reamaze_create_conversation), cambiarne stato, tag, assegnatario o canale (reamaze_update_conversation), creare e aggiornare contatti e aggiungere note ai contatti (reamaze_create_contact, reamaze_update_contact, reamaze_add_contact_note) e creare o modificare articoli FAQ (reamaze_create_article, reamaze_update_article). Disattiva nella pagina del connettore quelli che non vuoi far usare all'AI.

Non incluso: eliminare o modificare le note dei contatti, modificare le identità dei contatti, creare utenti dello staff, la Status Page API e le modifiche ai modelli di risposta. Nessun tool elimina qualcosa.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Re:amaze.

Tool disponibili

Esempi di prompt

• "Quali conversazioni aperte non sono assegnate a nessuno, e cosa chiede ogni cliente?"
• "Mostrami l'ultimo thread con [email protected] e proponi una risposta basata sui nostri articoli FAQ; inviala solo dopo la mia approvazione."
• "Aggiungi alla conversazione sulla consegna in ritardo una nota interna che dice che abbiamo contattato il corriere, e mettila in attesa fino a lunedì."
• "Come sono andati i nostri tempi di risposta negli ultimi 30 giorni, e chi del team ha inviato più risposte?"
• "Elenca le valutazioni di soddisfazione da 1 o 2 stelle del mese scorso con i loro commenti."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude