Aperçu pour développeurs

Serveur MCP Sandtime.io

Le Model Context Protocol (MCP) permet aux clients d'IA comme Claude Code et Codex de communiquer directement avec Sandtime.io. Connectez-vous une fois et créez, consultez et présentez vos saisies de temps depuis les outils que vous utilisez déjà.

Connecter un client Obtenez un accès anticipé gratuit

Qu'est-ce que le MCP ?

Le Model Context Protocol est un standard ouvert pour connecter les assistants d'IA à des outils et des données externes. Le serveur MCP Sandtime.io expose votre espace de suivi du temps - activités, projets, rapports, feuilles de temps et plus encore - sous la forme d'un ensemble d'outils qu'un assistant peut appeler en votre nom.

Les actions de lecture renvoient des données propres et matérialisées, avec des durées et des heures locales formatées. Les actions destructrices, comme la suppression d'un projet ou d'un membre, sont volontairement confiées à un humain via un lien direct vers la bonne page de l'application.

Vous débutez avec l'enregistrement du temps depuis votre éditeur ? Découvrez comment les développeurs utilisent Sandtime.io au quotidien.

Ce que vous pouvez demander

Parlez à votre assistant en langage naturel. Il identifie le bon utilisateur, le bon projet et les bonnes dates, puis appelle les outils à votre place.

Enregistre 8 heures sur le projet Acme pour hier.

Remplis la semaine dernière avec mes heures habituelles et ignore le jour férié.

Qu’ai-je suivi cette semaine, réparti par projet ?

Arrête mon minuteur en cours.

Génère un rapport des heures facturables par client pour le mois dernier.

Quelles semaines sont encore verrouillées sur ma feuille de temps ?

Se connecter avec Claude

Ajoutez le serveur Sandtime.io à la configuration de votre client MCP. Dans Claude Code, elle se trouve dans un fichier .mcp.json :

{
  "mcpServers": {
    "sandtime": {
      "type": "http",
      "url": "https://mcp.sandtime.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "X-Sandtime-Organization": "your-organization"
      }
    }
  }
}

L'authentification est en cours de développement. Aujourd'hui, vous vous authentifiez en copiant votre jeton d'accès depuis le cookie de session Sandtime.io et en le collant comme jeton Bearer, avec l'identifiant (slug) de votre organisation dans l'en-tête X-Sandtime-Organization. Il s'agit d'une étape temporaire - nous lancerons bientôt une véritable procédure de connexion et de gestion des jetons, pour que vous n'ayez plus à toucher aux cookies.

Où ça fonctionne

Un seul serveur HTTP pour tous les outils d'IA que vous utilisez. Connectez-vous une fois et travaillez là où vous êtes déjà.

Claude Code

Ajoutez le serveur à votre fichier .mcp.json et enregistrez votre temps depuis le terminal où vous livrez votre code.

Claude Desktop

Connectez le serveur et demandez à l'application de bureau de suivre et de présenter votre temps.

Codex

Reliez le serveur à Codex et transformez vos sessions de code en enregistrements de temps propres.

N'importe quel client MCP

Tout client compatible avec le Model Context Protocol et prenant en charge les serveurs HTTP avec en-têtes personnalisés peut se connecter.

Outils disponibles

Le serveur expose plus de 30 outils couvrant l'ensemble de votre espace de travail. Les assistants les enchaînent - par exemple en identifiant l'utilisateur actuel, en vérifiant le calendrier, puis en remplissant les jours vides.

Activités

list_activitiesListez les saisies de temps, filtrées par utilisateur, projet ou semaine entière. Renvoie des durées et des heures locales formatées.
get_activityObtenez tous les détails d’une saisie de temps à partir de son identifiant.
create_activityEnregistrez une nouvelle saisie de temps sur un projet, avec détection automatique des chevauchements avec les saisies existantes.
update_activityModifiez le nom, les horaires, le projet ou le statut facturable d'une saisie de temps, ou arrêtez et reprenez un minuteur en cours.
delete_activitySupprimez définitivement une saisie de temps. Nécessite d'en être propriétaire ou de disposer de droits d'administrateur.
stop_activityArrêtez un minuteur en cours en définissant son heure de fin sur maintenant.

Projets

list_projectsListez les projets de votre organisation, en incluant éventuellement les projets archivés.
get_projectObtenez des informations détaillées sur un projet spécifique.
create_projectCréez un nouveau projet. Nécessite des droits d'administrateur.
update_projectRenommez un projet, modifiez son statut facturable par défaut, archivez-le ou modifiez ses notes.
delete_projectRenvoie un lien direct vers les paramètres du projet, où un humain confirme la suppression.

Membres du projet

list_project_membersListez les membres affectés à un projet spécifique.
add_project_memberRenvoie un lien direct vers la section des membres du projet, où un humain ajoute le membre.
remove_project_memberRenvoie un lien direct vers la section des membres du projet, où un humain supprime le membre.

Utilisateurs

list_usersListez les utilisateurs de votre organisation.
get_userObtenez des informations détaillées sur un utilisateur spécifique.
get_current_userObtenez l'identifiant de l'appelant, son fuseau horaire ainsi que la date et la semaine actuelles déterminées par le serveur. Généralement le premier appel d'un flux de travail.
create_userRenvoie un lien direct vers la page d'invitation des membres.
update_userRenvoie un lien direct vers la page de profil de l'utilisateur.

Organisation

get_organizationObtenez des informations sur votre organisation, y compris ses paramètres.
update_organizationRenvoie un lien direct vers la page des paramètres de l’organisation.

Calendrier

get_calendarObtenez un calendrier calculé côté serveur avec les jours ouvrés, les heures attendues, les week-ends et les jours fériés. La source de vérité avant d'enregistrer du temps sur plusieurs jours.

Rapports

list_reportsListez les rapports enregistrés dans votre organisation.
get_reportObtenez les détails d'un rapport spécifique.
create_reportConstruisez un rapport enregistré avec des dimensions, des métriques, des périodes et des filtres de projet ou de membre personnalisés.

Feuilles de temps

get_timesheet_statusVérifiez l'état de verrouillage des feuilles de temps pour une semaine donnée.
lock_timesheetVerrouillez la feuille de temps d'une semaine pour un utilisateur. Nécessite des droits d'administrateur.
unlock_timesheetSupprimez un verrouillage de feuille de temps existant. Nécessite des droits d'administrateur.

Demandes

list_requestsListez les demandes d’approbation telles que les déverrouillages de feuilles de temps et les changements de rôle. Affiche par défaut les demandes en attente.
request_timesheet_unlockDemandez à un administrateur de déverrouiller une semaine verrouillée afin de pouvoir modifier la feuille de temps.
approve_unlock_requestApprouvez une demande de déverrouillage en attente, en accordant à l'utilisateur un court délai pour modifier. Nécessite des droits d'administrateur.
reject_unlock_requestRejetez une demande de déverrouillage en attente. L'utilisateur en est informé.

Synthèse et analyses

get_time_summaryRésumez le temps suivi sur une période, regroupé par jour, semaine, mois, projet ou utilisateur.

Essayez gratuitement les fonctionnalités d'IA

Le serveur MCP et Sandbot sont gratuits pour les organisations éligibles pendant l'accès anticipé. Parlez-nous de votre équipe et nous les activerons.

Voir l'offre d'accès anticipé