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://beta.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 blockchain

Insufficient funds

Cause : Pas assez d’ETH sur Base L2.

Solution :

Verifiez votre balance : seshat status
Transferez de l’ETH vers votre wallet sur Base
Cout moyen : ~EUR0.07 par attestation

Transaction failed

Causes possibles :

Gas price trop bas
Nonce desynchronise
RPC temporairement indisponible

Solution : Reessayez. Les transactions sont idempotentes (pas de doublon si meme fingerprint).

EAS_SCHEMA_UID invalide

Verifiez que le schema UID correspond au reseau (Base mainnet vs testnet).

# Verifier la config
cat ~/.seshat/config.json | grep eas

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://beta.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