Cohesity Cortan MCP (anteprima)

Connettere gli agenti Copilot Studio a Cohesity Data Insights tramite un server MCP (Model Context Protocol). Gli agenti individuano gli strumenti in fase di esecuzione ed eseguono set di dati di query, eseguono domande e risposte LLM e eseguono ricerche nei documenti indicizzati usando la chiaveAPIa.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Panoramica dell'architettura

Il server McP Di Classe funge da ponte tra i client MCP, ad esempio Copilot Studio e l'API REST di Xaml. I client MCP comunicano con il server usando il protocollo di contesto del modello su HTTP streamable nell'endpoint /mcp. Il server viene implementato con FastMCP ed eseguito con stateless_http=True.

Ogni strumento MCP esegue il mapping a un'operazione REST specifica che viene contrassegnata in modo esplicito con x-mcp-tool: true nella specifica OpenAPI di Operation OpenAPI. I nomi e le descrizioni degli strumenti possono essere personalizzati usando x-mcp-config.

Quando un client richiama uno strumento, il server MCP elabora la richiesta JSON-RPC e chiama l'API REST di Xaml corrispondente usando il api.base_url configurato. Il server inoltra la maggior parte delle intestazioni HTTP in ingresso in modo che l'autenticazione e l'autorizzazione rimangano coerenti tra l'accesso basato su MCP e l'utilizzo diretto dell'API REST.

Strumenti MCP disponibili

Il server MCP genera strumenti solo per le operazioni OpenAPI contrassegnate con x-mcp-tool: true.

| Strumento MCP | OpenAPI operationId | Metodo | Percorso ---------------------|---------------------------|--------|-------------------------| | gaia_datasets | GetDatasets | GET | /datasets | | gaia_dataset_topics | GetDatasetDiscoveryResults| GET | /dataset/{id}/discovery | | gaia_ask | QueryLlm | POST | /ask | | gaia_search | ExhaustiveSearch | PUT | /ask/exhaustive | Nota: tutti gli strumenti richiedono il privilegio GAIA_VIEW.

Autenticazione e intestazioni

Richiesto da Affiancato

L'uso di uno schema di sicurezza basato su chiave API (ApiKeyAuth) viene usato come definito nella specifica OpenAPI.

I client devono includere l'intestazione seguente:

• apiKey: la chiave API di Eseguire l'api

gaia_datasets

• Scopo: elenca i set di dati e funge da punto di ingresso per altri strumenti di Esegue.
• Parametri visibili: tutti i parametri di query della specifica OpenAPI, ad eccezione di quelli nascosti tramite x-mcp-config.hidden-params (statuses, sortField, sortOrder).
• Impostazioni predefinite: pageSize: 20 viene applicato tramite le impostazioni predefinite della query, se non specificate.
• Risposta: tagliato al modello GetDatasetsResponse.

gaia_dataset_topics

• Scopo: restituisce argomenti gerarchici per un set di dati.
• Parametro path: id deve essere l'ID esadecimale del set di dati restituito da gaia_datasets, non il nome visualizzato.
• Valori predefiniti: livello: 1, numLevels: 2.
• Parametri nascosti: uuid.
• Dipendenze (informativo): GetDatasets, GetDatasetDetails.

gaia_ask

• Scopo: esegue una query LLM in uno o più set di dati
• Corpo della richiesta: LlmQueryParams con i campi obbligatori:
  • datasetNames (array)
  • queryString
• Campi nascosti: llmId, llmName, llm, conversationId, queryLanguageCode, cronologia, metadati.
• Risposta: filtrata in base allo schema QueryLlmResponse (testo della risposta, documenti di supporto, avanzamento e identificatori).

gaia_search

• Scopo: esegue una ricerca completa all'interno di un set di dati.
• Corpo della richiesta: ExhaustiveSearchParams con i campi obbligatori:
  • Datasetname
  • queryString
  • pageSize (impostazione predefinita 10 inserita tramite valori predefiniti di query)
• Campi nascosti: conversationId.
• Risposta: filtrata in base allo schema ExhaustiveSearchResponse (documenti, token di paginazione e ID).

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Limiti per la limitazione delle richieste

Azioni

Cohesity Xaml MCP