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

# Collegare un agente

> Configura la CLI o il server MCP di Emailx in Claude, ChatGPT, Cursor, Gemini, Grok o in qualsiasi agente di programmazione.

Questa pagina è scritta per poterla passare a un agente. In Emailx apri **API, MCP e CLI** dal menu del profilo e copia il prompt di configurazione, oppure incolla tu stesso l’indirizzo di questa pagina nell’agente.

> [!NOTE]
>
> **Agenti che seguono questi passaggi:** chiedete alla persona una chiave API; non inventatela, non ristampatela e non salvatela in un repository. Prima di qualsiasi passaggio che avvia una campagna, invia un messaggio, usa crediti AI o avvia un acquisto, chiedete conferma alla persona.

## 1. Ottenere una chiave API

La persona crea la chiave in Emailx da **API, MCP e CLI → Nuova chiave API**, scegliendo i workspace, l’accesso (Nessuno, Lettura o Completo per ogni area) e la scadenza. Emailx mostra la chiave una sola volta.

Salvala in un file privato leggibile solo dall’utente:

```bash theme={null}
mkdir -p ~/.config/emailx
# Incolla la chiave come unico contenuto di questo file, poi:
chmod 600 ~/.config/emailx/api-key
```

## CLI

Serve Python 3.11 o successivo.

```bash theme={null}
python3 -m venv ~/.emailx-agent
~/.emailx-agent/bin/python -m pip install "emailx-agent[mcp] @ https://app.emailx.ai/api/emailx-agent.zip"
export EMAILX_BASE_URL="https://app.emailx.ai"
export EMAILX_API_KEY_FILE="$HOME/.config/emailx/api-key"
~/.emailx-agent/bin/emailx doctor --json
```

`doctor` deve indicare l’account e l’ambiente della chiave. Poi esplora con `emailx --help` ed `emailx <gruppo> --help`: ogni comando elenca i campi che accetta. Aggiungi le due righe `export` al profilo della shell, così le sessioni successive continuano a funzionare.

## MCP

Installa il pacchetto come nella sezione CLI (include il server MCP), poi aggiungi Emailx al tuo agente. Usa percorsi assoluti.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add emailx \
>   -e EMAILX_BASE_URL=https://app.emailx.ai \
>   -e EMAILX_API_KEY_FILE=$HOME/.config/emailx/api-key \
>   -- $HOME/.emailx-agent/bin/emailx mcp serve --transport stdio
> ```

> [tab] Cursor
>
> Aggiungi a `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "emailx": {
>       "command": "/Users/tu/.emailx-agent/bin/emailx",
>       "args": ["mcp", "serve", "--transport", "stdio"],
>       "env": {
>         "EMAILX_BASE_URL": "https://app.emailx.ai",
>         "EMAILX_API_KEY_FILE": "/Users/tu/.config/emailx/api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Claude Desktop
>
> Aggiungi la stessa voce `emailx` di Cursor a `claude_desktop_config.json` (Impostazioni → Sviluppatore → Modifica configurazione), poi riavvia Claude Desktop.

> [tab] Codex
>
> Aggiungi a `~/.codex/config.toml`:
>
> ```toml theme={null}
> [mcp_servers.emailx]
> command = "/Users/tu/.emailx-agent/bin/emailx"
> args = ["mcp", "serve", "--transport", "stdio"]
> env = { EMAILX_BASE_URL = "https://app.emailx.ai", EMAILX_API_KEY_FILE = "/Users/tu/.config/emailx/api-key" }
> ```

> [tab] Gemini CLI
>
> Aggiungi la stessa voce `emailx` di Cursor sotto `mcpServers` in `~/.gemini/settings.json`.

### Collegare tramite URL (ChatGPT, Claude sul web, Grok)

Gli assistenti che aggiungono server MCP tramite URL usano `https://app.emailx.ai/mcp`. Accedi a Emailx dal browser e scegli lì workspace e accesso; non serve un file con la chiave. Questo collegamento è disponibile quando è attivo per il tuo account.

## Verificare che funzioni

Chiedi all’agente: "A quale account Emailx e a quali workspace sono collegato?" Deve chiamare `get_connection` e `list_workspaces` e rispondere con i nomi dei tuoi workspace.

Poi: [trovare l’endpoint giusto](https://docs.emailx.ai/it/api-reference/find-endpoint.md), gli [strumenti MCP](https://docs.emailx.ai/it/mcp/tools.md) e i [comandi CLI](https://docs.emailx.ai/it/cli/commands.md).


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