Aggiungere server MCP e Skills

Aggiungi un server MCP quando un Agent ha bisogno di strumenti aggiuntivi o collegamenti a servizi. Aggiungi una Skill quando vuoi riutilizzare istruzioni e risorse per un tipo di lavoro. Noea gestisce centralmente queste estensioni per le chat normali dei vari Agent.

Le estensioni sono facoltative: non servono per iniziare. Le attività di spiegazione e organizzazione non usano le estensioni aggiunte qui.

Scegli l’estensione necessaria

La disponibilità di un server dipende anche dal supporto dell’Agent per il suo metodo di connessione. Per i comandi delle Skill, usa l’elenco effettivamente mostrato nella chat.

Aggiungi un server MCP

Apri Impostazioni → Server MCP (Settings → MCP Servers), aggiungi un server, inserisci un nome e scegli il metodo di connessione.

• stdio: avvia un servizio localmente. Inserisci comando, argomenti e variabili d’ambiente richieste, con un argomento per riga.
• HTTP: collegati a un servizio tramite URL. Inserisci l’indirizzo del server e le intestazioni richieste.

Se il servizio fornisce una configurazione JSON compatibile, usa Incolla JSON (Paste JSON) per compilare il modulo. Controlla comando, indirizzo e campi di autenticazione prima di salvare.

I nomi devono essere univoci, senza distinzione tra maiuscole e minuscole. I nomi che iniziano con noea sono riservati. La prima riga è il server integrato di Noea, sempre abilitato e non eliminabile.

Verifica la connessione

Verifica connessione (Test Connection) nel pannello di modifica usa i valori attuali del modulo. La verifica dall’elenco usa la configurazione salvata.

Una verifica riuscita mostra i nomi degli strumenti e il loro numero. Un errore identifica la fase, come comando mancante, uscita del processo, timeout, richiesta rifiutata o handshake fallito. Se un servizio HTTP richiede autorizzazione, segui il flusso dell’Agent selezionato.

Una verifica riuscita significa che la configurazione può connettersi. Non garantisce il supporto di ogni Agent e non abilita automaticamente il server per una chat.

Abilita un server per una chat

L’impostazione predefinita per le nuove chat nell’elenco dei server determina la selezione iniziale. Puoi anche scegliere i server MCP di una singola chat nel suo menu di configurazione.

La scelta viene salvata con la chat. Un Agent connesso non ricarica subito le impostazioni modificate; diventano effettive alla connessione successiva. Per usare una nuova configurazione, avvia una nuova chat e verifica la selezione dei server.

Il menu spiega perché un server non è disponibile, per esempio una variabile d’ambiente mancante o un metodo di connessione non supportato.

Usa le variabili d’ambiente

I valori delle variabili d’ambiente e delle intestazioni supportano riferimenti ${VAR} a variabili nell’ambiente di esecuzione di Noea. I valori vengono letti alla connessione. Verifica la connessione dopo la configurazione. Eseguire export in un terminale non garantisce che un processo Noea già in esecuzione abbia quel valore.

I campi nascondono i valori per impostazione predefinita e possono mostrarli al clic. Nascondere un valore impedisce solo di visualizzarlo; non cambia come la configurazione viene salvata o usata.

Aggiungi una Skill

Apri Impostazioni → Skills (Settings → Skills), scegli l’azione di aggiunta e seleziona una cartella contenente SKILL.md. L’app spiega eventuali problemi di formato.

La Skill viene aggiunta alla libreria di Noea. Aggiunte e rimozioni valgono nelle nuove chat. Puoi mostrarne la posizione nel gestore file. Eliminarla rimuove la copia della libreria, non la cartella originale selezionata.

La stessa pagina mostra le Skills di utente e di progetto rilevate nelle cartelle degli Agent, in sola lettura. Visualizzane le posizioni o scegli Copia in Noea (Copy to Noea). Questo elenco non include tutte le Skills integrate negli Agent o fornite dai loro plugin.

Usa le estensioni in una chat

Avvia una nuova chat e digita / all’inizio del campo di input per sfogliare le Skills di Noea e i comandi dell’Agent. Seleziona una voce disponibile, aggiungi i requisiti dell’attività attuale e invia.

Se manca un’estensione, verifica di aver avviato una nuova chat e che l’Agent la supporti, poi consulta Risoluzione dei problemi.