Connessione a MCP

Verificare la disponibilità prima di collegare un client.

Connessioni ospitate

Cloud MCP usa https://mcp.altifigence.com/cloud-mcp con Streamable HTTP e OAuth. Vedere disponibilità e qualificazione dei client prima di configurare un client.

  1. Aggiungere l'endpoint esatto nelle impostazioni di connessione MCP remota del client.

  2. Completare l'accesso ad Account ed esaminare l'organizzazione e le autorizzazioni Cloud richieste nella pagina del consenso. Il client gestisce le credenziali OAuth.

  3. Inizializzare la connessione e aggiornare l'elenco degli strumenti del client. Compaiono soltanto gli strumenti Cloud attualmente consentiti.

  4. Con l'autorizzazione di lettura, leggere prima la propria identità e l'elenco dei progetti. Usare un ID di progetto restituito per leggere progetto e file; la lettura dei file richiede un'area di lavoro pronta.

  5. Per modifiche a progetto, file, impostazioni o Git, richiedere https://mcp.altifigence.com/cloud.write e completare un nuovo consenso. L'organizzazione deve consentire esplicitamente ogni strumento. Leggere le revisioni correnti di progetto e file prima di modificare file salvati; esaminare lo stato dopo una risposta incerta a una modifica prima di decidere se riprovare.

  6. Per il ciclo di vita del runtime, le azioni di terminale o i job, richiedere l'autorizzazione https://mcp.altifigence.com/cloud.execute e completare un nuovo consenso. L’analisi del codice RTL salvato in Cloud non è ancora aperta ai clienti. Consultare i flussi di lavoro degli strumenti. La disponibilità dipende dalla release del servizio e dalla policy di runtime e strumenti dell'organizzazione.

  7. Per le connessioni AI personali, richiedere soltanto gli ambiti AI necessari elencati in sicurezza dell'account, ottenere l'approvazione degli strumenti dell'organizzazione e completare un nuovo consenso. Usare l'URL di configurazione sicura restituito per consentire all'utente di inserire una chiave del provider direttamente nel Cloud. Esaminare provider, modello, contesto e possibili costi selezionati prima di richiedere una risposta AI.

I nuovi nomi di strumenti richiedono un nuovo consenso, compresi nuovi strumenti all'interno di un'autorizzazione esistente. Aggiornare un vecchio token non li aggiunge. Il progetto selezionato nella console non concede autorizzazione. Cambiare l'organizzazione autorizzata richiede un nuovo consenso. Un progetto arrestato non viene avviato da una richiesta di lettura. Non aggiungere token di account, cookie del browser né chiavi di provider AI alla configurazione della connessione.

Se inizializzazione o autorizzazione falliscono, usare risoluzione dei problemi. Non ripiegare sull'invio di richieste di protocollo alla radice di un sito o a un altro profilo.

Software installato

Per gli strumenti XLS locali, usa la CLI Linux verificata con ALTI_MCP_MODE=local-xls. Consulta CLI per la configurazione. Questa modalità non utilizza l’inoltro di operazioni al Cloud del cliente. Vedere Panoramica MCP per la differenza tra connessioni locali e ospitate.

Verificare la prima lettura

  1. Chiedere al client di leggere l'account e l'organizzazione Altifigence collegati.

  2. Elencare i progetti accessibili e selezionare un ID di progetto restituito.

  3. Leggere lo stato del progetto selezionato. Se la lettura di un file non è disponibile, verificare progetto selezionato, accesso e stato attuale di archiviazione/servizio in Cloud. Avviare un runtime è un'azione di esecuzione separata; il normale accesso ai file salvati non richiede l'avvio di un runtime personale.

  4. Elencare i file e scegliere un percorso restituito. Leggerne il contenuto completo, seguendo gli offset di continuazione quando necessario.

  5. Chiedere un riepilogo che includa progetto, percorso e revisione salvata. Confrontarlo con Cloud prima di usare la connessione per lavori più ampi.

Richiesta di esempio: «Elenca i miei progetti Altifigence Cloud. Leggi il README nel progetto che seleziono, poi riassumi i passaggi di configurazione e identifica il file salvato che hai usato». Questo opera nell'ambito di lettura pubblicato e rende esplicito il target.