Introduzione a ServBay MCP Server

ServBay MCP Server è un server integrato in ServBay, basato sul Model Context Protocol (MCP). Grazie a questo server, strumenti AI compatibili con MCP come Claude, Cursor, VS Code, possono “vedere” e “operare” direttamente sul tuo ambiente di sviluppo locale ServBay—monitorare lo stato dei servizi, gestire siti e domini, amministrare database, rilasciare certificati, creare backup, accedere ai log e leggere i dati di sistema—senza dover continuamente passare dalla conversazione all’interfaccia di ServBay.

Qui scoprirai cosa è ServBay MCP Server e le sue funzionalità. Per dettagli sull’integrazione con AI o sulle best practice, consulta:

• Integrazione con AI Client (IDE Integration) — Come collegare rapidamente MCP a Claude Code / Cursor / VS Code e altri.
• Regole AI (AI Rule) — Linee guida per utilizzare ServBay MCP in modo corretto e sicuro con l’intelligenza artificiale.

Cos’è MCP

Il Model Context Protocol (MCP) è un protocollo aperto che consente alle applicazioni AI di collegarsi in modo standardizzato a strumenti esterni e fonti dati. ServBay incapsula le proprie funzionalità di gestione dell’ambiente in un MCP Server: ogni client AI compatibile con MCP può richiamare queste funzionalità tramite il protocollo.

Il MCP Server viene distribuito come processo locale (comunicazione stdio) insieme a ServBay, ed è attivato all’occorrenza dal client AI, senza necessità di installazione o configurazione separata.

Cosa può fare ServBay MCP

ServBay MCP Server espone le principali funzionalità di gestione offerte da ServBay:

• Ambiente e abbonamenti — Consulta le informazioni ambientali, lo stato dell’abbonamento/piano e avvia diagnosi.
• Informazioni e metriche di sistema — Visualizza dati in tempo reale su CPU, memoria, disco, rete, ecc. (vedi Informazioni e Metriche di Sistema).
• Gestione dei servizi — Elenca i servizi disponibili, controlla lo stato, avvia/arresta/riavvia PHP, Node.js, MySQL, MariaDB, PostgreSQL, Redis, Memcached, Mailpit, MinIO, Ollama e altri.
• Configurazione e log dei servizi — Leggi/scrivi configurazioni dei servizi e consulta i log.
• Siti e domini — Elenca, visualizza, crea, aggiorna ed elimina siti locali; abilita o disabilita i siti; gestisci record hosts e domini dnsmasq.
• Porte — Verifica l’occupazione delle porte.
• Certificati TLS/HTTPS — Elenca, genera, rinnova ed elimina certificati.
• Database — Elenca database, crea nuovi database, imposta o reimposta password del database.
• Pacchetti software — Elenca pacchetti installati/disponibili, installa/disinstalla/abilita/disabilita e cambia versione.
• Modelli Ollama — Elenca o rimuovi modelli Ollama locali.
• Backup — Elenca, crea, ripristina o elimina backup; gestisci i piani di backup.

Grazie a questi strumenti, potrai ad esempio chiedere all’AI: “Avvia PHP 8.3 e crea un nuovo sito”, “Genera un certificato per questo dominio”, oppure “Visualizza gli errori log di MySQL”: sarà l’AI, tramite MCP, ad interfacciarsi con ServBay e svolgere le operazioni richieste.

Note di sicurezza

• MCP Server opera esclusivamente in locale, comunicando tramite stdio con il client AI sul tuo computer.
• Per operazioni di scrittura o potenzialmente distruttive (come eliminare siti, reimpostare password del database, ripristinare backup), è consigliabile che l’AI mostri prima le modifiche che intende eseguire e chieda conferma prima di proseguire.
• Non incollare nelle conversazioni chiavi, token, DNS API Key, password di database o chiavi private—il design di ServBay MCP non richiede di fornire manualmente queste informazioni sensibili.
• Utilizza ServBay MCP insieme alle Regole AI per garantire un utilizzo conforme e sicuro da parte dell’AI.

Prerequisiti

• ServBay deve essere installato ed in esecuzione (macOS o Windows).
• È necessario disporre di un client AI compatibile MCP (ad esempio Claude Code, Cursor, VS Code + Copilot, Claude Desktop, Codex, ecc.).

Prossimi passi

• Vai su Integrazione con AI Client per collegare in pochi click ServBay MCP con i tuoi strumenti AI.
• Installa le Regole AI per guidare l’AI all’uso migliore e più sicuro delle funzionalità ServBay MCP.

Conclusione

ServBay MCP Server mette a disposizione degli strumenti AI tutte le capacità di gestione di ServBay, rendendo possibile l’amministrazione dell’ambiente di sviluppo locale tramite linguaggio naturale. Distribuito insieme a ServBay, facile da integrare e senza bisogno di deployment aggiuntivi, è l’elemento chiave che rende ServBay pronto per lo sviluppo AI-native.