Utilisation du serveur MCP Huwise

La fonctionnalité de serveur MCP n’est pas incluse directement dans votre plan. Pour en savoir plus, contactez notre équipe support.

Le Model Context Protocol (MCP) est une norme qui facilite la communication entre les systèmes et les applications d'IA. Au lieu que chaque outil ou modèle ait besoin de sa propre connexion API personnalisée, le MCP fournit un langage commun que tous peuvent utiliser.

Ainsi, le serveur MCP (Model Context Protocol) d'Huwise permet aux agents d'IA générative d'utiliser les API d'Huwise et de consulter notre documentation API.

Cette documentation se concentre sur la configuration de Claude Desktop et d'un agent Microsoft Copilot, mais vous pouvez utiliser le serveur MCP d'Huwise avec d'autres outils qui le prennent en charge, tels que les éditeurs de code basés sur l'IA comme Cursor ou Windsurf.

Le serveur MCP d'Huwise est un serveur autonome, hébergé par Huwise sur sa propre infrastructure. Il garantit un accès rapide et facile, sans avoir à se soucier de la maintenance et des mises à jour du serveur.

Pour configurer un serveur MCP sur Claude Desktop, voici les prérequis nécessaires :

• Claude Desktop est installé sur votre machine (Windows, macOS ou Linux)

• Vous avez Node.js version 18 ou supérieure

• Vous avez npm ou yarn pour la gestion des paquets

Vous devez également disposer d'une clé API avec au moins la permission "Parcourir l'ensemble des jeux de données" pour pouvoir utiliser le serveur MCP.

Pour définir une clé API, consultez Gestion des clés d'API.

Le fichier de configuration de Claude Desktop permet la définition et la configuration des serveurs MCP sur votre outil.

Vous trouverez ces fichiers aux localisations suivantes pour les trois systèmes d'exploitation Windows, Mac OS et Linux :

Sur macOS :

~/Library/Application Support/Claude/claude_desktop_config.json

Sur Windows :

%APPDATA%\Claude\claude_desktop_config.json

Sur Linux :

~/.config/Claude/claude_desktop_config.json

Dans le fichier de configuration, il est nécessaire d'ajouter ces lignes en remplaçant les valeurs indiquées.

{
  "mcpServers": {    
    "huwise": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway@3.4.0",
        "--streamableHttp",
        "https://mcp.huwise.com/mcp",
        "--header",
        "x-domain: <URL DE VOTRE MARKETPLACE HUWISE>",
        "--header",
        "x-apikey: <CLE D'API>"
      ]
    }
  }
}

Il sera nécessaire de spécifier dans ces lignes les valeurs

<URL DE VOTRE MARKETPLACE HUWISE>

et

<CLE D'API>

en remplaçant ces valeurs par l'URL et par les valeurs de votre clé d'API utilisée dans le cadre du serveur MCP.

Pour utiliser un serveur MCP Huwise dans un environnement Microsoft Teams et Microsoft 365, vous devez configurer un agent Copilot.

Dans la terminologie MCP, l'agent est l'élément qui se connecte au serveur et rend ses fonctionnalités disponibles, dans ce cas Microsoft Teams et Microsoft 365.

• Les utilisateurs et les créateurs doivent avoir une licence pour utiliser Microsoft 365 Copilot.

• Les créateurs doivent avoir les autorisations nécessaires pour créer et accéder à un environnement Copilot Studio.

Selon la documentation fournie par Microsoft :

Le serveur MCP Huwise doit être déclaré comme l'un des outils de l'agent Copilot, et configuré avec une connexion personnalisée en suivant les instructions ici : Se connecter à un serveur Model Context Protocol (MCP) existant.

Pour faciliter la création du connecteur, vous pouvez utiliser le swagger suivant :

swagger: '2.0'
info:
  title: Huwise MyDataMarketplace MCP Client
  description: Client MCP pour se connecter à la démo du Data Marketplace d'Huwise.
  version: 1.0.0
host: mcp.huwise.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Serveur MCP Huwise
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Succès

À ce stade, déclarez les deux variables d'en-tête, "x-domain" et "x-apikey", dans le connecteur. Ces variables sont nécessaires pour authentifier l'assistant à votre marketplace, en particulier pour les données privées.

Ensuite, ajoutez deux stratégies en cliquant sur le bouton Nouvelle Stratégie dans l'onglet 3 - Définition.

Les stratégies doivent être définies en utilisant ces paramètres :

explore_api_documentation

explore_get_datasets

explore_get_dataset

explore_get_dataset_records