Vai all’articolo

Risoluzione dei problemi di connessione

minddy MCP collega un assistente esterno a minddy; il MCP personale permette a Numo di chiamare un server esterno.

Recuperare errori OAuth, MCP, webhook o Git

minddy MCP collega un assistente esterno a minddy; il MCP personale permette a Numo di chiamare un server esterno. Usano schede e credenziali distinte. Controlla lo stato nelle impostazioni, prova la connessione e riconnettila quando necessario. Sono disponibili discovery, registrazione dinamica, PKCE e refresh, ma una voce di catalogo non supera i requisiti di approvazione, anteprima o registrazione dell’app del provider. Controlla i prerequisiti attuali del provider prima di segnalare un difetto.

Riconnettere con i permessi corretti

Se il provider richiede un’app client già registrata, inserisci esattamente il callback mostrato. Sul desktop OAuth apre il browser di sistema e poi torna all’app. Per i server MCP personali usati da Numo serve HTTPS pubblico: comandi locali e reti private non sono ammessi. Per un assistente esterno collegato al MCP di minddy, consulta l’accesso di rete alla tua istanza. Inserisci bearer token e segreti nei campi di autenticazione o negli header, non nell’URL. Cambiare l’URL cancella credenziali e header. Disattivare o rimuovere una connessione impedisce nuovi invii, ma quelli già partiti possono terminare. Le routine usano il proprietario corrente e non ereditano il precedente accesso personale.

Controllare prima di ripetere

Le chiamate di Numo ai server MCP personali hanno un timeout di 30 secondi, un limite di trasporto di 1 MiB e un risultato massimo di 64 KB. Un timeout non prova che una modifica sia fallita: controlla la destinazione. Per API 401, verifica istanza, tipo di chiave e revoca senza mostrarla; il tipo errato restituisce 403. Per i webhook controlla stato corrente, raggiungibilità, HMAC sui byte originali e delivery_id. Gli eventi scartati non hanno una coda duratura di nuovi tentativi. Conserva codici e tempi senza contenuti privati o credenziali.

Verificare permessi e sincronizzazione

Le integrazioni Git si rivolgono a github.com e gitlab.com. Verifica repository, installazione e canale di connessione. La sincronizzazione GitHub richiede Issues in lettura e scrittura e gli eventi Issues, Issue comments e Issue dependencies; le installazioni esistenti devono accettare i nuovi permessi. I payload vecchi non sovrascrivono le modifiche recenti e gli identificatori remoti evitano duplicati. Le URL degli allegati rimangono sul forge: i byte non vengono copiati automaticamente. Controlla gli stati prima di riprovare o riconnettere e condividi solo diagnostica depurata.

Articoli correlati