GitHub
seomcp in GitHub Copilot
Istruzioni per GitHub Copilot in VS Code e GitHub Copilot CLI. Ci vogliono due minuti, credenziali a parte.
Prima di iniziare
- Node.js 22 o superiore (scarica).
- Le credenziali delle fonti che vuoi usare: Search Console, Google Analytics 4, Core Web Vitals e Bing Webmaster Tools, con i link diretti nella pagina Credenziali. Sono tutte facoltative: GEO, schema.org e controlli tecnici funzionano senza.
La via più rapida è la configurazione guidata: fa le domande una alla volta, prova le credenziali e scrive la configurazione dell'assistente al posto tuo.
npx -y @contentisking/seomcp setup
seomcp è pubblicato su npm come @contentisking/seomcp: npx lo scarica al primo avvio e lo tiene aggiornato.
GitHub Copilot in VS Code
In VS Code i server MCP sono disponibili nella chat di GitHub Copilot, in modalità Agent.
-
Apri la configurazione
Apri la palette dei comandi (Ctrl/Cmd+Shift+P) ed esegui MCP: Open User Configuration. Si apre il file
mcp.jsondel tuo profilo. -
Aggiungi seomcp
{ "servers": { "seomcp": { "type": "stdio", "command": "npx", "args": ["-y", "@contentisking/seomcp"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "/percorso/service-account.json", "BING_WEBMASTER_API_KEY": "la-tua-chiave", "SEOMCP_GSC_SITE": "sc-domain:tuosito.it", "SEOMCP_GA_PROPERTY": "123456789", "SEOMCP_GOOGLE_API_KEY": "la-tua-api-key" } } } }Sostituisci percorso, chiave, sito e proprietà con i tuoi. Togli le variabili delle fonti che non usi.
Attenzione: in VS Code la chiave principale è
servers, nonmcpServers. -
Verifica
Esegui MCP: List Servers dalla palette e avvia
seomcp. Poi apri la chat di Copilot in modalità Agent: i tool compaiono nell'elenco degli strumenti.
GitHub Copilot CLI
Copilot CLI legge i server MCP dal proprio file di configurazione nella tua cartella utente.
-
Apri la configurazione
Apri (o crea) il file
~/.copilot/mcp-config.json. -
Aggiungi seomcp
{ "mcpServers": { "seomcp": { "type": "local", "command": "npx", "args": ["-y", "@contentisking/seomcp"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "/percorso/service-account.json", "BING_WEBMASTER_API_KEY": "la-tua-chiave", "SEOMCP_GSC_SITE": "sc-domain:tuosito.it", "SEOMCP_GA_PROPERTY": "123456789", "SEOMCP_GOOGLE_API_KEY": "la-tua-api-key" }, "tools": ["*"] } } }Sostituisci percorso, chiave, sito e proprietà con i tuoi. Togli le variabili delle fonti che non usi.
"type": "local"indica un server avviato sul tuo computer."tools": ["*"]abilita tutti i tool. -
Verifica
Riavvia Copilot CLI: i tool di seomcp saranno disponibili nella sessione.
Prova con una domanda
- Quali query sono in posizione 4-20 negli ultimi 90 giorni?
- Confronta questo mese con lo stesso periodo dell'anno scorso.
Se qualcosa non va
Questo comando controlla la configurazione e prova ogni fonte, dicendoti esattamente cosa manca:
npx -y @contentisking/seomcp doctor
- Le variabili d'ambiente vanno impostate nella configurazione dell'assistente, non nel terminale: è l'assistente ad avviare seomcp.
- L'avviso
npm warn deprecated node-domexceptional primo avvio si può ignorare: arriva dalla libreria ufficiale di Google per l'autenticazione e non serve con Node 22. Sparirà quando Google aggiornerà le sue dipendenze. - Ancora bloccato? Apri una segnalazione, allegando l'output di
doctorsenza chiavi.