Sillon
Sillon
← Accueil sillon.eu
Lecture seule

Connecter une IA

Branche une IA sur tes sujets Sillon via MCP (Model Context Protocol). Elle peut lire le contexte d'un sujet — objectif, points ouverts, prochaines actions, décisions, log et trajectoire — pour t'aider à avancer. Jamais d'écriture : l'IA consulte, elle ne touche pas à ton vault.

Prérequis 1 · Générer un token Endpoint 2 · Brancher ton client Les outils Gérer ses tokens Sécurité Dépannage

Prérequis

1 · Générer un token

Dans l'app iOS : Réglages → Connecter une IA. Donne un nom à l'outil (ex. « Claude Code », « Cursor ») puis Générer un token. L'app te montre le token une seule fois — copie-le immédiatement (« Copier le token », ou « Copier la commande Claude Code » qui le pré-remplit pour toi).

À noter — le token clair n'est affiché qu'à la création. Si tu le perds, tu n'en récupères pas la valeur : génère-en simplement un nouveau.

Endpoint

L'URL exacte est affichée dans l'app au moment de générer le token. En production :

https://sillon-production.up.railway.app/mcp

Transport : Streamable HTTP (JSON-RPC 2.0 sur POST, sans SSE). Versions de protocole MCP supportées : 2025-06-18 et 2025-03-26. Un GET/DELETE sur l'endpoint renvoie 405 — c'est attendu, le serveur n'ouvre jamais de flux.

2 · Brancher ton client

Partout, l'authentification est un bearer statique : ajoute l'en-tête Authorization: Bearer <TON_TOKEN_MCP>. Pas d'OAuth, pas d'inscription d'app.

Claude Code (CLI)

La commande est pré-remplie par l'app (« Copier la commande Claude Code »). Sinon :

# ajouter le serveur
claude mcp add --transport http sillon https://sillon-production.up.railway.app/mcp \
  --header "Authorization: Bearer <TON_TOKEN_MCP>"

# vérifier / retirer
claude mcp list
claude mcp remove sillon

Cursor

Dans ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projet) :

{
  "mcpServers": {
    "sillon": {
      "url": "https://sillon-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer <TON_TOKEN_MCP>"
      }
    }
  }
}

Claude Desktop

Claude Desktop ne lit nativement que des serveurs stdio : on passe par le pont mcp-remote pour un endpoint HTTP authentifié. Dans claude_desktop_config.json :

{
  "mcpServers": {
    "sillon": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://sillon-production.up.railway.app/mcp",
        "--header", "Authorization: Bearer <TON_TOKEN_MCP>"
      ]
    }
  }
}

Claude.ai (connecteur custom)

Ajoute un connecteur MCP distant avec l'URL https://sillon-production.up.railway.app/mcp et colle le bearer. Sillon n'implémente pas d'enregistrement dynamique de client (DCR) — le token statique généré dans l'app suffit.

ChatGPT — pas supporté pour l'instant : ChatGPT attend un flux OAuth (sans DCR) et des outils nommés search/fetch. Sillon expose un bearer statique et les outils list_subjects/search_subjects/get_subject — ni l'un ni l'autre ne correspond.

Les outils exposés

Trois outils, tous en lecture seule. Le flux typique : lister ou chercher, puis lire le brief complet d'un sujet.

OutilCe qu'il fait
list_subjectsListe tes sujets (fils de travail). Filtres optionnels : status (active / dormant / closed), area, query. À appeler en premier pour découvrir ce qui existe.
search_subjectsRecherche par mot-clé (titre ×2, aperçu d'objectif ×1 ; correspondance par sous-chaîne, pas de sémantique). Args : query (requis), limit (1–50). Localise le bon sujet avant get_subject.
get_subjectBrief complet par slug exact : objectif, points ouverts, prochaines actions, décisions, log daté, trajectoire (évolution via git) et sujets liés. Args : slug (requis), trajectory_limit, include_related.

Gérer ses tokens

Dans Réglages → Connecter une IA, l'app liste tes tokens actifs (nom, date de création, dernière utilisation — jamais la valeur). Glisse sur un token pour le révoquer : l'outil concerné perd l'accès immédiatement.

Sécurité & confidentialité

Dépannage