Valoon pour Claude
Français

Documentation du connecteur

Valoon pour Claude

Valoon pour Claude permet à Claude de lire et de mettre à jour vos projets Valoon : tickets, rapports journaliers, fichiers, photos de chantier et saisies de temps. Il fonctionne comme serveur MCP officiel exploité par Valoon GmbH.

https://dev.mcp.valoon.crucerlabs.com/mcp

Sélectionnez l'URL et collez-la dans Claude lorsque vous ajoutez un connecteur personnalisé.

Sur cette page

Vue d’ensemble

Le connecteur donne à Claude accès à vos projets Valoon via le Model Context Protocol. Claude ne voit que ce que votre propre compte Valoon peut voir, et chaque modification qu’il effectue est faite avec votre compte.

Les usages typiques : résumer ce qui s’est passé sur un chantier cette semaine, transformer des notes de chantier en tickets, rédiger le rapport journalier à partir de photos et de notes de chantier, et vérifier les heures saisies avant la paie.

Avant de commencer

  • Un compte Valoon ayant accès aux projets sur lesquels vous voulez travailler.
  • Une clé API Valoon. Vous trouverez son Client ID et son Secret dans Valoon → Paramètres → Clés API.
  • Un forfait Claude qui prend en charge les connecteurs personnalisés.
  • Avec les forfaits Team et Enterprise, un propriétaire doit parfois autoriser les connecteurs personnalisés dans Paramètres de l’organisation → Connecteurs.

Connecter Valoon à Claude

Claude.ai et Claude Desktop

  1. Ouvrez Paramètres → Connecteurs et choisissez Ajouter un connecteur personnalisé.
  2. Saisissez Valoon comme nom et collez l’URL du connecteur : https://dev.mcp.valoon.crucerlabs.com/mcp
  3. Sélectionnez Connecter. La page d’autorisation de Valoon s’ouvre.
  4. Saisissez le Client ID et le Secret de votre clé API Valoon, puis sélectionnez Autoriser l’accès.
  5. De retour dans Claude, activez depuis le menu des outils les outils Valoon que vous voulez utiliser dans la conversation.

Claude Code

Ajoutez le serveur depuis votre terminal :

claude mcp add --transport http valoon https://dev.mcp.valoon.crucerlabs.com/mcp

Exécutez ensuite /mcp dans Claude Code, sélectionnez Valoon et authentifiez-vous. Votre navigateur ouvre la même page d’autorisation. Une fois l’accès autorisé, Valoon apparaît comme connected.

Autorisations et données

Chaque outil porte l’une de trois étiquettes, que le serveur transmet à Claude avec chaque outil, afin que Claude distingue les lectures des modifications. Selon vos paramètres Claude, Claude vous demande de confirmer avant d’exécuter un outil.

Étiquette Ce que fait l’outil Exemple
Lecture Lit des données. Rien ne change dans Valoon. list_tickets
Écriture Crée, met à jour ou déplace des données dans Valoon. create_report
Envoie des messages Lance une conversation Valoon avec les participants d’un ticket. send_ticket

Les messages atteignent de vraies personnes

Les outils étiquetés Envoie des messages écrivent en votre nom aux participants du ticket, et un message envoyé ne peut pas être annulé. Vérifiez quels tickets Claude veut envoyer avant de confirmer. La création ou la mise à jour de projets et de tickets envoie aussi les mêmes notifications que l’application Valoon.

Vous vous connectez avec votre clé API Valoon. Le Client ID et le Secret sont vérifiés auprès de l’API Valoon et ne sont jamais stockés sur le serveur. Claude reçoit un jeton d’accès valable une heure, renouvelé avec un jeton d’actualisation valable 30 jours et remplacé à chaque utilisation.

Claude ne reçoit que les résultats des outils qu’il appelle. Pour l’exploitation, le serveur journalise pour chaque appel le nom de l’outil, votre Client ID, l’application Claude, la durée et le statut du résultat, mais ni ses arguments ni sa réponse.

Exemples de requêtes

  • « Résume tous les défauts ouverts au Schillerstraße 12 et regroupe-les par corps de métier. »
  • « Crée des tickets à partir de ces notes de chantier et ajoute l’équipe de Hoffmann Elektro comme participants. »
  • « Rédige le rapport journalier d’aujourd’hui pour JACTESP à partir des photos envoyées ce matin. »
  • « Quels membres de l’équipe ont saisi plus de 10 heures sur une journée la semaine dernière ? »

Une routine qui fonctionne bien : demandez chaque vendredi à Claude un résumé de chantier par projet. Il lit les tickets et les rapports de la semaine et fournit au chef de projet un état d’une page.

Outils

