Connectez votre IA à SubReply

Le chemin le plus court, et sans clé à copier nulle part. Le connecteur vous renvoie sur SubReply, vous vous connectez avec votre compte habituel et c'est branché.

L'autorisation vaut 30 jours. Au bout de ce délai le client rouvre le même écran, et un clic suffit à repartir.

La clé voyage dans l'en-tête Authorization. Chaque requête est réauthentifiée, donc révoquer une clé la coupe à l'instant même, sans attendre la fin d'une session. C'est la même clé sr_live_…que pour l'API REST v1, à générer sur votre page clés API.

Claude Code et Claude Desktop

claude mcp add --transport http subreply https://subreply.io/api/mcp \
  --header "Authorization: Bearer sr_live_VOTRE_CLE_API"

Ou directement dans le fichier de configuration MCP, si vous préférez le versionner :

{
  "mcpServers": {
    "subreply": {
      "type": "http",
      "url": "https://subreply.io/api/mcp",
      "headers": {
        "Authorization": "Bearer sr_live_VOTRE_CLE_API"
      }
    }
  }
}

n8n

Ajoutez un nœud MCP Client et renseignez quatre champs :

• Endpoint — https://subreply.io/api/mcp
• Server Transport — HTTP Streamable
• Authentication — Header Auth
• Identifiant Header Auth — nom Authorization, valeur Bearer sr_live_…

Le nœud liste alors les six tools. Pensez au timeout : publish_reddit_comment peut prendre deux minutes, et le défaut de n8n est bien plus court.

Vérifier que ça répond

Si un client refuse de se connecter, cet appel tranche la question : il ne dépend d'aucun client MCP et n'utilise aucun crédit.

curl -s -X POST https://subreply.io/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer sr_live_VOTRE_CLE_API" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Six tools listés, c'est le serveur qui va bien et le problème est côté client. Un 401 et c'est la clé. Un 406 et c'est l'en-tête Accept: le transport exige les deux types, même s'il répond du JSON pur. Le tool ping fait le même travail une fois le client branché : il répond pong et prouve du même coup que votre clé passe.

Même économie que l'API REST : la recherche est gratuite, seule la production est facturée. Un scan qui ne trouve rien ne coûte donc jamais rien.

Les débits sont idempotents par post : si le réseau coupe et que votre agent rejoue generate_reddit_comment sur la même URL Reddit, le second appel rend credits_used: 0.

Les quotas sont comptés par compte et par tool : épuiser generate_reddit_comment ne bride ni vos autres tools ni les autres comptes. pingn'est volontairement pas limité — c'est la sonde, elle doit rester joignable au moment où l'on tape en rafale parce qu'on soupçonne une panne.

C'est pour ça qu'il est éteint par défaut. Pour l'allumer, ouvrez votre page clés API et activez la publication sur la clé concernée.

L'autorisation vit sur la clé, pas sur le compte, et c'est délibéré : une clé dédiée à un workflow n8n de publication peut l'avoir pendant qu'une clé collée dans un assistant conversationnel ne l'a pas. Après une fuite, éteindre la publication sur cette clé-là ne casse aucune de vos autres intégrations.

• 5 appels par minute au maximum, très en dessous de ce que l'infrastructure supporterait. Une rafale de publications ne coûte pas qu'un solde : c'est un shadowban.
• Les 50 crédits sont débités après coup, une fois la publication confirmée. Un échec ne facture rien.
• Ce tool n'est pas idempotent : deux appels sur la même URL laissent deux commentaires. Le second est gratuit, mais il est bien là.
• Comptez jusqu'à deux minutes par appel — un vrai navigateur ouvre le post et écrit le commentaire. Réglez le timeout de votre client en conséquence.

Un tool en échec ne lève jamais une exception JSON-RPC : il rend un résultat marqué isError: true, avec une phrase lisible par l'agent. Quatre cas n'existent que côté MCP.

Le message de quota porte le délai de réattente, pour que votre agent sache quand reprendre au lieu de boucler :

Rate limit exceeded for generate_reddit_comment:
20 calls per minute maximum. Retry in 34 seconds.
No credits were charged.

Le refus arrive avant toute logique métier : rien n'est appelé, rien n'est débité. Un agent qui épuise ses 20générations par minute n'a perdu aucun crédit.

Les codes HTTP et le format des erreurs de l'API REST sont décrits sur la page codes d'erreur.