RemplirPDF

RemplirPDF MCP サーバー

AI エージェントがフランスの賃貸書類を作成できるようにします。家具付き・家具なしの賃貸借契約書、物件状況確認書（état des lieux）、 家賃領収書（quittances）、家賃通知書、保証人契約書、解約通知書、証明書に対応しています。エージェントが適切な テンプレートを選び、不足している情報を質問し、法的条項があらかじめ記載された記入済み PDF をお客様のRemplirPDF アカウントに生成します。

RemplirPDF の MCP サーバー：AI アシスタントが賃貸借契約書、物件状況確認書、家賃領収書、証明書を、法的条項をあらかじめ記載した記入済み PDF として作成します。フランス語のドキュメント：https://remplirpdf.fr/mcp

• リモートサーバー（推奨）：https://remplirpdf.fr/api/mcp（Streamable HTTP、OAuth 2.1 または API キー）
• レジストリ名：fr.remplirpdf/mcp-server
• ドキュメント：https://remplirpdf.fr/mcp · プライバシー：https://remplirpdf.fr/confidentialite · 利用規約：https://remplirpdf.fr/cgv · サポート：[email protected]

エージェントでできること

ツール	内容	動作
list_templates	RemplirPDF カタログの賃貸テンプレート（スラッグ、カテゴリー、署名者）を一覧表示します。最初に呼び出してください。	読み取り専用
get_template	テンプレートのフィールド（必須かどうか、想定形式、選択肢、計算フィールド、署名者）を取得します。生成前に呼び出してください。	読み取り専用
generate_document	ユーザーから提供された値をテンプレートに記入し、PDF をユーザーのアカウントに保存して、24 時間有効なダウンロードリンクを返します。document_id を指定すると、同じテンプレートから以前に作成した書類を置き換えます。	書き込み（上書きされる場合があります）
list_documents	アカウント内の最新の賃貸書類を一覧表示します。	読み取り専用
get_download_link	アカウント内の書類について、新しい24時間有効のダウンロードリンクを取得します。	読み取り専用

すべてのツールには、タイトル、使用する状況の説明、パラメーターの説明、明示的な readOnlyHint / destructiveHint / openWorldHint の注釈、および outputSchema があります（結果は structuredContent として返されます）。

書類の生成とダウンロードリンクの取得には、有効な RemplirPDF サブスクリプションが必要です。サブスクリプションがない場合、ツールは 明確なメッセージを表示して処理を拒否します。支払いを開始したり、カードに課金したりするツールは一切ありません。書類は実際の賃貸契約を反映している必要があり、 第三者を誤解させるための書類を作成することを目的としたサーバーではありません。

例：「Paul Martin の9月分の家賃領収書を作成してください。家賃は750 €、諸費用は80,50 €、住所はリヨンの12 rue des Lilas です。」 → list_templates → get_template("quittance-de-loyer") → エージェントが家主の氏名を尋ねる → generate_document(...) → PDF リンク。

接続

OAuth（Claude、ChatGPT、Claude Code、Cursor、VS Code）

サーバー URL を追加すると、クライアントが RemplirPDF を開きます。サインイン（またはアカウントを作成）して、Autoriser をクリックしてください。接続は いつでも解除できます。アクセストークンの有効期間は1時間で、接続がアクティブな間は自動的に更新されます。

• Claude（claude.ai、Claude Desktop）：Settings → Connectors → Add custom connector → https://remplirpdf.fr/api/mcp → Connect。
• ChatGPT：Settings → Apps → developer mode → Create app → https://remplirpdf.fr/api/mcp、認証方式は OAuth。
• Claude Code：claude mcp add --transport http remplirpdf https://remplirpdf.fr/api/mcp を実行し、続いて /mcp でサインインします。
• Cursor（~/.cursor/mcp.json）および VS Code（.vscode/mcp.json、"type": "http" を指定）：URL を使用すると、エディターからサインインするよう案内されます。

このリポジトリの .mcp.json / mcp.json には、同じリモート設定が含まれています（シークレットは含まれません）。

API キー（ヘッダーを送信できる任意のクライアント）

アカウント（https://remplirpdf.fr/app/compte、「Clés API」）でキーを作成します。キーは一度だけ表示され、ハッシュのみが 保存されます。キーはいつでも無効にできます。Authorization: Bearer rpdf_… として送信します（Bearer プレフィックスは 省略できます）。

# Codex CLI, ~/.codex/config.toml (then export REMPLIRPDF_API_KEY)
[mcp_servers.remplirpdf]
url = "https://remplirpdf.fr/api/mcp"
bearer_token_env_var = "REMPLIRPDF_API_KEY"

ローカル stdio サーバー（このリポジトリ）

stdio のみで通信するクライアント向けです。リモートツールとまったく同じツールを公開し（定義は稼働中のサーバーから src/tools.json に生成されます）、API キーを使用して RemplirPDF の HTTPS API 経由で実行します。

# npm (Node.js 20+), nothing to install
REMPLIRPDF_API_KEY=rpdf_your_key npx -y remplirpdf-mcp

{
  "mcpServers": {
    "remplirpdf": {
      "command": "npx",
      "args": ["-y", "remplirpdf-mcp"],
      "env": { "REMPLIRPDF_API_KEY": "rpdf_your_key" }
    }
  }
}

または、このリポジトリから実行します。

# Docker
docker build -t remplirpdf-mcp .
docker run -i --rm -e REMPLIRPDF_API_KEY=rpdf_your_key remplirpdf-mcp

# From source (Node.js 20+)
npm ci && npm run build
REMPLIRPDF_API_KEY=rpdf_your_key node dist/index.js

{
  "mcpServers": {
    "remplirpdf": {
      "command": "node",
      "args": ["/path/to/remplirpdf-mcp/dist/index.js"],
      "env": { "REMPLIRPDF_API_KEY": "rpdf_your_key" }
    }
  }
}

変数	デフォルト
REMPLIRPDF_API_KEY	なし	アカウントの API キーです。設定しなくてもサーバーは起動してツールを一覧表示しますが、ツールの呼び出し時にキーの設定方法が表示されます。
REMPLIRPDF_MCP_URL	https://remplirpdf.fr/api/mcp	ツールの送信先エンドポイントです。

メンテナンス：npm run sync-tools は、稼働中のサーバーから src/tools.json を再生成します（REMPLIRPDF_API_KEY を設定した場合は tools/list、設定しない場合は公開カード /.well-known/mcp/server-card.json を使用します）。npm test は stdio のスモークテストを実行します。npm run interop -- https://remplirpdf.fr は、公式 MCP SDK クライアントを使用してリモートの OAuth フローとツールを確認します（一時的な RemplirPDF アカウントを作成します）。

セキュリティとプライバシー

• PKCE（S256）を使用する OAuth 2.1、完全一致のリダイレクト URI、オーディエンスに紐づく有効期間 1 時間のトークン（RFC 8707）、ローテーションするリフレッシュトークン、失効（RFC 7009）、動的クライアント登録（RFC 7591）、クライアント ID メタデータドキュメントに対応しています。
• 生成されたドキュメントは RemplirPDF アカウント内に保存されます。ダウンロードリンクの有効期限は 24 時間です。
• 個人データはプライバシーポリシーに記載のとおり処理されます：https://remplirpdf.fr/confidentialite

ライセンス

MIT。詳細は LICENSE をご覧ください。RemplirPDF は民間サービスであり、フランス政府機関とは提携していません。