Spoki MCP con VS Code e GitHub Copilot

Collega Spoki a VS Code e GitHub Copilot Chat (modalità Agent). Preferisci il login Spoki quando VS Code offre Auth; usa un’API key solo se il login non è disponibile.

URL del server:

https://mcp.spoki.com/v2/mcp

← Inizia con Spoki MCP · Autenticazione e URL

Opzione A: Login Spoki (consigliata) #

1. Installa VS Code 1.99+ e GitHub Copilot Chat. Accedi a Copilot. Su Business/Enterprise, chiedi a un admin di abilitare MCP servers in Copilot.
2. Esegui MCP: Open User Configuration dalla Command Palette (Ctrl+Shift+P / Cmd+Shift+P), oppure crea .vscode/mcp.json.
3. Aggiungi il blocco server qui sotto. Sostituisci YOUR_SPOKI_OAUTH_CLIENT_ID con il client ID VS Code da Spoki (Integrazioni / supporto). Non mettere secret nel file.
4. Salva. Usa Auth / Start sopra il server quando VS Code lo mostra.
5. Completa il login Spoki nel browser, scegli l’account, clicca Allow.
6. Apri Copilot Chat → Agent, verifica i tool Spoki, poi chiedi: “Che tag ho in Spoki?”

{
  "servers": {
    "spoki": {
      "type": "http",
      "url": "https://mcp.spoki.com/v2/mcp",
      "oauth": {
        "clientId": "YOUR_SPOKI_OAUTH_CLIENT_ID"
      }
    }
  }
}

Se Auth fallisce con un errore di registration o redirect, chiedi a support@spoki.com un client VS Code, oppure usa l’Opzione B.

Opzione B: API key #

1. Crea una chiave in Spoki: Integrazioni → Spoki MCP → Request Api Key.
2. Incolla questa config in mcp.json, salva, avvia spoki e inserisci la chiave quando richiesta (VS Code la memorizza; non fare commit delle chiavi).
3. In Copilot Chat modalità Agent, verifica i tool, poi chiedi: “Che tag ho in Spoki?”

{
  "inputs": [
    {
      "type": "promptString",
      "id": "spoki-api-key",
      "description": "Spoki MCP API key",
      "password": true
    }
  ],
  "servers": {
    "spoki": {
      "type": "http",
      "url": "https://mcp.spoki.com/v2/mcp",
      "headers": {
        "X-Spoki-Api-Key": "${input:spoki-api-key}"
      }
    }
  }
}

Hai finito quando… #

• I tool Spoki compaiono in Copilot Chat modalità Agent.
• Una nuova chat Agent risponde a una domanda semplice su Spoki.

Problemi comuni #

• Tool mancanti: Completa Allow (o inserisci una chiave valida), riavvia Start, apri una nuova chat Agent.
• L’organizzazione blocca MCP: Gli admin Copilot Business/Enterprise devono abilitare MCP servers in Copilot.
• Account sbagliato o URL errato: Cancella auth e accedi di nuovo; usa sempre https://mcp.spoki.com/v2/mcp.

Serve aiuto? support@spoki.com.