Les tools MCP de Hoshin Kanri
Un agent IA branché sur Hoshin travaille sur votre X-Matrix au moyen d’une liste fixe de tools, servie par le serveur MCP à l’adresse ci-dessous. La liste de cette page est lue dans les définitions du serveur lui-même : c’est exactement ce que voit votre agent. Trois façons de la lire, selon qui vous êtes.
https://hoshin.app/mcp
Pour la direction générale et la direction des opérations : ce que vous pouvez demander
Vous n’appelez jamais un tool vous-même. Vous demandez, et l’agent choisit les tools. Quelques demandes, et ce qui se passe derrière :
- « Où en est-on avant le comité de jeudi ? »
- L’état de la matrice, et ce qui est dû avant la revue : indicateurs sans leur dernier relevé, chantiers sans mise à jour, actions en retard.
- get_matrix_summaryget_agenda
- « Quels chantiers ne servent aucun objectif ? »
- Le score de complétude nomme les chantiers orphelins, les objectifs qu’aucun chantier ne sert et les chaînes qui s’arrêtent avant un indicateur.
- get_matrix_completeness
- « Depuis quand cet indicateur est-il hors cible ? »
- Chaque indicateur arrive avec ses derniers relevés, leur période, leur source, et si la période est close.
- get_matrix_data
- « Prépare la revue du mois, puis consigne ce qu’on a décidé. »
- L’agent consigne les décisions telles que vous les avez dites, avec l’état de la matrice à ce moment-là. Il ne décide jamais.
- schedule_reviewget_matrix_datarecord_review
- « Le site de Lyon reprend-il bien nos objectifs ? »
- Quels objectifs du groupe chaque matrice de site décline, et ceux que personne n’a repris en dessous.
- get_cascade
- « Fais-moi la X-Matrix pour le conseil, sans les chiffres. »
- Une image pour le support, ou la matrice affichée dans la conversation. La lecture externe retire les éléments internes, les valeurs et les noms.
- export_matrix_imageshow_matrix
L’agent propose, le comité décide : cibles, percées et arbitrages restent à vous.
Pour les responsables lean : les tools par étape du cycle
Le hoshin kanri tourne comme un Plan-Do-Check-Act annuel appliqué à la politique elle-même. Le classement ci-dessous est le nôtre ; les tools sont ceux du serveur.
Plan : construire la politique
La X-Matrix, ses corrélations, les définitions d’indicateurs, les fiches chantier, la cascade et les cadences de revue. Le score montre ce qui manque.
create_matrixupsert_elementset_correlationset_kpi_definitionupsert_initiative_sheetset_matrix_parentupsert_cadenceget_matrix_completenessget_cascade
Do : déployer et suivre
Lire la matrice, consigner relevés et avancement, déposer les idées du terrain dans la boîte à idées de la stratégie.
list_matricesget_matrix_summarylist_objectivesget_matrix_dataupdate_element_statusadd_ideasearch_ideaslist_members
Check : revoir
Ce qui est dû avant la prochaine revue, les revues elles-mêmes avec leurs décisions, et l’instance où un sujet doit être traité.
get_agendaschedule_reviewrecord_reviewget_reviewdiagnose_theme_deploymentget_management_architecturesuggest_meeting_for_topic
Act : ajuster
Trier la boîte à idées, retirer ce qui ne sert plus. Supprimer une matrice demande son nom exact.
Présenter et partager
La matrice dans la conversation, en image, ou en page publique en lecture seule.
La connexion elle-même
Au nom de qui l’agent agit, le manuel intégré, et comment il signale ce qui lui manque au lieu d’improviser.
Pour la DSI : droits, écritures, flux de données
17 tools ne font que lire, 11 écrivent, 6 peuvent retirer quelque chose. Chaque tool le déclare dans ses annotations MCP : un client peut laisser les membres lire librement et soumettre les écritures à approbation.
- Une connexion n’a jamais plus de droits que la personne qui l’a ouverte. Par OAuth (claude.ai, Cursor, Desktop), l’agent agit au nom de la personne qui a consenti, dans la limite des scopes mcp:read et mcp:write et de son rôle. Un jeton d’API (hk_…) est créé par un admin, agit au nom de cet admin, et se limite à la lecture ou à la lecture et l’écriture.
- Un seul tool publie hors de l’organisation : share_matrix, une page publique en lecture seule, révocable, derrière un jeton haché. Les éléments marqués internes n’y arrivent jamais, ni leurs corrélations ; le lien peut aussi être créé sans les chiffres.
- Chaque tool appelle l’API REST de Hoshin avec le crédential de l’appelant (le contrat est public, voir la page développeurs). Hoshin ne se connecte à aucun autre système : votre agent compose avec les serveurs MCP de votre ERP, de votre GED qualité ou de votre outil de projet, sous leurs propres droits.
- Inviter un membre reste un geste humain, dans l’application : aucun tool ne le fait.
- Une session MCP appartient au crédential qui l’a ouverte ; les origines navigateur sont vérifiées, les corps de requête et les lots sont bornés. Le serveur parle les révisions MCP 2025-11-25 et 2026-07-28.
- Un journal d’audit côté serveur trace les opérations sensibles. Il n’est pas encore exposé aux clients, et deux agents qui partagent une connexion n’y sont pas distingués.
- Les mêmes tools tournent en mode local, la matrice en fichiers JSON sur votre machine, sans rien nous envoyer ; share_matrix y est refusé. Le serveur est open source (MIT) : chaque tool se lit dans le code.
Tous les tools
Générée à partir des définitions du serveur. La description est la première phrase de celle que lit l’agent, en anglais ; un astérisque marque un paramètre obligatoire.
| Tool | Nature | Ce qu’il fait | Paramètres |
|---|---|---|---|
| add_idea | Écriture | Add a new idea to the Hoshin Kanri inbox. | title*, description, priority, source, tags, linked_element_id, links |
| update_idea | Écriture | Triage an idea of the inbox: change its status (accept, reject, mark implemented), its priority, or link it to the matrix element it serves. | idea_id*, status, priority, linked_element_id, title, description, links |
| list_matrices | Lecture | List the X-Matrices of the organization: id, name, whether it is the default one, its parent matrix in a cascade (group → business unit → site), and its size. | include_archived |
| list_objectives | Lecture | List the elements of the X-Matrix: objectives, initiatives and KPIs with their status, target and current value. | matrix_id, quadrant, status |
| get_matrix_summary | Lecture | Get a summary of an X-Matrix: element counts per quadrant, key correlations, and the ideas inbox. | matrix_id, include_correlations |
| update_element_status | Écriture | Update the status, progress or measured value of a matrix element (objective, initiative or KPI), or log a comment. | element_id*, status, progress, current_value, period, notes, origin_tool, origin_ref, extracted_at, external_ref |
| search_ideas | Lecture | Search through the ideas inbox with filters for status, priority, tags, or text search. | query, status, priority, tags, limit |
| get_matrix_completeness | Lecture | Analyze X-Matrix completeness and get AI-friendly score. | matrix_id |
| get_matrix_data | Lecture | Get the COMPLETE dataset of an X-Matrix in one call. | matrix_id, audience |
| share_matrix | Peut retirerpublie à l’extérieur | Publish a matrix as a public read-only web page and return the tokenized link — or list/revoke existing share links. | action, matrix_id, share_id, label, expires_in_days, full_sheets, hide_figures |
| get_management_architecture | Lecture | Returns the complete management system architecture - all meeting cadences organized by hierarchy level (strategic, tactical, operational_mgmt, team_mgmt, execution). | aucun |
| diagnose_theme_deployment | Lecture | Analyze if a strategic theme is properly deployed from vision down to operational meetings. | theme_id, theme_name |
| suggest_meeting_for_topic | Lecture | Recommend the right meeting level and cadence for a given topic based on its nature and the X-Matrix quadrant it relates to. | topic*, element_id |
| get_agenda | Lecture | Where the organization stands in its review cycle, and what is due. | since, horizon_days, matrix_id |
| schedule_review | Écriture | Schedule a review (a meeting instance) of a cadence: a monthly review, a quarterly review, a catchball round. | cadence_id*, date*, matrix_id |
| record_review | Écriture | Record a review that was held. | review_id*, notes, decisions, discussed_element_ids, held_on |
| create_matrix | Écriture | Create a new X-Matrix. | name*, description, period_type, period_start, period_end, is_default, parent_matrix_id |
| upsert_element | Écriture | Create an X-Matrix element, or update one when element_id is given. | matrix_id, element_id, quadrant, title, description, status, target_value, current_value, unit, indicator_type, external_ref, links, owner_id, due_date, parent_element_id, visibility |
| get_cascade | Lecture | Read the multi-level deployment below a matrix (group → business units → sites). | matrix_id |
| set_matrix_parent | Peut retirer | Attach an existing matrix under the matrix of the level above (business unit under group, site under business unit), or detach it with an empty parent_matrix_id. | matrix_id*, parent_matrix_id* |
| set_correlation | Peut retirer | Wire two elements of adjacent quadrants together, or unwire them with strength "none". | matrix_id, from_element_id*, to_element_id*, strength* |
| show_matrix | Lecture | Show the X-Matrix to the person, in the conversation. | matrix_id, audience, orientation, lang |
| get_review | Lecture | Read a recorded review. | review_id* |
| upsert_cadence | Écriture | Create a review cadence (a monthly committee, a quarterly review, a weekly stand-up), or change one when cadence_id is given. | cadence_id, name, type, frequency, operational_level, primary_quadrant, tracked_quadrants, duration_minutes, scope_description, parent_cadence_id |
| upsert_initiative_sheet | Écriture | Fill or change the sheet of an initiative (south element): what a committee reads in two minutes, no task management. | element_id*, sponsor, why, expected_result, measured_by, milestones, next_action, health, health_note, blockers, resources |
| set_kpi_definition | Écriture | Define a KPI (west element): how its value is computed, in which system and where it is read, who answers for the number, how often a reading is due. | element_id*, formula, source_system, source_ref, data_owner, frequency |
| list_members | Lecture | The directory of the organization: the active members, with their id and name. | aucun |
| archive_matrix | Peut retirer | Archive a matrix (archived: true, the default) or bring it back (archived: false). | matrix_id*, archived |
| delete_matrix | Peut retirer | Delete a matrix for good, with its elements, correlations, KPI readings, update logs and public share links; matrices below it in the cascade are detached. | matrix_id*, confirm_name* |
| delete_element | Peut retirer | Delete an element (objective, initiative or KPI) created by mistake or duplicated, with its correlations, KPI readings and update log; elements of lower matrices that deployed it keep their place but lose that link. | element_id* |
| export_matrix_image | Lecture | Draw the X-Matrix as an SVG picture for a deck or a report: the four bands, the correlation marks in the corners, the completeness score. | matrix_id, audience, lang, layout, orientation, format |
| whoami | Lecture | Call it first in a session, then list_matrices and get_agenda; read before you write. | aucun |
| get_help | Lecture | The manual of this server. | topic |
| report_missing_capability | Écriture | Tell the Hoshin Kanri team that you needed something this server does not do: a tool, a field, a filter, a right. | capability*, use_case, feature |