プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Aides sociales françaises

作者:audescs-specバージョン 1.2.1i★ 0iクラウドで動くリポジトリ ↗
レジストリ名io.github.audescs-spec/mcp-aides-sociales

インストール方法

What it does

API MCP developpeurs: RSA, prime d'activite, APL/ALS. Calculs via OpenFisca (AGPL-3.0).

  • Connects クラウドで動く
  • Account or key Needs X-API-Key
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ7/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア15/100

品質: 基本チェック 2/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Aides sociales françaises をインストールして。https://mcp.popnx.com/i/audescs-spec-mcp-aides-sociales.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 2/5 合格 · 質問内容は提供元のサーバー(mcp-aides-sociales.onrender.com)を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

Aides sociales françaises のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Aides sociales françaises に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Aides sociales françaises
    Remote MCP server URL · アドレスhttps://mcp-aides-sociales.onrender.com/mcp

    Request headers に、この名前と値を追加

    ヘッダー名X-API-Key
    値<ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsAides sociales françaises

  5. 試してみる

    Aides sociales françaises を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Aides sociales françaises を使っていると言うか、回答に Aides sociales françaises のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Aides sociales françaises につなげません

Aides sociales françaises は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · Aides sociales françaises につなげるアプリを使う

  • Aides sociales françaises のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • Aides sociales françaises のキーが必要です(提供元のサイトで作成)
  • Aides sociales françaises のキーが必要です(提供元のサイトで作成)
  • Aides sociales françaises のキーが必要です(提供元のサイトで作成)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

Aides sociales françaises のキーが必要です(提供元のサイトで作成)

  1. Aides sociales françaises に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user aides-sociales https://mcp-aides-sociales.onrender.com/mcp --header 'X-API-Key: your-value'

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    Aides sociales françaises が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Aides sociales françaises を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Aides sociales françaises を使っていると言うか、回答に Aides sociales françaises のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

Aides sociales françaises のキーが必要です(提供元のサイトで作成)

  1. Aides sociales françaises に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    Aides sociales françaises の設定で X-API-Key が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    Aides sociales françaises を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Aides sociales françaises を使っていると言うか、回答に Aides sociales françaises のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

