Documentation

Trois parcours de lecture : utiliser Historis, connecter votre assistant, ou plonger dans la référence développeur

Parcours de lecture

Utiliser Historis

Suivre vos contacts et vos événements au quotidien. Sans IA.

Connecter votre assistant

Votre assistant consulte votre historique et note pour vous ; ce qu'il écrit est marqué ◆.

Référence développeur

Toute la profondeur technique : le protocole MCP, les outils, les webhooks et l'authentification.

01Utiliser Historis

Suivre vos contacts et vos événements au quotidien. Sans IA.

Démarrage rapide

Créez votre compte et commencez en quelques minutes

Créer un compte

Inscription gratuite, aucune carte bancaire requise.

Créer votre premier événement

Décrivez ce qui s'est passé. Historis organise le reste.

Connecter votre assistant

Optionnel : connectez votre assistant, il peut noter pour vous.

Créer un compte

Concepts clés

Les briques fondamentales d'Historis

Événements

L'unité de base. Un événement contient du texte libre, un statut (ouvert, en cours, fermé), une date d'échéance et une date de relance. C'est votre mémoire de travail.

Personnes

Vos contacts : clients, fournisseurs, partenaires. Chaque personne a un nom, téléphone, email et notes. Liez-les aux événements pour construire un historique.

Statuts

Cycle de vie : Ouvert → En cours → Fermé. Ajoutez une résolution quand vous fermez. Filtrez par statut pour voir ce qui reste à faire.

Équipes

Organisez vos membres en équipes. Les équipes sont la base du contrôle de visibilité — restreignez qui peut voir certains événements et contacts. Le plan Free inclut une équipe ; les plans payants sont illimités.

Visibilité

Contrôlez qui voit quoi. Chaque événement et contact a un niveau de visibilité : Organisation (tout le monde), Équipes (uniquement les équipes assignées), ou Privé (vous seul). Définissez la visibilité lors de la création ou modification.

Règles

Des instructions en langage naturel enregistrées pour toute votre organisation. Historis les indexe ; l'assistant que vous connectez retrouve la règle pertinente et l'applique, marquée ◆, jamais exécutée côté serveur.

02Connecter votre assistant

Votre assistant consulte votre historique et note pour vous ; ce qu'il écrit est marqué ◆.

Connecter votre assistant

Votre assistant consulte votre historique et note pour vous

Historis fonctionne entièrement sans IA. Mais si vous utilisez déjà un assistant comme Claude ou ChatGPT, vous pouvez le connecter : il consulte votre historique pour vous faire le récap, et y note des choses pour vous. Tout ce qu'il écrit est marqué ◆, la marque des entrées ajoutées par un assistant : daté, signé, corrigeable. Vous choisissez ce que chaque assistant peut lire ou écrire, et chacune de ses actions apparaît dans le journal des actions.

URL du serveur MCP

https://api.historis.app/mcp

Claude Desktop

Ajoutez ce bloc dans votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "historis": {
      "url": "https://api.historis.app/mcp"
    }
  }
}

ChatGPT

Dans les paramètres ChatGPT → MCP Servers → Add Server. Collez l'URL ci-dessus et autorisez via OAuth.

Cursor

Dans Settings → MCP → Add server. Même configuration JSON que Claude Desktop.

Règles

Des instructions réutilisables que votre assistant applique

Une règle est une courte instruction écrite en langage naturel, enregistrée une fois pour toute votre organisation. Historis stocke et indexe vos règles mais ne les exécute jamais lui-même : quand votre assistant travaille sur quelque chose qui correspond, il retrouve la règle pertinente et l'applique, en marquant son action d'un ◆. Comme les règles vivent au niveau de l'organisation, l'assistant de chaque membre suit le même mode d'emploi.

Comment ça marche

Chaque règle est indexée par mots-clés et par les personnes qu'elle mentionne : votre assistant la fait remonter exactement quand elle est pertinente, pas à chaque événement.
Les règles sont enregistrées au niveau de l'organisation : elles s'appliquent à toute votre équipe. Écrivez une convention une fois, l'assistant de chacun la suit.
Votre assistant lit la règle et agit : taguer, lier, router, poser un suivi. Chaque changement qu'il effectue est marqué d'un ◆ pour distinguer son travail du vôtre.
Historis n'exécute jamais une règle de lui-même. Rien ne se passe côté serveur et aucun événement n'est modifié à votre insu ; les règles ne font que guider l'assistant que vous connectez.

Apprenez à votre assistant, et laissez-le s'améliorer

Dites-le simplement à votre assistant dans la conversation : « Désormais, classe tout ce qui vient d'un fournisseur sous #revente. » Demandez-lui d'en faire une règle et c'est intégré au mode d'emploi.
Il a mal tagué ou routé quelque chose au mauvais endroit ? Dites-lui ce qui n'allait pas et demandez-lui de consigner la règle. La prochaine fois, pour vous ou n'importe quel membre, il s'y prendra bien.
Vous pouvez aussi écrire les règles vous-même en markdown depuis la page Règles. Pas de syntaxe particulière, aucune condition à configurer : une phrase claire suffit.

