> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurare MCP locale

> Esegui l’adapter stdio in un ambiente Python separato.

> [!NOTE]
>
> 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](https://docs.emailx.ai/it/api-reference/introduction.md).

## 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

```bash theme={null}
export EMAILX_BASE_URL="https://app.emailx.ai"
python3 -m venv .venv-emailx
. .venv-emailx/bin/activate
python -m pip install "emailx-agent[mcp] @ $EMAILX_BASE_URL/api/emailx-agent.zip"
emailx --version
```

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.

```json theme={null}
{
  "mcpServers": {
    "emailx": {
      "command": "/absolute/path/.venv-emailx/bin/emailx",
      "args": ["mcp", "serve", "--transport", "stdio"],
      "env": {
        "EMAILX_BASE_URL": "https://app.emailx.ai",
        "EMAILX_API_KEY_FILE": "/absolute/private/path/emailx-staging.key"
      }
    }
  }
}
```

È 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](https://docs.emailx.ai/it/mcp/recovery.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.