Cómo conectar Phorest a Gemini — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Phorest, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Phorest + Gemini

Phorest, software para salones y spas: sucursales, personal y horarios, servicios y categorías, clientes con historial de servicios y productos, citas, huecos libres, productos y stock, vales regalo y reseñas. Phorest Third Party API con autenticación Basic; las reservas y la creación de clientes están incluidas pero se instalan desactivadas.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PHOREST_API_URL, PHOREST_BUSINESS_ID, PHOREST_USERNAME, PHOREST_PASSWORD

Paso 1 — Obtener credenciales

El conector usa la Phorest Third Party API con autenticación HTTP Basic. Cada llamada se limita a un negocio y la mayoría también a una sucursal.

1. Phorest concede el acceso a la API bajo petición: abre un ticket "API access" en https://support.phorest.com desde un correo registrado en tu negocio, con tu número de cuenta de Phorest.
2. Phorest envía un usuario y una contraseña. Conserva el prefijo global/ del usuario (por ejemplo global/[email protected]) y ponlos en PHOREST_USERNAME y PHOREST_PASSWORD.
3. Pon en PHOREST_BUSINESS_ID el business id que llega con las credenciales. Si falta, pídelo a [email protected].
4. Pon en PHOREST_API_URL https://api-gateway-eu.phorest.com para Europa o https://api-gateway-us.phorest.com para Estados Unidos, Canadá y Australia. Una cuenta de EE. UU. en el host de la UE responde 401.
5. Empieza con phorest_list_branches para obtener el branchId que las demás herramientas piden como branch_id.

Conviene saber:

• La API trabaja sobre los datos reales del salón. phorest_create_client, phorest_create_booking y phorest_cancel_appointments se instalan desactivadas; actívalas solo si las necesitas.
• Los rangos de fechas de citas y horarios del personal están limitados a un mes (from_date y to_date como yyyy-MM-dd).
• Paginación: page empieza en 0 y size llega hasta 200 (1000 para horarios del personal).
• La API no ofrece webhooks ni pagos con tarjeta; usa los filtros updated_from para recoger cambios.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Phorest.

Herramientas disponibles

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse