seomcp

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

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.

  1. Apri la configurazione

    Apri la palette dei comandi (Ctrl/Cmd+Shift+P) ed esegui MCP: Open User Configuration. Si apre il file mcp.json del tuo profilo.

  2. 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, non mcpServers.

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

  1. Apri la configurazione

    Apri (o crea) il file ~/.copilot/mcp-config.json.

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

  3. 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-domexception al 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 doctor senza chiavi.

Altri assistenti