Aides sociales françaises のキーが必要です(提供元のサイトで作成)

  1. Aides sociales françaises に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    Aides sociales françaises の設定で X-API-Key が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    Aides sociales françaises を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Aides sociales françaises を使っていると言うか、回答に Aides sociales françaises のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp-aides-sociales.onrender.com/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Aides sociales françaises を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user aides-sociales https://mcp-aides-sociales.onrender.com/mcp --header 'X-API-Key: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aides-sociales": {
      "url": "https://mcp-aides-sociales.onrender.com/mcp",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "aides-sociales": {
      "type": "http",
      "url": "https://mcp-aides-sociales.onrender.com/mcp",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

自分で入力する値

  • X-API-Key 秘密 必須 HTTP header
    Cle d'acces personnelle (palier gratuit via /signup-free, ou abonnement)

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
ライセンスi
ライセンスの記載なし
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
1.2.1
カテゴリi
その他
レジストリ公開日i
2026年9月4日
コードの最終更新i
2026年9月4日
最終確認
2026年11月15日
作者
audescs-spec
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント audescs-spec で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:3 か月前

  • ✕ 不合格

    ライセンスがある

    リポジトリにライセンスファイルが見つかりません

  • ! 注意

    エンドポイントが応答する

    アクセスを拒否(HTTP 401)し、OAuth ログインもありません。キーが必要か、ボット対策の可能性があり、未確認です。

  • ! 注意

    OAuthでサインイン

    キーやトークンを自分でコピーして貼り付ける必要があります

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/audescs-spec-mcp-aides-sociales.svg)](https://mcp.popnx.com/en/servers/audescs-spec-mcp-aides-sociales)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20613件のうち0%よりスターが多い
  • このカテゴリのほかの20613件のうち27%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20613件のうち8%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Aides sociales françaisesは安全ですか?

当てはまる基本チェック5項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:X-API-Key

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は3 か月前、最新バージョン(1.2.1)がレジストリに届いたのは3 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Aides sociales françaises
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック2/54/44/44/41/44/4
ライセンス–AGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Serveur MCP - Aides sociales françaises

Ce service est une API/MCP pensée pour les développeurs et les agents IA qui l'intègrent dans leurs propres logiciels — pas un simulateur grand public à usage isolé. Elle calcule le RSA, la prime d'activité et l'aide au logement (APL/ALS/ALF) pour un foyer français, à partir de quelques informations simples : salaire, loyer, statut du logement, nombre d'enfants, situation de couple.

Le calcul est fait entièrement en local, avec la bibliothèque open source openfisca-france (le moteur officiel des barèmes sociaux français). Aucun appel n'est fait à l'API publique api.fr.openfisca.org ni à un autre service externe.

⚠️ Important : ce sont des estimations, pas des décisions officielles. Le calcul repose sur des hypothèses simplificatrices (âge des adultes supposé, situation stable sur les derniers mois, etc.). Seule la CAF ou la MSA peut donner un montant définitif et exact.

Crédits

Calculs effectués avec OpenFisca, moteur socio-fiscal libre et open source sous licence AGPL-3.0. Code source : github.com/openfisca/openfisca-france.

Adresse du serveur et accès

https://mcp-aides-sociales.onrender.com/mcp

Ce service est protégé par une clé d'accès (API key) : chaque appel doit la fournir, sinon le serveur refuse de répondre. Deux paliers, 100% self-service (aucune validation manuelle) :

PalierQuotaPrixObtenir une clé
Free50 requêtes/mois0 € (sans carte bancaire)POST /signup-free avec {"email": "..."}
StandardIllimité29 €/moisbuy.stripe.com/9B628q5Pb7t9a0QdurgEg01

Palier Free — inscription immédiate, sans carte bancaire :

curl -X POST https://mcp-aides-sociales.onrender.com/signup-free \

-H "Content-Type: application/json" \ -d '{"email": "vous@example.com"}'

Une clé (préfixe free_...) est envoyée par email. Le quota (50 requêtes/mois) se réinitialise automatiquement au début de chaque mois. Au-delà, le serveur répond 402 Payment Required avec un message invitant à passer au palier Standard — jamais une simple erreur sèche.

Palier Standard — après paiement de l'abonnement, une clé d'accès personnelle (illimitée) est envoyée automatiquement par email, et renouvelée à chaque paiement mensuel réussi.

Installer dans Claude Desktop

  1. Ouvrez le fichier de configuration de Claude Desktop :
  • Sur Mac : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Sur Windows : %APPDATA%\Claude\claude_desktop_config.json
  1. Ajoutez (ou complétez) la section mcpServers ainsi :
{

"mcpServers": { "aides-sociales-france": { "url": "https://mcp-aides-sociales.onrender.com/mcp", "headers": { "X-API-Key": "VOTRE_CLE_API" } } } }

  1. Remplacez VOTRE_CLE_API par la clé qui vous a été transmise.
  2. Redémarrez Claude Desktop.

Installer dans Cursor

  1. Ouvrez les réglages MCP de Cursor (Settings → MCP → Add new MCP server, ou le fichier ~/.cursor/mcp.json).
  2. Ajoutez la même configuration que ci-dessus :
{

"mcpServers": { "aides-sociales-france": { "url": "https://mcp-aides-sociales.onrender.com/mcp", "headers": { "X-API-Key": "VOTRE_CLE_API" } } } }

  1. Remplacez VOTRE_CLE_API par votre clé, puis rechargez Cursor.

Exemple de question à poser une fois connecté

« J'habite seul(e) à Paris, je gagne 900 euros nets par mois (environ

1150 euros bruts), je paie 500 euros de loyer et je n'ai pas d'enfant.

