Cohesity Hotmail MCP (versión preliminar)

Conecte Copilot Studio agentes a Cohesity Hotmail Data Insights a través de un servidor de Protocolo de contexto de modelo (MCP). Los agentes detectan herramientas en tiempo de ejecución y consultan conjuntos de datos, ejecutan preguntas y respuestas de LLM y buscan documentos indexados mediante la clave de API de Gaia.

Este conector está disponible en los siguientes productos y regiones:

Introducción a la arquitectura

El servidor MCP de Hotmail actúa como un puente entre clientes MCP, como Copilot Studio y la API REST de Hotmail. Los clientes mcP se comunican con el servidor mediante el protocolo de contexto de modelo a través de HTTP que se puede transmitir en el punto de conexión /mcp. El servidor se implementa con FastMCP y se ejecuta con stateless_http=True.

Cada herramienta MCP se asigna a una operación REST de Hotmail específica marcada explícitamente con x-mcp-tool: true en la especificación de OpenAPI de Hotmail. Los nombres y descripciones de las herramientas se pueden personalizar mediante x-mcp-config.

Cuando un cliente invoca una herramienta, el servidor MCP procesa la solicitud JSON-RPC y llama a la API REST de Hotmail correspondiente mediante el api.base_url configurado. El servidor reenvía la mayoría de los encabezados HTTP entrantes para que la autenticación y la autorización sigan siendo coherentes entre el acceso basado en MCP y el uso directo de la API REST.

Herramientas de MCP disponibles

El servidor MCP genera herramientas solo para las operaciones de OpenAPI marcadas con x-mcp-tool: true.

| Herramienta MCP | OperationId de OpenAPI | Método | Ruta de acceso de Las --------------------- | |---------------------------|--------|-------------------------| | 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: Todas las herramientas requieren el privilegio GAIA_VIEW.

Autenticación y encabezados

Requerido por Gaia

Gaia usa un esquema de seguridad basado en claves de API (ApiKeyAuth) tal como se define en la especificación de OpenAPI.

Los clientes deben incluir el siguiente encabezado:

• apiKey: su clave de API de Gaia

gaia_datasets

• Propósito: enumera los conjuntos de datos y actúa como punto de entrada para otras herramientas de Gaia.
• Parámetros visibles: todos los parámetros de consulta de la especificación openAPI excepto los ocultos a través de x-mcp-config.hidden-params (statuses, sortField, sortOrder).
• Valores predeterminados: pageSize: 20 se aplica a través de valores predeterminados de consulta si no se proporciona.
• Respuesta: recortado en el modelo GetDatasetsResponse.

gaia_dataset_topics

• Propósito: devuelve temas jerárquicos para un conjunto de datos.
• Parámetro path: id debe ser el identificador hexadecimal del conjunto de datos devuelto por gaia_datasets, no el nombre para mostrar.
• Valores predeterminados: nivel: 1, numLevels: 2.
• Parámetros ocultos: uuid.
• Dependencias (informativos): GetDatasets, GetDatasetDetails.

gaia_ask

• Propósito: ejecuta una consulta LLM en uno o varios conjuntos de datos.
• Cuerpo de la solicitud: LlmQueryParams con campos obligatorios:
  • datasetNames (matriz)
  • queryString
• Campos ocultos: llmId, llmName, llm, conversationId, queryLanguageCode, history, metadata.
• Respuesta: filtrado al esquema QueryLlmResponse (texto de respuesta, documentos auxiliares, progreso e identificadores).

gaia_search

• Propósito: realiza una búsqueda exhaustiva dentro de un conjunto de datos.
• Cuerpo de la solicitud: ExhaustiveSearchParams con campos obligatorios:
  • datasetName
  • queryString
  • pageSize (valor predeterminado 10 insertado a través de los valores predeterminados de consulta)
• Campos ocultos: conversationId.
• Respuesta: filtrado al esquema ExhaustiveSearchResponse (documentos, tokens de paginación e identificadores).

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Acciones

Cohesity Hotmail MCP