> ## 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 l’accesso

> Host esplicito, chiave privata e nessun cliente predefinito.

> [!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).

Crea una chiave con scadenza in Emailx, da [Impostazioni > Chiavi API](https://docs.emailx.ai/it/overview/authentication.md#creare-una-chiave). Caricala con una sola variabile tra `EMAILX_API_KEY` ed `EMAILX_API_KEY_FILE`. Per l'uso locale è preferibile il file.

```bash theme={null}
export EMAILX_BASE_URL="https://app.emailx.ai"
export EMAILX_API_KEY_FILE="/absolute/private/path/emailx-key"
emailx doctor --json
emailx auth status --json
emailx workspaces list --limit 25 --json
```

Compila il file con un gestore di segreti o un editor. Deve contenere solo la chiave, appartenere all'utente corrente, avere permessi `0600` e non essere un symlink. Non passare chiavi come argomenti dei comandi e non versionarle.

## Più clienti

Non esistono un cliente attivo implicito o un cambio profilo salvato. Seleziona il workspace in ogni comando sulle risorse. Le chiamate agenzia richiedono `agency:read`, scope della risorsa e appartenenza corrente. Verifica gli accessi prima di lavorare con un cliente che potrebbe essere stato riassegnato.

## Comportamento del trasporto

Serve HTTPS, salvo sviluppo loopback esplicito. Il client non carica `.env`, non segue redirect e non usa proxy HTTP dell'ambiente. Si collega solo all'API configurata, mai direttamente a credenziali provider o database.

Ruota e revoca le chiavi in Emailx, da Impostazioni > Chiavi API. Le regole correnti dei ruoli valgono allo stesso modo per CLI, MCP e REST.


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