Est-ce que j'ai droit au RSA, à la prime d'activité, et à l'APL, et

pour quel montant ? »

L'assistant utilisera automatiquement les outils calculer_aides_sociales et calculer_apl et répondra avec les montants mensuels estimés.

Note technique : premier appel parfois lent

Le serveur est hébergé sur un plan gratuit. S'il n'a pas été utilisé depuis un moment, il peut mettre 30 à 60 secondes à répondre à la toute première question (le temps de "se réveiller"). Les questions suivantes sont ensuite rapides.

Les outils exposés

calculer_aides_sociales (RSA + prime d'activité)

Paramètres :

  • salaire_net_mensuel (nombre) : salaire net mensuel du demandeur, en euros.
  • loyer_mensuel (nombre) : loyer mensuel du foyer, en euros.
  • statut_occupation_logement (texte) : un parmi proprietaire, primo_accedant, locataire_hlm, locataire_vide, locataire_meuble, loge_gratuitement, locataire_foyer, sans_domicile.
  • nombre_enfants (entier) : nombre d'enfants à charge.
  • en_couple (vrai/faux).
  • salaire_net_mensuel_conjoint (nombre, optionnel) : à fournir si en_couple est vrai.
  • code_insee_commune (texte, optionnel) : code INSEE (depcom) de la commune, 5 caractères (ex: 75056 pour Paris). Affine une vérification interne au calcul du forfait logement du RSA (zone APL). En son absence, la zone 2 est utilisée par défaut pour cette vérification uniquement — cela ne change généralement pas le RSA/la prime d'activité renvoyés (voir *Le forfait logement du RSA* ci-dessous).

Retourne le mois de calcul, le RSA mensuel estimé, la prime d'activité mensuelle estimée, et les hypothèses retenues pour le calcul.

calculer_apl (aide au logement : APL, ALS ou ALF selon éligibilité)

Paramètres :

  • salaire_brut_mensuel (nombre) : salaire brut mensuel du demandeur (avant cotisations, en haut du bulletin de paie) — pas le salaire net utilisé par calculer_aides_sociales. Nécessaire pour qu'openfisca-france recalcule correctement, via son propre moteur de paie, le revenu imposable utilisé dans la base ressources "temps réel" de l'aide au logement (réforme 2021).
  • loyer_mensuel (nombre) : loyer réellement payé, hors charges. En cas de colocation, indiquer uniquement la part personnelle.
  • code_insee_commune (texte, obligatoire pour cet outil) : code INSEE de la commune, 5 caractères — pas le code postal. La zone APL en est déduite automatiquement (fichier de zonage embarqué dans openfisca-france, 37 000+ communes, aucun appel réseau). Un code inconnu est rejeté explicitement plutôt que de retomber sur une zone par défaut.
  • statut_occupation_logement (texte) : proprietaire, locataire_hlm, locataire_vide, locataire_meuble, loge_gratuitement, sans_domicile sont calculés (les 3 derniers donnent légitimement 0 €, non-éligibilité réelle). primo_accedant et locataire_foyer sont hors périmètre : l'outil renvoie une erreur explicite plutôt qu'un montant approximatif (voir *Ce que calculer_apl ne couvre pas*).
  • nombre_enfants, en_couple, salaire_brut_mensuel_conjoint : identiques en principe à calculer_aides_sociales (mais en brut).
  • en_colocation (vrai/faux, optionnel, défaut faux) : applique le plafond de loyer réduit prévu pour les colocataires.

Retourne le mois de calcul, l'aide au logement mensuelle estimée, le dispositif applicable (APL, ALS ou ALF), les hypothèses de calcul, et un descriptif explicite de ce que le calcul couvre ou non.

Ce que calculer_apl ne couvre pas
  • Accession à la propriété avec prêt en cours (primo_accedant) : dépend de la date exacte du prêt, non collectée ici, et n'est presque plus ouvert aux nouveaux prêts depuis 2018.
  • Logement-foyer / résidence universitaire ou CROUS (locataire_foyer) : openfisca-france marque lui-même ce statut "non calculable" par la formule standard.
  • Revenus non salariés : indépendants, chômage indemnisé, retraite, pension d'invalidité, revenus du patrimoine ne sont pas modélisés — seul un revenu salarié stable est pris en compte.
  • Personnes âgées/handicapées hébergées à titre onéreux, chambres meublées spécifiquement.
Le forfait logement du RSA (pourquoi RSA et APL s'additionnent)

Le RSA renvoyé par calculer_aides_sociales intègre déjà un forfait logement : une déduction forfaitaire fixe, prévue par la loi (environ 12 % du montant de base du RSA pour une personne seule), appliquée dès que le foyer est logé (loyer payé, logé gratuitement, ou propriétaire). Ce n'est pas une estimation du montant réel d'aide au logement — c'est un taux légal indépendant, donc le RSA renvoyé ici et le montant renvoyé par calculer_apl peuvent bien être additionnés : un allocataire perçoit réellement le RSA (déjà minoré de ce forfait fixe) plus son APL/ALS/ALF entière.

Faire tourner ce serveur soi-même (en local)

python -m venv .venv

source .venv/bin/activate pip install -r requirements.txt API_KEY=une-cle-secrete-a-vous python src/server.py

Le serveur écoute en HTTP sur le port défini par la variable d'environnement PORT (8000 par défaut), sur le chemin /mcp.

Comment fonctionne la clé d'accès

Le serveur ne stocke jamais la clé en clair : le code contient uniquement son empreinte SHA-256 (un hachage à sens unique, impossible à inverser). Une clé fournie par un client n'est acceptée que si son empreinte correspond. Cela permet au service de fonctionner "prêt à l'emploi" sans configurer de variable d'environnement chez l'hébergeur (utile quand, comme sur Render en mode "Blueprint managed", il n'est pas toujours possible d'ajouter une variable depuis le tableau de bord).

Pour remplacer la clé sans changer le code (par exemple en local, ou chez un hébergeur qui permet les variables d'environnement) :

  • API_KEY=votre-cle python src/server.py (la clé en clair est hachée au démarrage), ou
  • API_KEY_SHA256=votre-empreinte python src/server.py (empreinte déjà calculée).

Pour changer définitivement la clé par défaut : calculez l'empreinte SHA-256 de la nouvelle clé et remplacez la constante _EMPREINTE_CLE_API_PAR_DEFAUT dans src/server.py.

Protections en place

  • Clé d'accès obligatoire (voir ci-dessus) sur tous les appels de calcul.
  • Validation stricte des données reçues (montants, nombre d'enfants, types) : toute requête malformée ou avec des valeurs absurdes est rejetée proprement, sans jamais faire planter le serveur.
  • Limitation du nombre de requêtes par adresse IP (au-delà d'un certain nombre d'appels par minute, le serveur répond "trop de requêtes" au lieu de traiter la demande), pour éviter qu'un usage répété abusif ne surcharge ce service hébergé sur un plan gratuit.

Déploiement

  • render.yaml : configuration prête pour un déploiement sur Render.com (type "Blueprint").
  • nixpacks.toml / Procfile : configuration prête pour Railway.app.

Paiement Stripe et envoi automatique de la clé (pour les mainteneurs)

Le service peut être vendu via un Stripe Payment Link. Un webhook (POST /webhook/stripe, non protégé par la clé d'accès) écoute deux événements :

  • checkout.session.completed (mode paiement unique uniquement) : cas historique de l'ancien Payment Link one_time, aujourd'hui désactivé. Génère une clé d'accès à vie, dérivée par HMAC-SHA256 de l'identifiant de session Stripe et d'un secret serveur.
  • invoice.paid (abonnement mensuel, cas actuel) : à chaque paiement d'abonnement réussi (initial ou renouvellement), génèr

冒頭だけを表示しています。続きはリポジトリで読めます