Hue est sans interface.
Vos agents le pilotent. Nous gardons les données, les règles et les preuves.

Tout ce que Hue fait dans l’application Humonix est aussi un outil que votre assistant IA ou votre code peut appeler : par MCP depuis Claude, ChatGPT, Cursor ou Claude Code, ou par une API REST. Chaque connexion appartient à une entreprise et à une personne, ne voit que ce que permet le rôle de cette personne, et peut lire ou proposer, jamais envoyer, payer, publier ni supprimer.

Ce qui est en service aujourd’hui

Un serveur MCP par entreprise

Une seule adresse pour tous les clients; en vous connectant, vous ouvrez une session dans votre espace Humonix et la connexion est liée à votre entreprise et à vous. OAuth 2.1 avec PKCE (S256) et inscription dynamique des clients, comme le demande la spécification d’autorisation de MCP. Les jetons d’accès durent une heure; les jetons d’actualisation changent à chaque usage, et un jeton réutilisé révoque toute la connexion.

Des portées que vous choisissez

data:read (lire vos dossiers et vos Services), hue:chat (poser des questions à Hue), desks:propose (préparer des brouillons qui attendent votre approbation, propriétaires seulement). La liste d’outils que voit un assistant est filtrée par ces portées et par votre rôle.

Une API REST avec OpenAPI 3.1

POST /api/v1/tools/<nom> avec une clé d’API d’entreprise créée par un propriétaire dans l’application (Développeurs). Une clé agit avec le rôle de la personne qui l’a créée, vérifié à chaque appel; elle cesse de fonctionner si cette personne part. Les propositions acceptent un en-tête Idempotency-Key.

Un catalogue d’outils public

GET /api/v1/tools liste chaque outil avec son type (lecture ou proposition), sa portée, sa permission, son schéma d’entrée et des indications qui aident un agent à choisir : coût, délai habituel, sur quoi repose la réponse, effets. Il décrit la porte, jamais les données de qui que ce soit.

Événements et webhooks

Six sujets : invoice.overdue, job.late, stock.low, quote.expiring, desk_request.needs_human, approval.waiting. Livrés par webhooks signés (HMAC-SHA256 sur l’horodatage et le contenu), relancés d’une minute à 24 heures; ou récupérez la même liste avec l’outil recent_events. Chaque sujet exige la permission de consulter le module.

Rôles, approbations, journal

Les mêmes règles de rôles que dans l’application, à chaque appel. Une proposition ne fait qu’ajouter un brouillon à une file qu’une personne approuve déjà dans l’application. Chaque appel MCP ou API est inscrit au journal d’accès de votre entreprise (personne, assistant ou clé, outil, heure, adresse IP) avant de s’exécuter, et compté par outil; les arguments et les réponses ne sont pas conservés dans ce décompte.

Hébergé en Amérique du Nord

L’application Humonix et sa base de données roulent sur Fly.io à Toronto, au Canada. Ce qu’un assistant lit sort par cet assistant, selon votre compte chez son fournisseur.

Les outils

Plus de 80 outils aujourd’hui. Les principaux groupes : les dossiers de votre entreprise (factures et qui appeler d’abord, travaux et répartition, stocks sous le point de commande, bons de commande, soumissions, marges, tâches, signatures électroniques, l’état des résultats, la fiche complète d’un client), l’espace de travail (vos Services, ce qui attend une approbation, les jeux de données, les pages enregistrées, poser une question à Hue), la file du service (déposer une demande de client pour le service de Hue, ce qui vous attend, ce qui est en retard, une demande en détail) et les événements. Deux types seulement : lecture (ne change rien) et proposition (un brouillon qu’une personne approuve). Le catalogue en direct fait foi :

D’agent à agent (A2A) : confiez des résultats à Hue

Vos agents n’ont pas besoin d’un écran pour confier du travail à Hue. Hue parle A2A, le protocole Agent2Agent désormais sous l’égide de la Linux Foundation (version 1.0, et 0.3 pour les clients plus anciens) : un autre agent lit la carte d’agent de Hue, lui envoie une tâche et reçoit un résultat, pas une page à parcourir.

La carte d’agent

Publique à /.well-known/agent-card.json : les compétences de Hue, le point d’accès JSON-RPC et la façon de s’authentifier. Elle décrit la porte, jamais une entreprise ni ses données. Un agent connecté peut demander la carte détaillée, qui ne liste que les compétences que permettent sa clé et son rôle.

Dix compétences

Répondre à une question sur l’entreprise; répondre à la question d’un client; qualifier une demande entrante; relancer les factures en retard; préparer une soumission; proposer la répartition d’une journée; une recherche; proposer un changement publicitaire; l’état d’une commande en ligne; et appeler par son nom n’importe quel outil du catalogue.

