Collega Cursor a Spoki con un’API key. Cursor parla direttamente con il server. Non serve mcp-remote.
URL del server:
https://mcp.spoki.com/v2/mcp
Ti serve una chiave? Autenticazione e URL. ← Inizia con Spoki MCP
Passaggi #
- Apri Cursor Settings → MCP e clicca Add new MCP server (Cursor apre
mcp.json). - Incolla la config qui sotto. Sostituisci
YOUR_API_KEYcon la tua chiave Spoki. - Salva il file.
- In Settings → MCP, verifica che spoki sia verde e mostri l’elenco dei tool.
- In una chat con i tool abilitati, chiedi: “Che tag ho in Spoki?”
{
"mcpServers": {
"spoki": {
"url": "https://mcp.spoki.com/v2/mcp",
"headers": {
"X-Spoki-Api-Key": "YOUR_API_KEY"
}
}
}
}
Suggerimento: tieni la chiave fuori dal file con la variabile d’ambiente SPOKI_API_KEY e valore header ${env:SPOKI_API_KEY}. Lo stesso URL e header funzionano per i Cursor Cloud Agents.
Hai finito quando… #
- spoki è verde in Cursor Settings → MCP e mostra i tool.
- Una chat risponde a una domanda semplice su Spoki.
Problemi comuni #
- Rosso / nessun tool: Controlla la chiave (senza spazi), salva mcp.json e riavvia il server MCP da Settings.
- URL sbagliato: Usa esattamente
https://mcp.spoki.com/v2/mcp. - Chiave in git: Usa
${env:SPOKI_API_KEY}e non fare mai commit di chiavi reali.
Serve aiuto? support@spoki.com.
