Come collegare Phorest a Cursor — via MCP

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

Phorest + Cursor

Phorest, software per saloni e spa: sedi, staff e turni, servizi e categorie, clienti con storico di servizi e prodotti, appuntamenti, slot liberi, prodotti e magazzino, buoni regalo e recensioni. Phorest Third Party API con Basic auth; prenotazioni e creazione clienti sono incluse ma installate disattivate.

Prerequisiti

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

PHOREST_API_URL, PHOREST_BUSINESS_ID, PHOREST_USERNAME, PHOREST_PASSWORD

Step 1 — Ottieni le credenziali

Il connettore usa la Phorest Third Party API con HTTP Basic auth. Ogni chiamata riguarda un'attività e la maggior parte anche una sede.

1. Phorest concede l'accesso API su richiesta: apri un ticket "API access" su https://support.phorest.com da un indirizzo e-mail registrato sulla tua attività, indicando il numero di account Phorest.
2. Phorest invia username e password. Mantieni il prefisso global/ dello username (ad esempio global/[email protected]) e inseriscili in PHOREST_USERNAME e PHOREST_PASSWORD.
3. Inserisci in PHOREST_BUSINESS_ID il business id che arriva con le credenziali. Se manca, chiedilo a [email protected].
4. Imposta PHOREST_API_URL su https://api-gateway-eu.phorest.com per l'Europa o https://api-gateway-us.phorest.com per Stati Uniti, Canada e Australia. Un account US sull'host EU risponde 401.
5. Parti da phorest_list_branches per il branchId che gli altri tool vogliono come branch_id.

Da sapere:

• L'API lavora sui dati reali del salone. phorest_create_client, phorest_create_booking e phorest_cancel_appointments sono installati disattivati; attivali solo se ti servono.
• Gli intervalli di date per appuntamenti e turni dello staff sono limitati a un mese (from_date e to_date in formato yyyy-MM-dd).
• Paginazione: page parte da 0, size arriva a 200 (1000 per i turni dello staff).
• L'API non offre webhook né pagamenti con carta; usa i filtri updated_from per recuperare le modifiche.

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

Tool disponibili

FAQ

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

Prossimi passi

• Landing del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Gemini
• Collega a Meta Muse