Pleaxy
Documentazione

Collegare un agente IA

Dai a Claude, ChatGPT o a qualsiasi altro client MCP gli strumenti per i tuoi ordini d’acquisto, fatture e approvazioni, con il tuo accesso.

Panoramica

Il server MCP di Pleaxy dà a un agente IA, come Claude o ChatGPT, strumenti per i tuoi ordini d’acquisto, fatture, ricevimenti e approvazioni. Lo colleghi al tuo account Pleaxy: vede ciò che vedi tu, nei workspace che scegli, e ogni modifica che fa viene registrata a nome tuo. Le decisioni restano a te.

Ci sono due modi per collegarlo. Un’app che si collega ai server MCP tramite URL, come claude.ai, le app di Claude o ChatGPT, usa il server ospitato da Pleaxy, senza nulla da installare. Un client MCP sul tuo computer, come Claude Desktop, Claude Code o Cursor, può eseguire il server da sé con npx. In entrambi i casi il collegamento funziona allo stesso modo: Pleaxy si apre nel browser, accedi, selezioni i workspace e lo consenti.

Collega un’app tramite URL

Nelle impostazioni dei connettori della tua app, aggiungi un connettore personalizzato con questo indirizzo. Non ci sono ID client né chiavi da inserire: l’app si registra da sé presso Pleaxy.

connector URL
https://mcp.pleaxy.ai/mcp
  1. Collega. L’app apre Pleaxy nel browser. Accedi come fai sempre: password, passkey o il single sign-on della tua azienda.
  2. Scegli i workspace. Pleaxy mostra quale app lo chiede e dove ti rimanderà. Seleziona i workspace che l’agente può usare e scegli Consenti.
  3. Usalo. Tornato nell’app, chiedi dei tuoi ordini d’acquisto o delle tue fatture. L’app mantiene il collegamento: non devi accedere di nuovo per 30 giorni.

Eseguilo sul tuo computer

Il server è su npm come pleaxy-mcp e richiede Node.js 22.18 o successivo. Collegalo una volta da un terminale: Pleaxy si apre nel browser, dove accedi, selezioni i workspace e lo consenti.

shell
export PLEAXY_API_BASE_URL="https://api.pleaxy.ai"
npx -y pleaxy-mcp login     # opens Pleaxy: sign in, tick the workspaces, Allow
npx -y pleaxy-mcp whoami    # who the server acts as, and its workspaces
npx -y pleaxy-mcp logout    # disconnects it

Poi aggiungilo alla configurazione del tuo client MCP. Senza una chiave API impostata, il server agisce a nome tuo. L’accesso è salvato sul tuo computer, leggibile solo da te, e tutti i client MCP che eseguono il server su quel computer lo condividono.

mcp config · json
{
  "mcpServers": {
    "pleaxy": {
      "command": "npx",
      "args": ["-y", "pleaxy-mcp"],
      "env": {
        "PLEAXY_API_BASE_URL": "https://api.pleaxy.ai"
      }
    }
  }
}

Workspace

Un agente usa solo i workspace che hai selezionato quando l’hai collegato. Ogni strumento accetta un workspace e list_workspaces li elenca, quindi un solo collegamento funziona per tutti. Se hai consentito un solo workspace, l’agente usa quello.

Per aggiungere o rimuovere un workspace, collega di nuovo l’agente e seleziona un insieme diverso. Se perdi l’accesso a un workspace in Pleaxy, lo perde anche l’agente.

Cosa può fare un agente

Un agente può leggere e preparare in bozza tutto ciò che il tuo ruolo consente: trovare ordini d’acquisto e fatture, controllare la spesa IA, riconciliare una fattura, creare una richiesta d’acquisto. Le decisioni sono un’altra cosa. Approvare o rifiutare una fattura, inoltrare una discrepanza all’approvazione, registrare un pagamento, creare o approvare un ordine d’acquisto, confermare un ricevimento, decidere su una scheda di registrazione servizi e impostare il limite di spesa di un provider e, per un fornitore, confermare che un pagamento è arrivato o segnalare che non è arrivato, ti vengono inviati come richieste dell’agente. Confermi o annulli ciascuna in Pleaxy entro 24 ore, e non succede nulla finché non lo fai. Il rifiuto di un ordine d’acquisto la cui fase di approvazione indica te avviene subito, come in Pleaxy Assistant.

Un agente non conferma mai le proprie richieste e non può modificare le tue impostazioni di sicurezza, le chiavi API o i membri del workspace. Pleaxy registra ogni modifica che un agente fa o chiede.

I tuoi agenti collegati

Pleaxy ti avvisa ogni volta che un agente si collega al tuo account. Vedi ogni agente collegato, con l’app in cui viene eseguito, i suoi workspace e quando è stato usato l’ultima volta, in Pleaxy sotto Sicurezza e accesso → Agenti, dove puoi disconnettere ciascuno.

Un collegamento dura 30 giorni. Termina prima se disconnetti l’agente, reimposti la password, disattivi la verifica in due passaggi o il tuo accesso a Pleaxy viene bloccato. In quel caso collegalo di nuovo. Puoi avere fino a 20 agenti collegati.

Integrazioni con una chiave API

Per un’integrazione che funziona senza una persona, il server sul tuo computer può usare una chiave API del workspace al posto del tuo accesso (vedi Agenti IA (MCP)). Una chiave agisce in un solo workspace e non può prendere decisioni: quelle richiedono una persona. Il server ospitato non accetta chiavi API.

Contattaci