Interface MCP et API pour les outils d’IA

Fonctionnement

Demander au lieu de cliquer.

L’outil d’IA décide lui-même des outils dont il a besoin pour votre question, les appelle auprès de HerzensManagement et répond avec les données de votre agence.

Vous posez la question

En langage courant, dans l’outil que vous utilisez déjà.

L’outil d’IA appelle des outils

Par exemple list_shifts ou list_invoices. Tous les outils sont en lecture seule.

HerzensManagement répond

Uniquement les données de votre agence, et uniquement dans les domaines que la clé est autorisée à lire.

À quoi cela ressemble

Une question, deux outils, une réponse.

Dans l’exemple, un membre de l’équipe de l’agence demande les changements de rotation de la semaine prochaine et les factures impayées. L’outil d’IA appelle deux outils pour cela et résume le résultat. Il ne peut rien modifier.

Quelles rotations changent la semaine prochaine ? Quelles factures sont encore impayées ? Quelles auxiliaires de vie sont disponibles à partir du 1er novembre ?

Votre outil d’IA HerzensManagement connecté

Quelles rotations changent la semaine prochaine, et quelles factures sont encore impayées ?

HerzensManagement · list_shifts (du 19/10 au 25/10)

HerzensManagement · list_invoices (statut impayé)

4 changements de rotation sont prévus la semaine prochaine, et 6 factures sont encore impayées.

4changements de rotation
6factures impayées
9 840 €montant dû

Changements de rotation de la semaine :

Mme BergerDépart de Maria K., arrivée d’Elena P.lun. 19/10
M. SteinerArrivée d’Ivana D.mer. 21/10
Mme WinklerChangement d’auxiliaire de viejeu. 22/10
M. LeitnerChangement d’auxiliaire de viesam. 24/10

Vue d’exemple avec des données inventées

Cas d’usage

Ce que les agences et les équipes peuvent en faire.

La semaine en un coup d’œil, sans cliquer

« Quelles rotations changent la semaine prochaine ? »

L’outil d’IA lit les rotations de la période et indique chez quels clients un changement est prévu et quelle auxiliaire de vie est affectée.

Les factures impayées sous les yeux

« Quelles factures sont encore impayées ? »

Interroger les factures avec statut, montant et période, et faire résumer le résultat.

Vérifier les disponibilités

« Quelles auxiliaires de vie sont disponibles à partir du 1er novembre ? »

L’outil d’IA lit les auxiliaires de vie et leurs rotations et indique qui n’est pas affecté à partir de cette date.

Vue mensuelle pour la direction

« Prépare-moi la synthèse d’octobre. »

Clients par statut, rotations et factures du mois sous forme de rapport, dans le format que votre outil d’IA maîtrise le mieux.

Vos propres processus dans n8n

Envoyer chaque lundi à l’équipe les changements de rotation de la semaine.

Dans n8n, les mêmes outils servent de briques à un workflow. HerzensManagement fournit les données ; la suite dépend de votre workflow.

Pour vos développeurs

« Montre-moi les rotations d’un client en décembre. »

Qui relie sa propre application dispose des données de l’agence directement dans Claude Code ou Cursor.

Configuration

Créer une clé, la saisir, c’est connecté.

Une fois l’interface activée, l’administrateur de votre agence crée une clé dans le panel sous « Einstellungen → API » (Paramètres → API) : avec un nom, une sélection d’autorisations et une date d’expiration facultative. La clé est affichée une seule fois et peut être révoquée à tout moment.

L’adresse et la clé des exemples sont des valeurs fictives. L’adresse réelle de votre interface figure dans le panel sous « Einstellungen → API ».

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "herzensmanagement": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://IHRE-API-ADRESSE/api/mcp",
        "--header", "Authorization: Bearer ${HERZENS_API_KEY}"
      ],
      "env": { "HERZENS_API_KEY": "IHR-SCHLUESSEL" }
    }
  }
}

Paramètres → Développeur → Modifier la configuration. Redémarrez ensuite Claude.

Claude Code

Terminal

claude mcp add --transport http herzensmanagement \
  https://IHRE-API-ADRESSE/api/mcp \
  --header "Authorization: Bearer IHR-SCHLUESSEL"

Une commande dans le dossier du projet. Vérifiez ensuite la connexion avec /mcp.

ChatGPT

Paramètres → Connecteurs

Nom :               HerzensManagement
URL du serveur MCP : https://IHRE-API-ADRESSE/api/mcp
Authentification :  clé API (IHR-SCHLUESSEL)

Sélectionnez ensuite le connecteur « HerzensManagement » dans le chat.