Les outils sont regroupés par domaine. Les groupes sont repliés pour garder la liste courte ; ouvrez-en un pour voir ses outils. Les noms et les descriptions des outils sont en anglais, et ce sont les noms que Claude utilise lorsqu’il appelle un outil.

LectureÉcritureEnvoie des messages
Essentiel1 outilVotre compte connecté
  • Who Am Iwhoami

    Returns the currently authenticated user. Use this to identify who is making the request.

    Lecture
Projets7 outilsProjets, historique et statistiques
  • Create Projectcreate_project

    Create a new Project.

    Écriture
  • Get All Project Statisticsget_all_project_statistics

    Get statistics across all projects.

    Lecture
  • Get Projectget_project

    Get a Project by id.

    Lecture
  • Get Project Historyget_project_history

    Get the full event history of a project.

    Lecture
  • Get Project Statisticsget_project_statistics

    Get statistics for a specific project.

    Lecture
  • List Projectslist_projects

    List Projects.

    Lecture
  • Update Projectupdate_project

    Update an existing Project by id.

    Écriture
Tickets23 outilsTickets, étiquettes, périmètres et paramètres de flux
  • Add Ticket Labelsadd_ticket_labels

    Add labels to a ticket.

    Écriture
  • Add Ticket Participantsadd_ticket_participants

    Add users to a ticket as participants.

    Écriture
  • Create Labelcreate_label

    Create a new Label.

    Écriture
  • Create Scopecreate_scope

    Create a new Scope.

    Écriture
  • Create Ticketcreate_ticket

    Create a new Ticket.

    Écriture
  • Dispatch Ticketdispatch_ticket

    Start the ticket conversation with every participant of one ticket.

    Envoie des messages
  • Duplicate Ticketduplicate_ticket

    Copy a ticket, optionally into another project or under a new title.

    Écriture
  • Get Labelget_label

    Get a Label by id.

    Lecture
  • Get Scopeget_scope

    Get a Scope by id.

    Lecture
  • Get Ticketget_ticket

    Get a Ticket by id.

    Lecture
  • Get Ticket Historyget_ticket_history

    Get the full event history of a ticket.

    Lecture
  • Get Ticket Flow Settingget_ticketflowsetting

    Get a TicketFlowSetting by id.

    Lecture
  • List Labelslist_labels

    List Labels.

    Lecture
  • List Scopeslist_scopes

    List Scopes.

    Lecture
  • List Ticketslist_tickets

    List Tickets.

    Lecture
  • Move Ticketmove_ticket

    Move a ticket to a different project.

    Écriture
  • Remove Ticket Labelsremove_ticket_labels

    Remove labels from a ticket.

    Écriture
  • Remove Ticket Participantsremove_ticket_participants

    Remove users from a ticket's participants.

    Écriture
  • Send Ticketsend_ticket

    Start the ticket-list conversation with every participant of the listed tickets.

    Envoie des messages
  • Update Labelupdate_label

    Update an existing Label by id.

    Écriture
  • Update Scopeupdate_scope

    Update an existing Scope by id.

    Écriture
  • Update Ticketupdate_ticket

    Update an existing Ticket by id.

    Écriture
  • Update Ticket Flow Settingupdate_ticketflowsetting

    Update an existing TicketFlowSetting by id.

    Écriture
