Quickstart

Installation

curl -fsSL https://beta.seshat-mcp.com/install.sh | bash

Le script installe SESHAT et configure automatiquement vos clients MCP.

Compatibilite

Plateformes compatibles : macOS (Apple Silicon & Intel) — Linux (x64 & ARM64) — Windows (x64)

Clients MCP pris en charge : Claude Desktop, Claude Code, Cursor, VS Code, Zed, Windsurf, Continue, Kilo Code, Gemini CLI, Cline, Roo, Antigravity

Prerequis

1. Wallet Ethereum (optionnel)

   Pour ancrer sur blockchain : un wallet avec un peu d’ETH sur Base L2 (~EUR0.07 par attestation).

   Astuce

   Creez un wallet dedie pour SESHAT. N’utilisez jamais votre wallet principal.

   Note

   Sans wallet, SESHAT fonctionne en mode local (preuves stockees localement).

2. Token Git Host

   Generez un token API pour votre git host (GitHub, GitLab, ou Forgejo) avec scope read:repo.

3. Vault Obsidian (optionnel)

   Pour certifier vos notes de recherche, pointez vers votre vault Obsidian.

Configuration

Le wizard d’installation configure automatiquement SESHAT. Vous pouvez aussi creer un fichier .env :

# Blockchain (Optionnel - mode local sans)
ETH_PRIVATE_KEY=0x...
EAS_SCHEMA_UID=0x...

# Git Host (pour seal PR/release)
GIT_HOST_API_URL=https://api.github.com
GIT_HOST_TOKEN=ghp_...

# Obsidian (pour certify_research)
OBSIDIAN_ROOT=/chemin/vers/vault

# Base de donnees
DB_PATH=./data/seshat.db

Attention

Ne commitez jamais votre .env. Ajoutez-le a .gitignore.

Configuration Client MCP

Claude Desktop

Fichier : ~/Library/Application Support/Claude/claude_desktop_config.json

macOS

