RemplirPDF

RemplirPDF MCP 服务

让你的 AI Agent 准备法国租赁文件：带家具和不带家具的租约、房屋状况清单（état des lieux）、 租金收据（quittances）、租金通知、担保契约、退租通知和证明。Agent 会选择合适的模板，询问你缺少的信息，并在你的 RemplirPDF 账户中生成已填写的 PDF，其中已写好法律条款。

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]

Agent 可以做什么

工具	功能	行为
list_templates	列出 RemplirPDF 目录中的租赁模板（slug、类别、签署人）。请先调用。	只读
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") → Agent 询问房东姓名 → generate_document(...) → PDF 链接。

连接

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

添加服务 URL；你的客户端会打开 RemplirPDF，你登录（或创建账户）并点击授权。你可以随时断开连接。访问令牌有效期为一小时，连接处于活动状态时会自动刷新。

• 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	none	你账户的 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 账户）。

安全与隐私

• OAuth 2.1（使用 PKCE（S256））、精确的重定向 URI、与受众绑定的一小时令牌（RFC 8707）、轮换刷新 令牌、撤销（RFC 7009）、动态客户端注册（RFC 7591）和客户端 ID 元数据文档。
• 生成的文档保存在你的 RemplirPDF 账户中；下载链接将在 24 小时后过期。
• 个人数据的处理方式如隐私政策所述：https://remplirpdf.fr/confidentialite

许可证

MIT，详见 LICENSE。RemplirPDF 是一项私人服务，与法国行政部门无关联。