Vai al contenuto principale
Gli esempi usano l’host ufficiale dell’app. L’accesso API di produzione è attualmente disabilitato. Configura l’host abilitato fornito con la chiave: consulta la disponibilità API.

​
Prerequisiti

Python 3.11 o successivo, un host MCP che supporti stdio e una chiave con scadenza, workspaces:read e gli scope delle risorse necessarie. Il pacchetto si distribuisce come sorgente da Emailx; non è pubblicato in un registry pubblico.

​
Installa l’adapter supportato

Tieni l’SDK MCP fuori dall’ambiente Python dell’app Flask. L’extra opzionale installa le proprie dipendenze SDK con versioni fissate.

​
Configura l’host

Crea il file della chiave con un gestore di segreti o un editor. Deve contenere solo la chiave, appartenere al tuo utente, essere un file normale senza symlink e avere permessi 0600. Puoi inserire il percorso nella configurazione, non la chiave.
È una configurazione stdio generica: adatta il contenitore al tuo host e sostituisci i percorsi assoluti. Usa una sola variabile tra EMAILX_API_KEY ed EMAILX_API_KEY_FILE. Non viene selezionato automaticamente alcun host o cliente. Serve HTTPS, salvo sviluppo loopback esplicito.

​
Verifica la connessione

Esegui emailx doctor --json e emailx auth status --json nell’ambiente configurato. Riavvia l’host MCP e chiedi l’elenco strumenti, i dati della connessione e i workspace. Confronta ambiente e account previsto prima di leggere le risorse. Se il processo non parte, controlla percorso eseguibile e installazione [mcp]. Con 401 verifica scadenza, host e ambiente della chiave. Con 403 controlla ruolo e scope; 404 può indicare un cliente non più accessibile. Leggi la guida al recupero.