Démarrage rapide

De zéro à une pull request sous contrôle en un quart d'heure environ.

1. Créez votre organisation

Inscrivez-vous — votre compte et votre première organisation sont créés ensemble. L'offre Free ne demande pas de carte bancaire et inclut les analyses illimitées.

2. Connectez votre provider IA (BYOK)

Dans Settings → AI provider, choisissez Anthropic, OpenAI, Mistral ou Google, sélectionnez un modèle (les suggestions se chargent automatiquement) et collez votre clé API. Utilisez Test connection : un vrai appel est émis pour valider le couple clé + modèle. La clé est chiffrée en AES-256-GCM et n'est plus jamais affichée.

Tout ce que Normik analyse tourne sur cette clé. Pas de clé, pas d'analyse : tant qu'aucune n'est configurée, la gate CI passe (fail-open) et le dit.

3. Écrivez — ou générez — votre playbook

Dans Playbook, ajoutez vos règles en langage naturel, avec une sévérité et, si besoin, des scopes en glob. Deux règles réellement appliquées valent mieux que vingt intentions. Vous partez d'une codebase existante ? Cliquez sur Bootstrap from repo et choisissez quelques fichiers représentatifs — aucun agent n'est nécessaire — ou laissez un agent connecté appeler bootstrap_playbook, le résultat est le même. Dans les deux cas, les règles proposées arrivent dans une file de revue et attendent votre approbation(voir MCP et agents).

4. Créez un token de workspace

Dans Settings → MCP & agents, générez un token — pour toute l'organisation, ou restreint à un workspace (les tokens de workspace héritent des règles globales). Il n'est affiché qu'une fois : stockez-le en secret CI sous le nom NORMIK_TOKEN.

5. Ajoutez un job à votre CI

Toute l'intégration tient dans un diff envoyé en HTTPS :

git diff "origin/main...HEAD" |
curl -sS --fail-with-body -X POST "$NORMIK_URL/api/ci/gate" \
  -H "Authorization: Bearer $NORMIK_TOKEN" --data-binary @-

Des snippets prêts à l'emploi pour GitHub Actions et GitLab CI — capables l'un comme l'autre de reposter le verdict en commentaire de PR ou de merge request — sont générés dans Settings → CI integration.Toute la sémantique dans Gate CI.

Optionnel : connecter Claude Code

claude mcp add --transport http normik https://api.normik.io/api/mcp \
  --header "Authorization: Bearer $NORMIK_TOKEN"

Votre agent charge désormais le playbook pendant qu'il écrit, et se contrôle lui-même avant de committer. Ouvrez le dashboard : les premières analyses, violations et corrections pré-commit y apparaissent au fil de l'eau.