Des résultats, pas des écrans

Les lectures répondent dans l’appel. Le travail devient un brouillon qu’une personne approuve dans l’application, et la tâche reste ouverte, marquée input-required avec qui doit agir et où, jusqu’à ce qu’un résultat existe : la réponse approuvée, les rappels tranchés, la soumission approuvée ou refusée, le rapport accepté. Elle se termine alors avec un résultat : issue, résumé, preuves avec liens, valeur (sommes relancées, soumissions approuvées, rendez-vous pris, travaux planifiés), coût au prix courant et la suite.

Les mêmes règles que MCP et REST

Une clé d’API d’entreprise ou la même connexion OAuth que le serveur MCP; l’entreprise vient toujours de l’identifiant, jamais du message; les mêmes portées et les mêmes rôles; chaque appel au journal d’accès. Rien n’est envoyé, payé ni publié sans une personne.

Des mises à jour que votre agent peut suivre

Interrogez avec GetTask, suivez en continu par événements serveur (SSE) ou inscrivez un webhook de notification par tâche. Les résultats sont aussi offerts par GET /api/v1/results, par l’outil MCP results_recent et par le sujet de webhook signé result.completed.

https://humonix-hq.fly.dev/.well-known/agent-card.json

Confier une tâche à Hue (une clé d’API d’entreprise avec write:proposals) :

curl -X POST https://humonix-hq.fly.dev/api/a2a \
  -H "Authorization: Bearer hxc_…" -H "A2A-Version: 1.0" -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"m1","role":"ROLE_USER","parts":[{"data":{"skill":"chase_overdue_invoices"}}]}}}'

Branchez votre assistant

Il vous faut un espace Humonix. L’assistant vous demande de vous connecter la première fois; vous choisissez les portées. Les mêmes étapes sont dans l’application, sous Développeurs et Connexions.

Paramètres › Connecteurs › Ajouter un connecteur personnalisé, collez l’adresse, puis Connecter et connectez-vous.

https://humonix-hq.fly.dev/api/mcp

Paramètres › Applications et connecteurs › Avancé › Mode développeur, puis Créer, collez l’adresse, authentification OAuth, et connectez-vous.

https://humonix-hq.fly.dev/api/mcp

Ajoutez le serveur, puis lancez /mcp pour vous connecter.

claude mcp add --transport http humonix https://humonix-hq.fly.dev/api/mcp

Paramètres › MCP › Ajouter, puis connectez-vous à la demande.

{ "mcpServers": { "humonix": { "url": "https://humonix-hq.fly.dev/api/mcp" } } }

Avec une clé d’API d’entreprise créée sous Développeurs dans l’application.

curl -X POST https://humonix-hq.fly.dev/api/v1/tools/invoices_overdue \
  -H "Authorization: Bearer hxc_…" -H "content-type: application/json" \
  -d '{"limit": 5}'

L’adresse est aujourd’hui humonix-hq.fly.dev; elle passera à app.humonix.com quand notre changement de DNS sera en place, et nous l’annoncerons dans le journal des changements.

Les règles qui l’encadrent

  • L’entreprise est toujours celle de votre connexion ou de votre clé, jamais un argument d’outil; une demande visant les données d’une autre entreprise ne trouve rien.
  • Aucun outil n’envoie, ne paie, ne commande, ne publie ni ne supprime. Cela reste dans l’application, avec une personne.
  • Le texte de vos dossiers que renvoie un outil est une donnée, pas une instruction, et le serveur le dit à l’assistant.
  • Des limites d’appels par outil et par personne ou par clé, en plus de 300 appels à l’heure par connexion d’assistant.
  • Vos données ne servent jamais à entraîner des modèles partagés. Conçu pour la Loi 25 du Québec et les règles canadiennes de protection des renseignements personnels.

Le Model Context Protocol est une norme ouverte, présentée par Anthropic en novembre 2024, qui permet aux assistants IA de se brancher à des outils et à des données par une interface commune. Comme Humonix la parle, les assistants que votre équipe utilise déjà peuvent travailler avec vos dossiers sans que vous les copiiez dans une conversation.

Pas encore

  • Inscrit au répertoire des connecteurs de Claude ou comme application ChatGPT : pas encore; aujourd’hui, vous ajoutez Humonix comme connecteur personnalisé avec l’adresse ci-dessus.
  • Ressources MCP et abonnements en direct : plus tard. Aujourd’hui, les événements arrivent par webhook ou avec l’outil recent_events.
  • Un choix de rôle par clé d’API : plus tard. Aujourd’hui, une clé agit avec le rôle de la personne qui l’a créée.
  • Inscrit aux répertoires et registres d’agents A2A : pas encore; aujourd’hui, un agent trouve Hue par l’adresse de sa carte d’agent.

Demander l’accès