> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stratta.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingérez votre propre norme

> Ajoutez une norme pour laquelle vous disposez d'une licence à votre espace de travail Stratta privé — de manière agentique, depuis votre propre Claude.

Stratta ne fournit pas une bibliothèque partagée de normes. À la place, **vous apportez les normes pour
lesquelles votre organisation dispose d'une licence** et vous les ingérez dans votre espace de travail privé.
L'ingestion s'exécute depuis votre propre Claude à l'aide des outils `ingest_*` — votre abonnement, votre PDF,
votre espace de travail.

<Warning>
  **La licence relève de votre responsabilité.** N'ingérez que les normes pour lesquelles votre organisation
  détient une licence valide. Les normes SIA et les Eurocodes sont protégés par le droit d'auteur. Consultez les [Conditions](https://stratta.ch/legal/terms).
</Warning>

## Comment ça marche

Le package `@stratta/mcp` fournit un **skill `ingest-norm`** — un workflow guidé qui transforme un PDF de
norme en un arbre navigable dans votre espace de travail. Lorsque vous demandez à Claude d'ingérer une norme, il :

1. Lit le PDF.
2. Construit l'arbre de la table des matières (chapitres, sections, annexes).
3. Extrait les formules (en LaTeX), les tableaux, les figures et les références croisées.
4. Écrit tout dans votre espace de travail via les outils `ingest_*`.
5. Publie la norme afin que les [outils de lecture](/fr/mcp/read-tools) puissent l'interroger.

Comme l'agent fait le gros du travail, l'ingestion est reproductible sans pipeline de données manuel.
Elle s'exécute sur les jetons de session de votre abonnement Claude — pas de facturation API séparée.

## Prérequis

* Le serveur MCP Stratta est installé et authentifié (voir [Installer dans Claude Code](/fr/guides/install-claude-code)).
* Le **PDF de la norme est disponible localement** sur votre machine.
* Optionnel, pour extraire les figures : les outils [`poppler`](https://poppler.freedesktop.org/)
  (`pdftoppm`, `pdfimages`).

## Ingérer une norme

Dans Claude Code, depuis un contexte où le PDF est accessible, demandez simplement :

```text theme={null}
Ingest the norm at C:\norms\SIA_263_2013.pdf into my Stratta workspace.
```

Claude charge le skill `ingest-norm` et parcourt le workflow ci-dessous. Une norme complète prend un
certain temps — il lit chaque page et enrichit chaque section.

## Le workflow d'ingestion

Voici ce que fait le skill, étape par étape. Vous n'exécutez pas ces outils à la main — Claude les appelle —
mais comprendre le déroulement vous aide à examiner le résultat.

<Steps>
  <Step title="Vérifier l'existence d'une copie">
    `ingest_status { code }` indique si la norme existe déjà dans votre espace de travail. Pour
    ré-ingérer, l'ancienne copie est d'abord supprimée avec `ingest_delete`.
  </Step>

  <Step title="Planifier l'arbre">
    Claude lit le PDF et construit une hiérarchie de style PageIndex : chapitres (profondeur 0), sections,
    sous-sections et annexes. Chaque nœud reçoit un id stable, un chemin lisible (par ex. `4.2.1`,
    `Annexe B.1`), un court résumé, et une plage de pages. Les annexes ne sont jamais ignorées — elles contiennent
    des valeurs numériques clés.
  </Step>

  <Step title="Créer le document">
    `ingest_create_document { code, year, title, language, totalPages }` renvoie un `documentId`
    utilisé par chaque appel suivant.
  </Step>

  <Step title="Insérer les sections par lots">
    `ingest_create_sections` insère l'arbre en masse (30 à 50 sections par appel) et renvoie une table de
    correspondance entre chaque id de nœud et son id de section stocké.
  </Step>

  <Step title="Enrichir chaque section">
    `ingest_attach_formula` (LaTeX), `ingest_attach_table` (en-têtes + lignes), et
    `ingest_attach_cross_ref` (liens vers d'autres normes) ajoutent le contenu technique.
  </Step>

  <Step title="Téléverser les figures">
    `ingest_upload_figure` stocke chaque schéma (PNG, JPEG ou WebP, jusqu'à 8 Mo) et le lie à
    sa section.
  </Step>

  <Step title="Normaliser les références croisées (optionnel)">
    `ingest_normalize_cross_refs` analyse le texte à la recherche de références à d'autres normes (SIA, SN EN, EN,
    ISO, DIN…) et reconstruit l'index des références croisées.
  </Step>

  <Step title="Publier">
    `ingest_publish` rend la norme interrogeable via les outils de lecture dans votre espace de travail.
  </Step>
</Steps>

Consultez la [référence des outils d'ingestion](/fr/mcp/ingestion-tools) pour chaque paramètre.

## La qualité compte

La précision des futures citations dépend de l'ingestion :

* **Les chemins et les plages de pages** doivent être corrects — ils *sont* la citation.
* **Les résumés** déterminent la façon dont Claude navigue dans l'arbre, ils doivent donc être spécifiques (mentionner les
  formules ou valeurs clés).
* **Le contenu** doit rester fidèle à la source — jamais inventé.

Après l'ingestion, vérifiez par sondage quelques sections en posant à Claude des questions dont vous connaissez
déjà la réponse, et confirmez que les citations tombent sur les bonnes pages.

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Outils d'ingestion" icon="wrench" href="/fr/mcp/ingestion-tools">
    Les 10 outils `ingest_*` en détail.
  </Card>

  <Card title="Normes prises en charge" icon="book" href="/fr/resources/supported-norms">
    Ce qui est déjà disponible en démonstration.
  </Card>
</CardGroup>