Exemples de règles

Tout ce qui ressemble à une facture ou un devis → taguer #comptabilité et lier le fournisseur.

Les événements tagués #réparation → affecter à l'atelier et poser un suivi à 3 jours.

Quand un contact est un revendeur, taguer ses commandes #revente et appliquer les notes de tarif revendeur.

Pour tout contact professionnel, toujours enregistrer d'abord la société, puis l'individu, puis la relation entre eux.

Tout ce qui implique un client VIP → le signaler pour qu'il remonte en tête du brief quotidien.

03Référence développeur

Toute la profondeur technique : le protocole MCP, les outils, les webhooks et l'authentification.

Référence MCP Tools

Tous les outils disponibles pour votre agent

Contexte & briefing

Outil	Description
get_organization_context	Briefing de démarrage : organisation, membres, équipes, tags fréquents, statistiques, activité récente
manage_organization	Écrire le contexte de l'organisation via action : set_description (org), set_team_context (équipe), set_member_context (membre, propriétaire uniquement)
get_daily_brief	Brief du matin : événements en retard, échus aujourd'hui, à venir et dormants en un seul instantané structuré
get_person_context	Contexte complet d'une personne : identité, tags, événements ouverts, historique récent, statistiques de synthèse

Événements

Outil	Description
create_event	Capturer un événement : texte libre, tags, personnes, échéances, idempotent sur les identifiants de source externes
search_events	Rechercher et filtrer les événements : texte, statut, tags, personne, dates, échéances (due_before, due_today)
manage_event	Opérations sur un événement via action : get, update, delete, add_update, link_events, link_person, thread, batch_update_status, close_loop
bulk_create_events	Import par lot de 50 événements maximum depuis un tableau JSON, idempotent par (source_type, source_id)

Personnes

Outil	Description
search_persons	Découvrir des contacts par recherche plein-texte sur tous leurs champs (insensible aux accents) et via le graphe de relations : filtrer par type et par rôle des contacts liés (with_role / without_role)
search_or_create_person	Trouver une personne par son nom (éventuellement par email), la créer si absente, mettre à jour ses tags
bulk_create_persons	Création par lot de 50 contacts maximum depuis un tableau JSON, en ignorant les doublons par email
manage_person	Opérations sur une personne via action : update (nom, coordonnées, notes, tags, visibilité), delete
manage_relationship	Liens contact à contact via action : list, create, update (note), delete

Outil	Description
manage_tags	Opérations sur les tags via action : list (par utilisation), analyze_duplicates, merge

Règles

Outil	Description
find_applicable_rules	Prévisualiser quelles règles actives correspondraient à un brouillon d'événement avant de le créer
manage_rules	Opérations sur les règles via action : list, get, create, update, toggle, delete, test (dry-run), executions

Connaissances

Outil	Description
search_knowledge	Recherche des notes de connaissance : plein-texte toujours (français, insensible aux accents), branche sémantique fusionnée aux résultats plein-texte avec un embedding de requête, filtres par tag, statut, contact ou événement
manage_knowledge	Notes de connaissance durables via action : get, create, update, archive, link, unlink, supersede — taguées decision/reflection/observation et liées aux contacts et événements concernés

Focus — le brief quotidien

get_daily_brief

L'outil le plus différenciant. Un seul appel renvoie un instantané structuré de tout ce qui demande votre attention : retards, échéances du jour, ce qui arrive, et les événements ouverts dormants. Votre agent en fait un briefing du matin.

Exemple de prompt

"Qu'est-ce qui s'est passé, qu'est-ce que je dois savoir, qu'est-ce qui doit être traité aujourd'hui ?"

Réponse typique

Deux choses sont en retard : le devis pour Martin (échu vendredi) et le rappel fournisseur. À traiter aujourd'hui : le suivi de livraison de la commande Dupont. Cette semaine : le réassort de l'atelier. Par ailleurs, 3 événements ouverts n'ont pas bougé depuis plus d'une semaine — je vous les liste ?

Webhooks entrants

Laissez vos autres applications pousser des événements dans Historis automatiquement.

Un webhook entrant est une URL sur laquelle envoyer des requêtes POST. Dès qu'il se passe quelque chose dans un autre outil — un paiement, un formulaire rempli, une affaire conclue — cet outil envoie un petit payload JSON à votre URL de webhook et Historis le transforme en événement. Aucun code requis côté Historis.

Créez un endpoint

Dans Réglages -> Webhooks, cliquez sur Nouvel endpoint (Pro ou Business) et donnez-lui un nom comme « Paiements Stripe ».

