Salta ai contenuti
mofcloud

MCP e OAuth

Ultimo aggiornamento:

MOF è un server MCP. Una volta attivato, client AI come Claude Desktop, Cursor e Dify possono interrogare i dati di costo che ogni utente è autorizzato a vedere. L'accesso è in sola lettura.

Attiva MCP

Amministratore

  1. Apri Admin → Impostazioni → Accesso MCP.
  2. Attiva “Consenti connessioni MCP”.
  3. Fai clic su “Verifica connessione”. Il servizio MCP dovrebbe mostrare “Connesso”.

Il container MCP è incluso nei template di deployment; non c'è altro da installare. Se la verifica non riesce, assicurati che il container mof-mcp sia in esecuzione e alla stessa versione di MOF.

Configura OAuth

Amministratore · necessario per Claude Desktop

Con OAuth, gli utenti incollano un indirizzo nel loro client AI e accedono con il proprio account MOF. Senza, devono creare un token a mano, e Claude Desktop non può usare i token.

  1. Servi MOF tramite HTTPS pubblico. Claude si connette dai propri server, quindi l'indirizzo deve essere raggiungibile da internet.
  2. Aggiungi due variabili al servizio mof e ricrealo:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"
  1. In Admin → Impostazioni → Accesso MCP, fai di nuovo clic su “Verifica connessione”. L'accesso OAuth dovrebbe mostrare “Configurato”.

MOF_PUBLIC_URL è l'indirizzo che aprono gli utenti, senza percorso. Il secret deve avere almeno 32 caratteri e deve essere identico su ogni server MOF. “Configurato” significa solo che entrambi sono impostati; il primo accesso reale da Claude conferma che la callback pubblica funziona. Variabili d'ambiente

Collega Claude Desktop

Ogni utente

  1. In MOF, apri Impostazioni → Connessioni MCP e copia l'URL del server.
  2. In Claude Desktop, apri Settings → Connectors → Add custom connector. Inserisci un nome come MOF e incolla l'indirizzo.
  3. Fai clic su Connect, accedi con il tuo account MOF nel browser e approva.
  4. Fai una domanda a Claude, ad esempio “Quanto abbiamo speso il mese scorso, per cloud?”
Client senza OAuth: usa un token

In Impostazioni → Connessioni MCP → Token manuali, inserisci un nome e fai clic su “Crea token”. Copialo subito; viene mostrato una sola volta e dura 90 giorni. Invialo come header della richiesta:

Header
Authorization: Bearer YOUR_TOKEN

Revoca l'accesso

Gli utenti revocano le proprie app e i propri token in Impostazioni → Connessioni MCP, in “App collegate” e “I miei token”. Disattivare “Consenti connessioni MCP” in Admin interrompe tutte le connessioni in una volta.