Spoki MCP: autenticazione e URL

Impostazioni condivise per Spoki MCP: URL del server, come accedere, come creare un’API key e setup per altri client (mcp-remote, codice custom).

Cerchi Claude, ChatGPT, Cursor, VS Code o n8n? Parti da Inizia con Spoki MCP.

URL del server #

Usa questo indirizzo in ogni client. Copialo esattamente: senza spazi o caratteri extra alla fine:

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

Non usare host di staging né i vecchi path /mcp.

Due modi per collegarsi #

Ottieni la tua API key #

1. In Spoki, vai su app.spoki.it → Integrazioni → Spoki MCP → Request Api Key.
2. Copia la chiave.
3. Tienila privata. Chiunque abbia la chiave può usare il tuo account Spoki.

Hai finito quando… #

• Hai un’API key Spoki copiata in un posto sicuro (oppure usi solo il login Spoki e non ti serve una chiave).
• Sai quale modalità usa il tuo client (login vs API key).

Impostazioni generiche per client MCP #

n8n #

Per la checklist completa di n8n (AI Agent → MCP Client Tool → Header Auth), vedi Spoki MCP con n8n.

Client che richiedono mcp-remote #

Alcuni client avviano solo server MCP locali. Usa mcp-remote come bridge (serve Node.js). Includi sempre --transport e http-only, altrimenti il bridge ignora l’API key e apre una pagina di login.

{
  "mcpServers": {
    "spoki": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.spoki.com/v2/mcp",
        "--transport",
        "http-only",
        "--header",
        "X-Spoki-Api-Key: YOUR_API_KEY"
      ]
    }
  }
}

Per i server locali di Claude Desktop, incolla questa configurazione in claude_desktop_config.json (Settings → Developer → Edit Config), sostituisci YOUR_API_KEY, salva e riavvia Claude Desktop. La configurazione locale funziona solo a computer acceso. Per Claude su web, mobile o task programmati usa la guida Claude.

Testa la tua API key #

Sostituisci YOUR_API_KEY con la tua chiave:

curl -X POST https://mcp.spoki.com/v2/mcp \
  -H "X-Spoki-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Una chiave valida restituisce una risposta con "serverInfo". Una chiave non valida restituisce invalid_api_key.

Problemi comuni #

• invalid_api_key: Crea una nuova chiave in Spoki Integrazioni → Spoki MCP e incollala senza spazi.
• Pagina di login invece dei tool: Per mcp-remote, aggiungi --transport http-only. Per Claude/ChatGPT, usa il login Spoki, non un’API key.
• URL sbagliato o vecchio: Usa solo https://mcp.spoki.com/v2/mcp.

Serve aiuto? support@spoki.com.