Troubleshooting

Le serveur MCP ne demarre pas

Erreur: no such column: objective

Cause : Base de donnees creee avec une ancienne version.

Solution : Mettez a jour vers v0.2.2-beta ou plus recent. Les migrations s’appliquent automatiquement.

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

Erreur: Config not loaded

Cause : Le fichier ~/.seshat/config.json est manquant ou invalide.

Solution : Lancez le wizard d’initialisation :

seshat init

Le serveur crash immediatement

Cause : Probleme de permissions ou de chemin.

Debug :

# Tester manuellement
~/.seshat/bin/seshat serve

# Verifier les logs
~/.seshat/bin/seshat status

Problemes de configuration client

Claude Desktop ne detecte pas SESHAT

Verifiez le chemin du fichier config :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json

Contenu attendu :

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

Cursor ne voit pas SESHAT

Chemin config : ~/.cursor/mcp.json

Verifiez :

cat ~/.cursor/mcp.json

Format attendu :

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

VS Code (Copilot) ne detecte pas SESHAT

Chemin config : ~/.vscode/mcp.json

Format VS Code (utilise servers, pas mcpServers) :

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

Zed Editor configuration

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

Format Zed :

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

Problemes IP Secure / eIDAS

ipsecure_certificate_url reste null

Cause : Jinnove genere le certificat eIDAS de maniere asynchrone. A l’instant T du scellement, l’URL est souvent null.

Solution : Attendez quelques minutes, puis appelez :

Recupere le certificat eIDAS pour l'entree ledger #42

L’outil fetch_certificate interroge Jinnove et persiste l’URL quand le certificat est pret.

IP Secure : ipsecure_project_id manquant

Cause : Le projet SESHAT n’est pas lie a un projet Jinnove.

Solution : L’outil retourne la liste des projets Jinnove disponibles dans le message d’erreur. Liez le projet :

Liste mes projets IP Secure et lie mon-api au projet Jinnove correspondant

Problemes Git Host

401 Unauthorized

Cause : Token expire ou permissions insuffisantes.

Solution :

Regenerez un token avec scope repo (read)
Mettez a jour ~/.seshat/config.json

seshat init  # Re-configure le token

PR not found

Verifiez :

Le numero de PR est correct
La PR est mergee (SESHAT ne scelle que les PRs mergees)
Le projet est configure avec le bon git_host_owner et git_host_repo

GitHub App vs Token

SESHAT supporte deux modes d’auth GitHub :

Token personnel (simple) :

{
  "git_host_token": "ghp_xxxx"
}

GitHub App (recommande pour orgs) :

{
  "github_app_id": "123456",
  "github_app_private_key": "-----BEGIN RSA..."
}

Commandes de debug

# Etat complet du systeme
seshat status

# Verifier la config
cat ~/.seshat/config.json

# Tester le binaire
~/.seshat/bin/seshat --help

# Logs detailles (si supporte)
LOG_LEVEL=debug seshat serve

# Verifier la DB
sqlite3 ~/.seshat/seshat.db ".tables"
sqlite3 ~/.seshat/seshat.db "SELECT COUNT(*) FROM ledger"

Reinstallation complete

Si rien ne fonctionne, reinstallez proprement :

# Backup de la DB (optionnel)
cp ~/.seshat/seshat.db ~/seshat-backup.db

# Suppression
rm -rf ~/.seshat

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

# Reconfiguration
seshat init

Support

GitHub Issues Signalez un bug ou demandez une feature

Discord Communaute et support en direct