Copiez l'URL et le token

Historis affiche l'URL de l'endpoint et un token secret une seule fois. Conservez le token en lieu sûr — il n'est montré qu'à la création.

Envoyez vos événements

Pointez votre application (ou Zapier / Make / n8n) vers l'URL avec le token dans l'en-tête Authorization. Chaque requête crée un événement.

Exemple de requête

curl -X POST https://api.historis.app/api/webhooks/ingest/YOUR_ENDPOINT_ID \
  -H "Authorization: Bearer whk_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pi_3abc123" \
  -d '{
    "content": "Payment received — 450 EUR",
    "status": "open",
    "tags": ["payment"],
    "person": { "name": "Pierre Dupont", "email": "pierre@example.com" },
    "metadata": { "external_id": "pi_3abc123", "source": "stripe" }
  }'

Seul content est obligatoire. status, tags, person (name, email) et metadata sont optionnels — une personne est rapprochée par email, ou créée automatiquement.
Idempotence : envoyez un en-tête Idempotency-Key (ou metadata.external_id) pour qu'une livraison rejouée soit dédupliquée au lieu de créer un second événement.
Le token est un secret : envoyez-le en HTTPS dans l'en-tête Authorization, jamais dans l'URL. Révoquez un endpoint à tout moment pour le couper instantanément.
Fonctionne avec tout système capable d'envoyer du JSON en POST — Zapier, Make, n8n, ou votre propre backend.

Authentification

Comment l'accès fonctionne

OAuth 2.1

OAuth 2.1 avec PKCE — le flux standard pour les agents MCP. L'autorisation est automatique : votre agent vous demandera d'approuver l'accès la première fois.

Tokens API

Pour les intégrations directes, créez un token dans Paramètres → Tokens API. Le token est affiché une seule fois.

FAQ

Comment créer un événement depuis mon assistant ?

Dites simplement à votre assistant : "Crée un événement dans Historis : réunion avec Jean pour le devis site web". Il note l'événement pour vous, marqué ◆.

Mon assistant n'applique pas une règle

Les règles ne sont pas exécutées par Historis : votre assistant en applique une quand il trouve une correspondance pertinente. Vérifiez que la règle est active et que ses mots-clés (ou les personnes liées) correspondent à ce sur quoi vous travaillez, puis demandez à votre assistant de chercher les règles applicables.

Comment trouver les événements en retard ?

Demandez à votre assistant : "Qu'est-ce qui doit être traité aujourd'hui ?". Il vous fait le récap du jour : événements en retard, échus aujourd'hui, à venir et dormants, en une seule fois. Les filtres d'échéance pour une recherche ciblée sont couverts dans la référence développeur ci-dessous.

L'authentification MCP échoue

Le token OAuth a peut-être expiré. Déconnectez puis reconnectez le serveur MCP dans les paramètres de votre assistant.

Ressources

Tous les liens de documentation d'Historis, produit et légal, au même endroit.

Utilisation

Référence du serveur MCP

Ce qu'est le serveur MCP, les données exposées, l'authentification et des exemples de prompts.

llms.txt

Index d'Historis lisible par les machines, pour assistants IA et crawlers.

Référence search_events

Le contrat complet de la recherche d'événements : chaque paramètre, la sémantique de combinaison, le schéma de réponse et des exemples copiables.

Référence search_persons

Le contrat complet de la recherche de contacts : plein texte descriptif, filtres de rôle sur le graphe relationnel, schéma de réponse et exemples.

Légal

Conditions Générales d'Utilisation

Le contrat qui encadre votre utilisation d'Historis.

Politique de Confidentialité

Ce que nous collectons, pourquoi, où c'est hébergé, et vos droits RGPD.

Accord de traitement des données (DPA)

Demandez une copie de notre DPA par email.

Contact

Une question sur le produit, vos données ou la facturation.

Documentation

01Utiliser Historis

Démarrage rapide

Créer un compte

Créer votre premier événement

Connecter votre assistant

Concepts clés

Événements

Personnes

Tags

Statuts

Équipes

Visibilité

Règles

02Connecter votre assistant

Connecter votre assistant

URL du serveur MCP

Claude Desktop

ChatGPT

Cursor

Règles

Comment ça marche

Apprenez à votre assistant, et laissez-le s'améliorer

Exemples de règles

03Référence développeur

Référence MCP Tools

Contexte & briefing

Événements

Personnes

Tags

Règles

Connaissances

Focus — le brief quotidien

Webhooks entrants

Créez un endpoint

Copiez l'URL et le token

Envoyez vos événements

Exemple de requête

Authentification

OAuth 2.1

Tokens API

FAQ

Comment créer un événement depuis mon assistant ?

Mon assistant n'applique pas une règle

Comment trouver les événements en retard ?

L'authentification MCP échoue

Ressources

Utilisation

Légal