Phorest mit Gemini verbinden — über MCP

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Phorest klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen — fertig. Kein Docker, kein git clone, kein lokaler Server.

Phorest + Gemini

Phorest, Software für Salons und Spas: Filialen, Personal und Dienstpläne, Leistungen und Kategorien, Kunden mit Leistungs- und Produkthistorie, Termine, freie Terminslots, Produkte und Bestand, Gutscheine und Bewertungen. Phorest Third Party API mit Basic Auth; Buchungen und das Anlegen von Kunden sind enthalten, werden aber deaktiviert installiert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

PHOREST_API_URL, PHOREST_BUSINESS_ID, PHOREST_USERNAME, PHOREST_PASSWORD

Schritt 1 — Zugangsdaten holen

Der Connector nutzt die Phorest Third Party API mit HTTP Basic Auth. Jeder Aufruf gilt für ein Unternehmen, die meisten zusätzlich für eine Filiale.

1. Phorest vergibt den API-Zugang auf Anfrage: Eröffne unter https://support.phorest.com ein Ticket „API access“ von einer E-Mail-Adresse, die in deinem Unternehmen hinterlegt ist, mit deiner Phorest-Kontonummer.
2. Phorest schickt einen Benutzernamen und ein Passwort. Behalte das Präfix global/ im Benutzernamen (zum Beispiel global/[email protected]) und trage beides in PHOREST_USERNAME und PHOREST_PASSWORD ein.
3. Trage die Business-ID, die mit den Zugangsdaten kommt, in PHOREST_BUSINESS_ID ein. Fehlt sie, frag bei [email protected] nach.
4. Setze PHOREST_API_URL auf https://api-gateway-eu.phorest.com für Europa oder https://api-gateway-us.phorest.com für die USA, Kanada und Australien. Ein US-Konto auf dem EU-Host antwortet mit 401.
5. Beginne mit phorest_list_branches für die branchId, die die anderen Tools als branch_id erwarten.

Gut zu wissen:

• Die API arbeitet auf den echten Salondaten. phorest_create_client, phorest_create_booking und phorest_cancel_appointments werden deaktiviert installiert; schalte sie nur ein, wenn du sie brauchst.
• Zeiträume für Termine und Dienstpläne sind auf einen Monat begrenzt (from_date und to_date als yyyy-MM-dd).
• Paginierung: page beginnt bei 0, size geht bis 200 (1000 bei Dienstplänen).
• Die API bietet keine Webhooks und keine Kartenzahlungen; Änderungen holst du über die Filter updated_from ab.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Phorest-Tools aufrufen.

Verfügbare Tools

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Verbinde mit Claude
• Verbinde mit ChatGPT
• Verbinde mit Cursor
• Verbinde mit Meta Muse