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 un standard ouvert qui permet aux systèmes d'IA et aux applications de communiquer entre eux. Le serveur MCP de Huwise permet aux agents d'IA d'interroger votre portail de données — rechercher et analyser des assets (jeux de données, visualisations, showcases, pages, réutilisations) — directement via des outils en langage naturel, sans passer par des appels manuels à l'API Explore.

Cet article explique comment connecter le serveur MCP Huwise aux clients MCP couramment utilisés.

Notez que nous travaillons à rendre le serveur MCP de Huwise disponible comme connecteur dans ChatGPT et Mistral AI. Ce n'est pas encore disponible — cet article sera mis à jour dès que ce sera le cas.

Pour une documentation technique plus détaillée sur le serveur MCP Huwise, notamment sur ses outils, ses paramètres et ses endpoints, consultez mcp.huwise.com/docs.

Authentification

Chaque requête envoyée au serveur MCP doit identifier quel portail interroger et qui fait la demande. Cela se fait via des en-têtes HTTP (ou, lorsque les en-têtes ne sont pas supportés, via des paramètres d'URL équivalents) :

En-tête	Obligatoire	Description
`X-Domain`	Oui	L'URL de votre portail de données Huwise (ex. `https://votre-portail.com`)
`X-Apikey`	Oui	Votre clé API

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

Configuration de Claude Desktop

Prérequis

Claude Desktop installé (Windows, macOS ou Linux)
Node.js version 18 ou supérieure
npm ou yarn pour la gestion des paquets
Une clé API valide

Localiser le fichier de configuration

macOS :

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

Windows :

%APPDATA%\Claude\claude_desktop_config.json

Linux :

~/.config/Claude/claude_desktop_config.json

Configuration MCP

{
  "mcpServers": {
    "huwise": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway@3.4.3",
        "--streamableHttp",
        "https://mcp.huwise.com/mcp",
        "--header",
        "x-domain: <URL DE VOTRE PORTAIL HUWISE>",
        "--header",
        "x-apikey: <CLÉ API>"
      ]
    }
  }
}

Redémarrez Claude Desktop après avoir enregistré le fichier pour que le nouveau serveur apparaisse.

Configurer Cursor

Prérequis

Cursor installé (Windows, macOS ou Linux)
Une clé API valide

Localiser le fichier de configuration

Cursor charge les serveurs MCP depuis un fichier mcp.json, à l'une des deux échelles suivantes :

Projet : .cursor/mcp.json à la racine de votre projet
Global : ~/.cursor/mcp.json dans votre répertoire personnel

Configuration MCP

Cursor se connecte directement au endpoint HTTP du serveur — aucun proxy local n'est nécessaire :

{
  "mcpServers": {
    "huwise": {
      "url": "https://mcp.huwise.com/mcp",
      "headers": {
        "x-domain": "<URL DE VOTRE PORTAIL HUWISE>",
        "x-apikey": "<CLÉ API>"
      }
    }
  }
}

Rechargez les paramètres MCP (ou redémarrez Cursor) pour que le nouveau serveur apparaisse.

Configurer un assistant Microsoft Copilot

Prérequis

Une licence Microsoft 365 Copilot pour utilisateurs et créateurs
Les permissions nécessaires pour accéder à Copilot Studio

Créer l'agent

Le serveur MCP de Huwise se déclare comme outil de votre agent Copilot via Copilot Studio (voir la documentation Microsoft sur l'extension de Copilot).

Extrait Swagger à importer

swagger: '2.0'
info:
  title: Huwise MCP server
  version: 2.0.0
host: mcp.huwise.com
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Huwise MCP Server
      x-ms-agentic-protocol: mcp-streamable-1.0

Stratégies de configuration requises

Ajoutez une stratégie par en-tête que votre agent doit envoyer :

Paramètre	X-Domain	X-Apikey
Type	Set HTTP header	Set HTTP header
Nom de l'en-tête	`x-domain`	`x-apikey`
Valeur	L'URL de votre portail	La clé API choisie
Action	Override	Override
Exécution	Request	Request

Outils disponibles

Le serveur propose quatre outils, tous construits sur l'API Explore et ODSQL :

Outil	À quoi il sert	Utilisation type
`analyze_catalog`	Analyser la structure et la composition du catalogue d'un portail via ODSQL (`select`, `where`, `order_by`, `group_by`, `facet`…)	« Combien d'assets y a-t-il ? », « Quelle est la répartition par type ? », « Qu'est-ce qui a changé récemment ? »
`search_assets`	Rechercher les assets d'un portail par similarité sémantique	Découvrir des assets par thématique quand on ne connaît pas l'asset exact
`get_asset`	Récupérer les métadonnées complètes d'un asset via son slug	Vous connaissez déjà l'asset visé et avez besoin de ses détails, de son schéma ou d'échantillons de données
`search_asset_records`	Interroger et filtrer les enregistrements d'un asset donné via son slug, avec ODSQL	Filtrer, trier ou paginer dans les données d'un asset connu

Ce sont les outils exposés par la version par défaut (latest) du serveur. Les jeux d'outils précédents (beta, old) restent disponibles pour la rétrocompatibilité — voir la référence complète pour le détail.

Notez que les noms des outils ont changé avec la mise à jour v2.0 du serveur : explore_get_datasets, explore_get_dataset et explore_get_dataset_records sont désormais search_assets, get_asset et search_asset_records, et couvrent maintenant tous les types d'assets (pas seulement les jeux de données). Si votre client référence encore les anciens noms, mettez-le à jour pour qu'il pointe vers les outils ci-dessus.