Les connecteurs personnalisés nécessitent le mode développeur de votre espace de travail ChatGPT.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "herzensmanagement": {
      "url": "https://IHRE-API-ADRESSE/api/mcp",
      "headers": { "Authorization": "Bearer IHR-SCHLUESSEL" }
    }
  }
}

Valable pour le projet ; sous ~/.cursor/mcp.json pour tous les projets.

Direct (JSON-RPC)

Terminal

curl -X POST https://IHRE-API-ADRESSE/api/mcp \
  -H "Authorization: Bearer IHR-SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

MCP est un standard ouvert. Voici comment demander, sans outil d’IA, quels outils votre clé peut utiliser.

Transport : MCP sur HTTP (streamable HTTP), authentification par Authorization: Bearer <clé>.

Les mêmes données sont aussi disponibles sous forme d’API REST classique (/api/v1/..., clé Bearer). La documentation pour développeurs, avec démarrage rapide et exemples, se trouve dans le panel à côté des paramètres des clés.

Outils

Ce que votre outil d’IA peut lire dans HerzensManagement.

Sept outils, tous exclusivement en lecture. Il n’existe aucun outil d’écriture. Vous définissez par les autorisations d’une clé les domaines qu’elle peut lire :

clients:read caregivers:read shifts:read invoices:read

Outil	Ce qu’il renvoie	Accès
`get_agency`	Données de base de votre agence	Lecture
`list_clients`	Clients avec statut, lieu et niveau de dépendance ; filtre par statut, recherche	Lecture
`get_client`	Un client donné	Lecture
`list_caregivers`	Auxiliaires de vie ; filtre par statut, recherche	Lecture
`get_caregiver`	Une auxiliaire de vie donnée	Lecture
`list_shifts`	Rotations sur une période, par client ou par auxiliaire de vie	Lecture
`list_invoices`	Factures avec statut, montant et période	Lecture

Vous décidez de ce qu’un outil d’IA voit.

Chaque clé ne vaut que pour votre seule agence, lit uniquement et peut être révoquée à tout moment. Ce qu’un outil renvoie est traité par le fournisseur de votre outil d’IA. Pour les données personnelles des clients et des auxiliaires de vie, y compris les informations relatives à la santé, il vous faut un contrat de sous-traitance avec ce fournisseur. Les autorisations vous permettent de limiter une clé à des domaines moins sensibles.

Réserver une démo

Questions fréquentes

Qu’est-ce que MCP ?

Le Model Context Protocol est un standard ouvert par lequel des outils d’IA comme Claude ou ChatGPT accèdent à des systèmes tiers. Un service y décrit ses outils, et l’outil d’IA les appelle au besoin. Vous n’avez besoin d’aucun développement de votre côté.

De quel outil d’IA ai-je besoin ?

De n’importe quel outil compatible MCP. En font partie Claude Desktop, Claude Code, ChatGPT, Cursor, GitHub Copilot dans VS Code, Gemini CLI, Windsurf, Le Chat et n8n. Tout autre outil compatible MCP peut également être relié.

L’outil d’IA peut-il modifier quelque chose ?

Non. Tous les outils sont en lecture seule. Il n’existe aucun outil d’écriture.

À quelles données l’outil d’IA peut-il accéder ?

Aux données de base de l’agence, aux clients, aux auxiliaires de vie, aux rotations et aux factures, et uniquement à ceux de l’agence à laquelle la clé appartient. Avec les autorisations clients:read, caregivers:read, shifts:read et invoices:read, vous définissez pour chaque clé les domaines qu’elle peut lire.

Qu’est-ce que cela implique pour la protection des données ?

Ce qu’un outil renvoie est traité par le fournisseur de votre outil d’IA. Pour les données personnelles des clients et des auxiliaires de vie, y compris les informations relatives à la santé, il vous faut donc un contrat de sous-traitance avec ce fournisseur. Les autorisations vous permettent de limiter une clé à des domaines moins sensibles.

Comment obtenir l’accès ?

L’interface est désactivée par défaut. Sur demande, l’équipe HerzensManagement l’active pour votre agence. Ensuite, l’administrateur de votre agence crée une clé dans le panel sous « Einstellungen → API » (Paramètres → API) : avec un nom, des autorisations et une date d’expiration facultative. La clé est affichée une seule fois et peut être révoquée à tout moment.

Existe-t-il aussi une API classique ?

Oui. Les mêmes données sont disponibles sous forme d’API REST sous /api/v1/..., avec authentification par clé Bearer. La documentation pour développeurs, avec démarrage rapide et exemples, se trouve dans le panel à côté des paramètres des clés.

Connect HerzensManagement to any AI tool

Une connexion, tous les outils d’IA courants.