Documentation IFTTD MCP

Qu'est-ce que IFTTD MCP ?

IFTTD MCP est un serveur MCP (Model Context Protocol) qui rend les retours d'expérience de 350+ praticiens du podcast IFTTD accessibles dans ton IDE.

Quand tu planifies un projet avec Claude Code, Cursor ou Windsurf, les outils IFTTD sont invoqués automatiquement pour confronter tes choix aux retours de terrain de CTOs, architects et lead devs.


Installation

Claude Code

$ claude mcp add --transport http \
  ifttd-mcp https://mcp.ifttd.io/mcp \
  --header "X-API-Key: iftd_ta_cle_api"

Cursor

Crée un fichier .mcp.json à la racine de ton projet :

{
  "mcpServers": {
    "ifttd-mcp": {
      "url": "https://mcp.ifttd.io/mcp",
      "headers": {
        "X-API-Key": "iftd_ta_cle_api"
      }
    }
  }
}

Windsurf

Ajoute dans ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "ifttd-mcp": {
      "serverUrl": "https://mcp.ifttd.io/mcp",
      "headers": {
        "X-API-Key": "iftd_ta_cle_api"
      }
    }
  }
}

Les 3 outils

ifttd_plan_review

Analyse ton plan technique ou ta décision d'architecture. Retourne un verdict go/caution/no-go avec des risques identifiés par des praticiens qui l'ont vécu.

Invoqué automatiquement quand Claude détecte une phase de planning ou une décision d'architecture.

Pour maximiser l'usage automatique, ajoute dans ton CLAUDE.md :

Avant de finaliser un plan d'architecture ou une décision technique,
consulte le MCP ifttd-mcp (ifttd_plan_review) pour obtenir des
retours terrain de praticiens.

Exemples de questions :

ifttd_search

Recherche dans 359 épisodes de retours d'expérience. Chaque insight cite son épisode, son invité et son contexte.

Exemples :

ifttd_episode

Fiche détaillée d'un épisode : thème, invité, extraits marquants, lien d'écoute. Utile quand les autres outils recommandent un épisode spécifique.


Permissions (Claude Code)

Pour que Claude utilise les outils IFTTD sans te demander permission à chaque fois :

  1. Tape /permissions dans Claude Code
  2. Ajoute une règle Allow pour le serveur ifttd-mcp
  3. Ou approuve "Always allow" au premier appel

API

L'endpoint MCP est compatible JSON-RPC 2.0 (Streamable HTTP) :

POST https://mcp.ifttd.io/mcp
Content-Type: application/json
X-API-Key: iftd_ta_cle_api

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ifttd_search",
    "arguments": { "query": "dette technique" }
  }
}

Rate limits

Pour protéger le service, des limites par fenêtre de 15 minutes sont appliquées :

Outil Limite
ifttd_plan_review 5 appels / 15 min
ifttd_search 10 appels / 15 min
ifttd_episode 30 appels / 15 min
Global 30 appels / 15 min

En usage normal (une session de planning), c'est largement suffisant.


FAQ

Le corpus est-il mis à jour ? Oui. À chaque nouvel épisode du podcast IFTTD (1 par semaine), la base de connaissance est enrichie automatiquement.

D'où viennent les réponses ? Exclusivement des transcripts du podcast IFTTD. Chaque insight cite son épisode source, l'invité et le contexte. Zéro hallucination.

Est-ce que ça marche avec d'autres IDE ? Le serveur est compatible MCP standard (Streamable HTTP). Tout IDE supportant MCP peut l'utiliser.


Support

Contact : bruno@ifttd.io