Collegare un agente

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.

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:

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.

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.

Claude Code
Cursor
Claude Desktop
Codex
Gemini CLI

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

Aggiungi a ~/.cursor/mcp.json:

{
  "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"
      }
    }
  }
}

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

Aggiungi a ~/.codex/config.toml:

[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" }

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, gli strumenti MCP e i comandi CLI.

Per iniziare

Inviare con cura

Flussi operativi

Collegare un agente

1. Ottenere una chiave API

CLI

MCP

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

Verificare che funzioni

​1. Ottenere una chiave API

​CLI

​MCP

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

​Verificare che funzioni

1. Ottenere una chiave API

CLI

MCP

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

Verificare che funzioni