{
  "mcpServers": {
    "seshat": {
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  }
}

Windows

{
  "mcpServers": {
    "seshat": {
      "command": "C:\\Users\\VOTRE_USER\\.seshat\\bin\\seshat.exe",
      "args": ["serve"]
    }
  }
}

Linux

{
  "mcpServers": {
    "seshat": {
      "command": "/home/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Claude Desktop. Aide-moi a diagnostiquer.

1. Lis le fichier config Claude Desktop :
   - macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   - Windows : %APPDATA%\Claude\claude_desktop_config.json
   - Linux : ~/.config/Claude/claude_desktop_config.json

2. Verifie que la section "mcpServers" contient "seshat" avec :
   - "command" : chemin ABSOLU vers ~/.seshat/bin/seshat
   - "args" : ["serve"]

3. Verifie que le binaire existe : ls -la ~/.seshat/bin/seshat

4. Teste le binaire : ~/.seshat/bin/seshat --help

5. Si le binaire n'existe pas, reinstalle :
   curl -fsSL https://beta.seshat-mcp.com/install.sh | bash

6. Si la config est correcte mais SESHAT n'apparait toujours pas,
   dis-moi de redemarrer Claude Desktop.

Claude Code

Fichier : ~/.claude.json

{
  "mcpServers": {
    "seshat": {
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Claude Code. Aide-moi a diagnostiquer.

1. Lis ~/.claude.json et montre-moi la section "mcpServers"

2. Verifie que "seshat" existe avec un chemin ABSOLU
   (doit etre /Users/xxx/.seshat/bin/seshat, pas juste "seshat")

3. Teste le handshake MCP :
   echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | ~/.seshat/bin/seshat serve

4. Si erreur "no such column" ou crash : le binaire est obsolete.
   Reinstalle : curl -fsSL https://beta.seshat-mcp.com/install.sh | bash

5. Si erreur "Config not loaded" : lance "seshat init" pour configurer

6. Montre-moi le resultat de chaque commande.

Cursor

Fichier : ~/.cursor/mcp.json

{
  "mcpServers": {
    "seshat": {
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Cursor. Aide-moi a diagnostiquer.

1. Lis ~/.cursor/mcp.json et montre-moi le contenu

2. Le fichier doit avoir cette structure exacte :
   {
     "mcpServers": {
       "seshat": {
         "command": "/chemin/absolu/.seshat/bin/seshat",
         "args": ["serve"]
       }
     }
   }

3. Si le fichier n'existe pas ou est vide, cree-le avec le bon contenu
   (remplace /chemin/absolu par mon $HOME)

4. Verifie que le binaire fonctionne : ~/.seshat/bin/seshat --help

5. Si le binaire n'existe pas :
   curl -fsSL https://beta.seshat-mcp.com/install.sh | bash

6. Dis-moi de redemarrer Cursor apres les corrections.

VS Code (Copilot)

Fichier : ~/.vscode/mcp.json

Attention

VS Code utilise servers (pas mcpServers) !

{
  "servers": {
    "seshat": {
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans VS Code (Copilot). Aide-moi a diagnostiquer.

ATTENTION : VS Code utilise "servers" PAS "mcpServers" !

1. Lis ~/.vscode/mcp.json et montre-moi le contenu

2. Le fichier doit avoir cette structure (note: "servers" pas "mcpServers") :
   {
     "servers": {
       "seshat": {
         "command": "/chemin/absolu/.seshat/bin/seshat",
         "args": ["serve"]
       }
     }
   }

3. Si tu vois "mcpServers" au lieu de "servers", corrige-le

4. Verifie que le binaire existe : ls -la ~/.seshat/bin/seshat

5. Si le binaire n'existe pas :
   curl -fsSL https://beta.seshat-mcp.com/install.sh | bash

6. Dis-moi de redemarrer VS Code et d'ouvrir Command Palette -> "MCP: Show Servers"

Zed

Fichier : ~/.config/zed/settings.json

Attention

Zed utilise context_servers avec une structure differente !

{
  "context_servers": {
    "seshat": {
      "command": {
        "path": "/Users/VOTRE_USER/.seshat/bin/seshat",
        "args": ["serve"]
      }
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Zed. Aide-moi a diagnostiquer.

ATTENTION : Zed a une structure DIFFERENTE des autres editeurs !

1. Lis ~/.config/zed/settings.json et cherche "context_servers"

2. La structure Zed est speciale (note: command.path, pas command) :
   {
     "context_servers": {
       "seshat": {
         "command": {
           "path": "/chemin/absolu/.seshat/bin/seshat",
           "args": ["serve"]
         }
       }
     }
   }

3. Erreurs courantes a corriger :
   - "command": "/path" -> doit etre "command": { "path": "/path", "args": [...] }
   - "mcpServers" -> doit etre "context_servers"

4. Verifie que le binaire existe et fonctionne :
   ~/.seshat/bin/seshat --help

5. Dis-moi de redemarrer Zed apres les corrections.

Windsurf

Fichier : ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "seshat": {
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Windsurf. Aide-moi a diagnostiquer.

1. Verifie si le dossier config existe :
   ls -la ~/.codeium/windsurf/

2. Si le dossier n'existe pas, cree-le :
   mkdir -p ~/.codeium/windsurf

3. Lis ou cree ~/.codeium/windsurf/mcp_config.json avec :
   {
     "mcpServers": {
       "seshat": {
         "command": "/chemin/absolu/.seshat/bin/seshat",
         "args": ["serve"]
       }
     }
   }

4. Remplace /chemin/absolu par mon $HOME reel

5. Verifie que le binaire existe : ~/.seshat/bin/seshat --help

6. Dis-moi de redemarrer Windsurf.

Continue

Fichier : ~/.continue/config.json

Attention

Continue utilise un tableau mcpServers !

{
  "mcpServers": [
    {
      "name": "seshat",
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  ]
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Continue. Aide-moi a diagnostiquer.

ATTENTION : Continue utilise un TABLEAU, pas un objet !

1. Lis ~/.continue/config.json et cherche "mcpServers"

2. La structure Continue est un tableau (note les crochets []) :
   {
     "mcpServers": [
       {
         "name": "seshat",
         "command": "/chemin/absolu/.seshat/bin/seshat",
         "args": ["serve"]
       }
     ]
   }

3. Erreurs courantes a corriger :
   - mcpServers: { "seshat": {...} } -> doit etre mcpServers: [ { "name": "seshat", ... } ]
   - Le champ "name" est OBLIGATOIRE dans Continue

4. Verifie que le binaire existe : ~/.seshat/bin/seshat --help

5. Dis-moi de redemarrer l'IDE apres les corrections.

Kilo Code

Fichier : ~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code/settings/mcp_settings.json

Note

Kilo Code est le client MCP n1 sur OpenRouter (2T+ tokens/mois). Fork de Cline, meme format de configuration.

{
  "mcpServers": {
    "seshat": {
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Kilo Code. Aide-moi a diagnostiquer.

1. Cherche le fichier MCP settings de Kilo Code :
   ~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code/settings/mcp_settings.json

2. Le fichier doit avoir cette structure :
   {
     "mcpServers": {
       "seshat": {
         "command": "/chemin/absolu/.seshat/bin/seshat",
         "args": ["serve"]
       }
     }
   }

3. Verifie que le binaire existe : ~/.seshat/bin/seshat --help

4. Si le binaire n'existe pas :
   curl -fsSL https://beta.seshat-mcp.com/install.sh | bash

5. Montre-moi le resultat de chaque commande.

Gemini CLI

Fichier : ~/.gemini/settings.json

{
  "mcpServers": {
    "seshat": {
      "command": "/Users/VOTRE_USER/.seshat/bin/seshat",
      "args": ["serve"]
    }
  }
}

Instructions debug pour votre agent IA

Copiez ce prompt a votre agent :

SESHAT ne fonctionne pas dans Gemini CLI. Aide-moi a diagnostiquer.

1. Lis ~/.gemini/settings.json et cherche "mcpServers"

2. Le fichier doit avoir cette structure :
   {
     "mcpServers": {
       "seshat": {
         "command": "/chemin/absolu/.seshat/bin/seshat",
         "args": ["serve"]
       }
     }
   }

3. Verifie que le binaire existe : ~/.seshat/bin/seshat --help

4. Si le binaire n'existe pas :
   curl -fsSL https://beta.seshat-mcp.com/install.sh | bash

5. Si le dossier ~/.gemini n'existe pas, cree-le :
   mkdir -p ~/.gemini

6. Montre-moi le resultat de chaque commande.

Astuce

Le script d’installation configure automatiquement tous les clients detectes. Utilisez seshat config pour reconfigurer manuellement.

Premiers pas

1. Verifier l’etat du systeme

seshat status

Ou via votre agent IA :

Verifie l'etat de SESHAT

Note

L’outil status affiche : balance wallet, connectivite git host, statistiques DB.

2. Configurer un projet

Via l’agent IA :

Configure le projet "mon-projet" avec mon repo GitHub

L’agent utilise configure(action="add_project", ...) pour creer le projet.

3. Sceller une PR mergee

Scelle la PR #42 du projet mon-projet

Astuce

Utilisez dry_run: true pour previsualiser avant d’ancrer sur blockchain.

4. Certifier des notes de recherche

Vos notes Obsidian doivent avoir un frontmatter YAML :

---
project: mon-projet
date: 2026-01-16
hours: 2.5
class: S
status: reviewed
---

Puis :

Certifie mes notes de recherche de la semaine

5. Generer un bundle legal

Pour une release :

Genere le bundle legal pour le tag v1.0.0

Contenu genere :

• *_source.zip - Archive source complete
• RD_REPORT.md - Heures R&D par mois
• PROOF_CHAIN.json - Tous les UIDs blockchain
• MANIFEST.json - Hashes SHA-512

Et ensuite ?

Concepts cles Comprendre la chaine de preuves

Reference API Explorer tous les outils MCP

Securite avancee Signatures post-quantiques

Rapports R&D Generer des rapports CIR/CII