Rapports14 outilsRapports, modèles et exports PDF
  • Create Reportcreate_report

    Create a new report from a template, either in a project (projectId) or linked to a ticket (ticketId, which places it in the ticket's project). Pass exactly one of the two.

    Écriture
  • Duplicate Reportduplicate_report

    Duplicate an existing report. Returns the new copy.

    Écriture
  • Get Reportget_report

    Get a report by id, including its form data and state.

    Lecture
  • Get Report PDFget_report_pdf

    Generate and download the PDF of a report.

    Lecture
  • Get Report Templateget_report_template

    Get a report template by id, optionally a specific version. Includes the form structure.

    Lecture
  • Get Reports by Ticketget_reports_by_ticket

    List all reports linked to a specific ticket.

    Lecture
  • List Export Templateslist_exporttemplates

    List ExportTemplates.

    Lecture
  • List Report Labelslist_report_labels

    List the tenant's report labels (such as Open, In Progress, Approved and Invoiced), ordered by their sort order.

    Lecture
  • List Report Templateslist_report_templates

    List all report templates of the tenant.

    Lecture
  • List Reportslist_reports

    List reports, filtered and sorted on the server; newest report date first by default.

    Lecture
  • Move Reportmove_report

    Move a report to another project.

    Écriture
  • Set Report Labelset_report_label

    Set a report's label, or clear it with labelId none. Works in every report state, finalized reports included: the label is workflow metadata, not report content.

    Écriture
  • Set Report Ticketset_report_ticket

    Link a report to a ticket, or unlink it from its ticket with ticketId none.

    Écriture
  • Update Reportupdate_report

    Update a report's title, date, state or form data.

    Écriture
Fichiers et médias21 outilsDossiers, fichiers, photos et scans
  • Copy Filescopy_files

    Copy files and/or folders into a target folder.

    Écriture
  • Create Foldercreate_folder

    Create a new Folder.

    Écriture
  • Create Scan Typecreate_scantype

    Create a new ScanType.

    Écriture
  • Get Attachmentget_attachment

    Get a Attachment by id.

    Lecture
  • Get Fileget_file

    Get a File by id.

    Lecture
  • Get Folderget_folder

    Get a Folder by id.

    Lecture
  • Get Folder Childrenget_folder_children

    List the contents (subfolders and files) of a folder.

    Lecture
  • Get Folder Parentsget_folder_parents

    Get the parent folders (ancestor chain) of a folder.

    Lecture
  • Get Mediaget_media

    Download the media (photo, document) attached to an entity, returned inline so images are directly visible.

    Lecture
  • Get Scanget_scan

    Get a Scan by id.

    Lecture
  • Get Scan Typeget_scantype

    Get a ScanType by id.

    Lecture
  • List Attachmentslist_attachments

    List Attachments.

    Lecture
  • List Fileslist_files

    List Files.

    Lecture
  • List Folderslist_folders

    List Folders.

    Lecture
  • List Photo Gallerylist_photogallery

    List PhotoGallery.

    Lecture
  • List Scanslist_scans

    List Scans.

    Lecture
  • List Scan Typeslist_scantypes

    List ScanTypes.

    Lecture
  • Move Filesmove_files

    Move files and/or folders into a target folder.

    Écriture
  • Update Folderupdate_folder

    Update an existing Folder by id.

    Écriture
  • Update Scanupdate_scan

    Update an existing Scan by id.

    Écriture
  • Update Scan Typeupdate_scantype

    Update an existing ScanType by id.

    Écriture
Suivi du temps8 outilsSaisies de temps et types de temps
  • Create Time Entrycreate_timeentry

    Create a new TimeEntry.

    Écriture
  • Get Time Entryget_timeentry

    Get a TimeEntry by id.

    Lecture
  • Get Time Entry Historyget_timeentry_history

    Get the full event history of a time entry.

    Lecture
  • Get Time Typeget_timetype

    Get a TimeType by id.

    Lecture
  • List Time Entrieslist_timeentries

    List TimeEntries.

    Lecture
  • List Time Typeslist_timetypes

    List TimeTypes.

    Lecture
  • Update Time Entryupdate_timeentry

    Update an existing TimeEntry by id.

    Écriture
  • Update Time Typeupdate_timetype

    Update an existing TimeType by id.

    Écriture
Administration10 outilsUtilisateurs, groupes et paramètres de l'organisation
  • Create Groupcreate_group

    Create a new Group.

    Écriture
  • Get Groupget_group

    Get a Group by id.

    Lecture
  • Get Tenantget_tenant

    Get a Tenant by id.

    Lecture
  • Get Userget_user

    Get a User by id.

    Lecture
  • List Groupslist_groups

    List Groups.

    Lecture
  • List Tenantslist_tenants

    List Tenants.

    Lecture
  • List Userslist_users

    List Users.

    Lecture
  • Update Groupupdate_group

    Update an existing Group by id.

    Écriture
  • Update Tenantupdate_tenant

    Update an existing Tenant by id.

    Écriture
  • Update Userupdate_user

    Update an existing User by id.

    Écriture

Dépannage

La page d’autorisation se ferme sans connecter

Votre navigateur bloque peut-être la fenêtre pop-up. Autorisez les pop-ups pour claude.ai, puis sélectionnez à nouveau Connecter.

« Impossible de vérifier vos identifiants »

Le Client ID ou le Secret est incorrect, ou la clé API n’existe plus. Copiez-les à nouveau depuis Valoon → Paramètres → Clés API et réessayez.

Claude indique qu’un projet n’existe pas

Claude ne voit que les projets auxquels votre compte Valoon a accès. Demandez à Claude d’appeler list_projects pour les afficher. Si le projet manque, demandez à un propriétaire du projet de vous ajouter.

Un outil d’écriture renvoie « forbidden »

Votre rôle Valoon ne permet pas cette action sur le projet. Demandez à un propriétaire du projet de modifier votre rôle, ou formulez la demande en lecture seule.

Confidentialité et support

Pour vous déconnecter, supprimez le connecteur dans les paramètres de Claude. Pour révoquer complètement l’accès, supprimez la clé API dans Valoon, dans Valoon → Paramètres → Clés API ; tout appel effectué avec elle échoue dès lors.

Consultez la politique de confidentialité et les conditions. Pour obtenir de l’aide, écrivez à support@valoon.chat en indiquant l’heure de la requête qui a échoué.