configure

Overview

L’outil configure permet de gerer la configuration SESHAT directement via MCP, sans terminal.

Actions disponibles (13)

action string requis

Action	Description
get_config	Configuration actuelle (champs sensibles masqués)
get_config_status	Liste les tokens configurés (sans les valeurs)
set_git_host	Configure le git host (GitHub / GitLab / Forgejo)
set_env	Écrit un token dans ~/.seshat/config.json (whitelist stricte, valeur jamais retournée)
add_project	Ajoute un nouveau projet
update_project	Modifie un projet existant
list_projects	Liste tous les projets
get_project	Détails d’un projet spécifique
sync_github	Sync une installation GitHub App (auto-seal webhook)
list_ipsecure_projects	Liste les projets Jinnove disponibles avec votre API key
sync_ipsecure_project_names	Synchronise les noms des projets Jinnove vers le ledger local
create_ipsecure_project	Crée un nouveau projet Jinnove + association auto à un projet SESHAT
test_sources	Test de connectivité par source (obsidian, notion, jira, n8n, git, ipsecure) pour un projet donné

Parametres par action

set_git_host

git_host_type string

github, gitlab, ou forgejo

git_host_api_url string

URL de l’API (ex: https://api.github.com)

git_host_token string

Token d’acces personnel

add_project / update_project

project_id string requis

Identifiant unique du projet

project_name string

Nom lisible du projet

repo_path string

Chemin local vers le depot git

vault_path string

Sous-dossier Obsidian pour les notes de recherche

git_host_owner string

Owner sur le git host (org ou username)

git_host_repo string

Nom du repo sur le git host

notion_database_id string

ID de la base Notion pour les notes de recherche. Accepte UUID, hex brut, ou URL Notion.

notion_database_id: "abcdef12-3456-7890-abcd-ef1234567890"

Astuce

Voir Notion Integration pour creer et connecter votre base.

default_asset_types string[]

Types d’actifs par defaut pour ce projet (ex: ["logiciel", "base_donnees"])

Astuce

Configure des defaults pour reduire les questions de l’agent a chaque seal.

default_objective string

Objectif R&D par defaut pour ce projet

Exemples

Configurer GitHub

Configure SESHAT avec GitHub

{
  "action": "set_git_host",
  "git_host_type": "github",
  "git_host_api_url": "https://api.github.com",
  "status": "configured"
}

Ajouter un projet avec defaults

Ajoute le projet "mon-api" avec defaults logiciel et objectif "Optimisation API"

{
  "action": "add_project",
  "project_id": "mon-api",
  "default_asset_types": ["logiciel"],
  "default_objective": "Optimisation API",
  "status": "created"
}

Connecter une base Notion

Ajoute la base Notion abc123... au projet "mon-api"

{
  "action": "update_project",
  "project_id": "mon-api",
  "notion_database_id": "abcdef12-3456-7890-abcd-ef1234567890",
  "status": "updated"
}

Lister les projets

Liste mes projets SESHAT

{
  "action": "list_projects",
  "projects": [
    {
      "id": "mon-api",
      "name": "Mon API",
      "has_repo": true,
      "has_vault": true,
      "has_notion": true,
      "default_asset_types": ["logiciel"]
    }
  ]
}

Workflow recommandé pour un nouveau projet

1. Vérifier la config

   configure(action="get_config")

2. Configurer git host (si pas déjà fait)

   configure(action="set_git_host", git_host_type="github")

   Puis stocker le token : configure(action="set_env", key="GIT_HOST_TOKEN", value="ghp_...")

3. Ajouter le projet (l’agent peut auto-détecter repo_path, git_host_owner, git_host_repo depuis pwd + git remote get-url origin)

   configure(action="add_project", project_id="mon-projet", ...)

4. Tester les sources connectées

   configure(action="test_sources", project_id="mon-projet")

5. Optionnel : créer / lier un projet IP Secure

   configure(action="create_ipsecure_project", project_id="mon-projet", ipsecure_project_name="Mon Projet")

6. Vérifier le tout

   status(verbose=true) puis setup_agent(dry_run=true) pour préparer le CLAUDE.md du projet.

set_env — whitelist

L’action set_env n’accepte qu’une liste blanche stricte de clés (par sécurité — empêche un agent rogue d’écrire n’importe quoi dans ~/.seshat/config.json). Les valeurs ne sont jamais retournées par get_config ou get_config_status — seul leur statut “configuré / non configuré” est exposé.

Les clés de la whitelist couvrent tous les tokens documentés dans la page Configuration : GIT_HOST_TOKEN, IP_SECURE_API_KEY, IP_SECURE_PRIVATE_KEY, IP_SECURE_AUTHOR_EMAIL, NOTION_TOKEN, JIRA_*, N8N_*, HUB_URL, HUB_API_TOKEN, ODATA_USER, ODATA_PASS, NFT_STORAGE_TOKEN.