Risoluzione problemi con MCP

Errori di autenticazione

HTTP 401 Unauthorized

• Causa: AUTH_KEY o AUTH_SECRET non validi.
• Rimedio: Verifica le credenziali nella pagina di sicurezza dell'API.  Puoi fare un test diretto facendo una chiamata alle nosre REST API con l'AUTH_KEY e L'AUTH_SECRET inserito nella configurazione del client MCP.

AUTH_ERROR nella risposta del tuo Agent AI

• Causa: Intestazione Authorization mancante o errata nella configurazione del client MCP.
• Rimedio: Assicurati di aver indicato AUTH_KEY o AUTH_SECRET  nella configurazione del client

Il client MCP non si connette

• Verifica che l'URL del server sia corretto (http://mcp.smshosting.it/mcp )
• Assicurati che l'intestazione Authorization sia impostata correttamente nella configurazione del client
• Per le installazioni remote, verifica che il protocollo TLS sia configurato
• Controlla che il comando npx mcp-remote   funzioni e sia disponibile sul tuo agent AI (è richiesto Node.js 18 o superiore)

Sessione MCP scaduta

Le sessioni MCP possono scadere o bloccarsi dopo lunghi periodi di inattività, riavvii del server o interruzioni di rete. Se la sessione scade potresti avere questi problemi :

• Gli strumenti restituiscono errori o vanno in timeout
• L'agente AI non riconosce più gli strumenti disponibili
• Errori di connessione o messaggio "Session not found" (Sessione non trovata)

Rimedio: Riavvia il client MCP o l'agente per avviare una nuova sessione:

• Claude Code: Riavvia la sessione CLI
• Cursor: Riavvia il server MCP da Settings → MCP, oppure ricarica la finestra