# SilverBackBase — Documentation complète pour agents IA

SilverBackBase est une bibliothèque de primitive tools pour agents IA marketing. Chaque outil est atomique, autonome, et expose ses données via MCP (Model Context Protocol).

L'interface, c'est l'agent. Pas de dashboard.

---

## Configuration initiale — MCP unifié

Un seul MCP endpoint expose tous les outils selon votre compte. À configurer une fois dans votre agent IA.

**URL MCP:** https://mcp.silverbackbase.com/mcp
**Auth:** Bearer token

Configuration Claude Code (~/.claude.json) :
```json
{
  "mcpServers": {
    "silverbackbase": {
      "type": "http",
      "url": "https://mcp.silverbackbase.com/mcp",
      "headers": { "Authorization": "Bearer <VOTRE_TOKEN>" }
    }
  }
}
```

Configuration Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) :
```json
{
  "mcpServers": {
    "silverbackbase": {
      "type": "http",
      "url": "https://mcp.silverbackbase.com/mcp",
      "headers": { "Authorization": "Bearer <VOTRE_TOKEN>" }
    }
  }
}
```

Générer un token : https://www.silverbackbase.com/account/tokens

---

## Trail — Multi-touch attribution (v0.7.4, en prod)

Reconstruit le parcours complet d'un lead : toutes les sessions depuis la première visite jusqu'à la soumission du formulaire.

**Installation:**
```bash
npx @silverbackbase/trail init --token <token>
```
Configure automatiquement Claude Code, Claude Desktop, Antigravity, Codex CLI et installe le skill trail-attribution-sbb.

**Outils MCP disponibles:**

| Outil | Description |
|-------|-------------|
| trail_create_account | Crée un compte client, retourne le snippet à coller |
| trail_list_accounts | Liste tous les clients enregistrés |
| trail_list_leads | Liste les leads (emails) avec canal et date |
| trail_get_journey | Parcours complet d'un lead (toutes ses sessions) |
| trail_get_report | Rapport d'attribution par canal (first/last/linear) |
| trail_get_top_paths | Séquences de canaux les plus fréquentes |
| trail_get_channel_performance | Visiteurs / leads / conversions / taux par canal |
| trail_get_recent_sessions | Sessions récentes brutes (debug tracker) |
| trail_delete_account | Supprime un compte et ses données |
| trail_delete_lead | Supprime un lead |
| trail_delete_visitor | Supprime un visiteur |
| trail_purge_account_data | Purge toutes les données d'un compte |

**Exemples de prompts:**
- "Où viennent nos leads ce mois-ci ?"
- "Montre-moi le parcours de marie@example.com"
- "Le tracker est-il bien installé sur le site du client X ?"
- "Quels canaux convertissent le mieux en last touch ?"

**Docs complètes:** https://www.silverbackbase.com/docs/trail

---

## Root — Business knowledge memory (v0.4.9, en prod)

Mémoire métier structurée pour agents IA. Un compte par client, une mémoire isolée. Onboarding automatique depuis une URL + veille concurrentielle hebdomadaire.

**Installation:**
```bash
npx @silverbackbase/root init --token <token>
```
Configure MCP, installe le hook UserPromptSubmit (rappel automatique de root_get_context avant génération de contenu) et le skill root-onboard.

**Outils MCP disponibles:**

| Outil | Description |
|-------|-------------|
| root_get_context | Retourne tout le contexte métier du client actif |
| root_get_category | Retourne une catégorie spécifique (offers, personas, objections…) |
| root_search | Recherche dans la base de connaissance |
| root_onboard_from_url | Scrape une URL et extrait le contexte métier automatiquement |
| root_create_item | Ajoute un élément dans une catégorie |
| root_update_item | Met à jour un élément existant |
| root_delete_item | Supprime un élément |
| root_refresh | Veille marché : détecte les nouveaux concurrents SERP |

**Catégories de connaissance:**
profile, offers, personas, objections, differentiators, geo, pricing, faqs, competitors

**Exemples de prompts:**
- "Onboarde le site exemple.fr dans Root"
- "Rédige un email de prospection pour ce client" (déclenche le hook automatiquement)
- "Quelles sont les objections terrain de ce client ?"
- "Lance une veille concurrentielle pour le client X"

**Docs complètes:** https://www.silverbackbase.com/docs/root

---

## Compte & liens utiles

- Site: https://www.silverbackbase.com
- Créer un compte: https://www.silverbackbase.com
- Tokens API: https://www.silverbackbase.com/account/tokens
- Dashboard: https://www.silverbackbase.com/account
- Docs: https://www.silverbackbase.com/docs
- MCP setup: https://www.silverbackbase.com/docs/serveur-mcp