Come collegare Brex a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Brex, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Brex + Gemini

Fai leggere alla tua AI il tuo account Brex: carte, transazioni dei conti carta e business, estratti conto, spese, budget, limiti di spesa, fornitori, utenti e viaggi. Token API in sola lettura; non può inviare denaro. Il blocco carta e il memo delle spese sono opzionali e spenti di default.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

BREX_API_TOKEN

Step 1 — Ottieni le credenziali

Non può muovere denaro, per scelta. Il connettore non ha nessuno strumento per bonifici, pagamenti, bill pay, ACH, wire, assegni, nuove carte o modifiche ai limiti, nemmeno uno spento. Se chiedi all'AI di pagare qualcuno, semplicemente non può farlo. Il tuo team finance ottiene risposte sulle spese senza aprire una nuova strada da cui il denaro possa uscire dal conto.

1. Accedi a https://dashboard.brex.com come account admin o card admin e apri Developer, poi Settings. Accetta i termini della developer API se Brex lo chiede.
2. Clicca Create Token, dagli un nome come AnythingMCP e seleziona solo gli scope in sola lettura che il connettore usa: companies.readonly, users.readonly, departments.readonly, locations.readonly, cards.readonly, accounts.card.readonly, accounts.cash.readonly, transactions.card.readonly, transactions.cash.readonly, statements.card.readonly, statements.cash.readonly, expenses.card.readonly, budgets.readonly, vendors.readonly, travel.trips.readonly. Tralascia quelli che non ti servono; gli strumenti corrispondenti risponderanno 403.
3. Non selezionare mai transfers, incoming_transfers o cards.pan. Permettono a un software di muovere denaro o leggere i numeri di carta completi, e questo connettore non ha bisogno di nessuno dei due.
4. Clicca Allow Access, copia il token (inizia con bxt_) in BREX_API_TOKEN e installa il connettore. Brex mostra il token una sola volta.
5. Verifica la configurazione con brex_get_company: mostra la ragione sociale della tua azienda e il tipo di account.

Token in sola lettura: un token con soli scope .readonly non può modificare nulla in Brex.

Spenti all'installazione: brex_lock_card e brex_unlock_card (per una carta persa o un sospetto di frode; il titolare della carta riceve una notifica) e brex_update_expense_memo (scrive lo scopo aziendale e sovrascrive il memo precedente). Per usarli, un admin crea un token che abbia anche lo scope cards per le azioni sulle carte o expenses.card per il memo, e attiva lo strumento. L'AI ti mostra allora il nome della carta e le ultime quattro cifre, oppure la spesa e il nuovo memo, e aspetta il tuo sì. Lo scope cards di Brex permetterebbe anche ad altri software di emettere carte; questo connettore non ha uno strumento del genere.

I dati finanziari sono sensibili: saldi, transazioni, spese, carte e dati dei dipendenti sono dati aziendali riservati. Condividi il server MCP solo con chi può vederli; l'AI legge solo ciò che chiedi. Numeri di carta completi, CVC, numeri di conto e routing number non vengono mai restituiti: le carte mostrano le ultime quattro cifre e i dati bancari di conti e fornitori vengono rimossi.

Cosa legge: azienda, utenti, reparti e sedi; carte con i loro controlli di spesa; saldo e limite del conto carta, transazioni carta contabilizzate ed estratti conto della carta; conti business (cash) con transazioni ed estratti conto; spese (carta, bill pay e rimborsi) con ricevute e stato di conformità, dove DUE e OVERDUE trovano le spese a cui manca ancora una ricevuta o un memo; budget e limiti di spesa con quanto già speso; fornitori; e viaggi di Brex Travel. Le autorizzazioni carta in sospeso non sono incluse, e Brex può contabilizzare una transazione con qualche giorno di ritardo.

Importi: Brex restituisce gli importi nell'unità più piccola della valuta, quindi 700 in USD significa 7,00 USD. L'AI li converte prima di mostrarli.

Limiti e token: 1.000 richieste ogni 60 secondi per account. Un token non usato per 90 giorni scade, e smette di funzionare quando il suo utente non è più attivo. Puoi revocarlo in qualsiasi momento da Developer, Settings. Brex non ha una sandbox, quindi il connettore legge sempre dati reali.

Errori comuni: 401, oppure 403 "Invalid or Revoked Token": il token è errato, revocato o scaduto; creane uno nuovo. 403 solo su alcuni strumenti: al token manca lo scope di quello strumento, oppure al suo utente manca il ruolo Brex (la maggior parte dei dati richiede un account admin). 404: l'id non esiste in questo account Brex. 429: aspetta un minuto.

Il connettore non muove denaro, non emette né chiude carte, non modifica limiti o budget, non approva spese, non carica ricevute e non gestisce utenti e webhook.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Brex.

Tool disponibili

Esempi di prompt

• "Quali spese con carta del mese scorso non hanno ancora una ricevuta o un memo? Raggruppale per dipendente."
• "Elenca le transazioni carta contabilizzate il mese scorso sopra i 1.000 USD con esercente, titolare della carta e data."
• "Qual è il saldo attuale e il limite disponibile del nostro conto carta Brex, e quando finisce il periodo dell'estratto conto?"
• "Quali limiti di spesa hanno già usato più dell'80 percento del limite di questo periodo?"
• "Quali viaggi di Brex Travel iniziano la settimana prossima? Mostra viaggiatore, nome del viaggio e date."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT