Mcp Plus Tard

Plus Tard MCP

通过简单对话，将您的 AI 助手（Claude、Cursor、n8n…）连接到 Plus Tard，以规划您在 Facebook、Instagram、LinkedIn、X/Twitter、TikTok、Threads、Bluesky 和 Google My Business 上发布的内容。

生产环境端点：https://mcp.plus-tard.com/mcp/ 用户文档：https://plus-tard.com/api-mcp

---

30 秒演示

您：「明天 10 点在我的 Boréales 页面上安排一篇 Facebook 帖子："Hello le monde !"」

Claude 自动调用：

1. list_accounts → 查找 "Boréales" 的 Facebook ID
2. schedule_post(provider="facebook", page_id="…", planned_at="2026-05-05T10:00:00Z", text="Hello le monde !")

Plus Tard：✅ 已安排帖子 #1432，于 2026 年 5 月 5 日 10:00 发布。

---

工具（5 个）

工具	说明
validate_api_key	检查 API 密钥是否有效，并返回其元数据。
list_accounts	列出已连接到 Plus Tard 的所有社交网络账号。
schedule_post	在单个社交网络上安排一篇帖子（1 次调用 = 1 个社交网络）。
register_user	创建新用户并返回 OAuth URL。
get_user	用户详情：已连接的 provider 和子账号。

资源（2 个）

URI	内容
plus-tard://accounts	已连接账号的 JSON 列表。
plus-tard://users/{id}	用户的 JSON 详情。

---

客户端安装

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "plus-tard": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.plus-tard.com/mcp/",
        "--header",
        "X-Api-Key:${PLUS_TARD_TOKEN}"
      ],
      "env": {
        "PLUS_TARD_TOKEN": "your_plus_tard_api_key"
      }
    }
  }
}

Claude Code（CLI）

claude mcp add plus-tard \
  --transport http https://mcp.plus-tard.com/mcp/ \
  --header "X-Api-Key: your_plus_tard_api_key"

Claude.ai（网页）

Settings → Connectors → Add custom connector — URL https://mcp.plus-tard.com/mcp/，header X-Api-Key: your_key。

Cursor / n8n

使用相同的 URL 和 header。请参阅完整文档。

---

自托管（面向开发者）

技术栈

• Python 3.12 · FastAPI · mcp[fastapi]（Streamable HTTP 传输）
• httpx · pydantic v2 · pydantic-settings
• pytest · pytest-asyncio · respx

架构

Client (Claude/Cursor/n8n)
   │  Streamable HTTP + X-Api-Key header
   ▼
MCP server (this repo)
   │  X-Api-Key forwarded as-is
   ▼
Plus Tard Symfony API

每个 MCP 请求都会携带 X-Api-Key，并原样传递给 Plus Tard API。没有会话，也不在服务端存储数据——每个 客户端都使用自己的密钥。

本地开发

git clone https://github.com/<votre-org>/plus-tard-mcp.git
cd plus-tard-mcp

python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

cp .env.example .env
# Édite .env : PLUS_TARD_BASE_URL=https://plus-tard.com

uvicorn main:app --reload --port 8001

服务会监听 http://127.0.0.1:8001/mcp/。可使用 MCP Inspector 快速测试：

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP
# URL: http://127.0.0.1:8001/mcp/
# Header: X-Api-Key = ta_clef_plus_tard

测试

pytest
# 24 passed

Docker 部署（生产环境）

仓库提供了可直接用于 VPS 的 Dockerfile 和 docker-compose.yml， 适配 nginx-proxy + acme-companion：

sudo docker compose up -d --build

详情请参阅 deploy/README.md（支持 SSE 的 nginx-proxy 片段、Let's Encrypt TLS 管理、更新）。

---

配置

变量	说明	默认值
PLUS_TARD_BASE_URL	Plus Tard API 的基础 URL	(必需)
MCP_HOST	uvicorn 绑定的主机	0.0.0.0
MCP_PORT	uvicorn 绑定的端口	8001

身份验证通过每个请求中的 X-Api-Key header 完成—— 服务端不会存储任何令牌。

允许的主机

MCP SDK 会启用 DNS rebinding 防护，只允许白名单中的主机。 默认主机如下：

• mcp.plus-tard.com
• localhost、127.0.0.1（用于开发）

如需添加您自己的域名，请编辑 main.py （TransportSecuritySettings.allowed_hosts）中的列表。

---

项目结构

.
├── main.py                # FastAPI + FastMCP + middleware X-Api-Key
├── app/
│   ├── config.py          # Settings via pydantic-settings
│   ├── auth/              # Dependency X-Api-Key (réutilisable hors MCP)
│   ├── models/            # Schémas pydantic v2 (post, account, user)
│   ├── services/          # PlusTardClient async (httpx)
│   └── tools/             # 5 tools métier (str → str)
├── tests/                 # 24 tests pytest-asyncio
├── deploy/
│   ├── README.md          # Guide déploiement VPS
│   ├── vhost.d/           # Snippet nginx-proxy SSE
│   └── twig/              # Template Symfony pour la doc utilisateur
├── docs/index.html        # Doc utilisateur statique (HTML)
├── Dockerfile
├── docker-compose.yml
└── pyproject.toml

---

安全

• 生产环境仅使用 HTTPS（通过 Let's Encrypt 实现 TLS）。
• 不记录帖子内容或 API 令牌。
• 通过 MCP SDK 的 TransportSecuritySettings 防范 DNS 重绑定。
• 多租户隔离：每个请求都使用独立的 httpx 客户端处理，并在请求结束时关闭（不跨用户共享连接池）。
• 如果怀疑密钥已泄露，请从 Plus Tard 账户中撤销。

---

路线图

• 结构化日志（JSON，不包含令牌或内容）
• 按 API 密钥进行速率限制
• Prometheus 指标
• 为连接器提供 OAuth 流程（而非复制粘贴 API 密钥）
• 支持 MCP completion/complete，用于建议 page_id （等待提供 ToolReference 的 Python SDK）

欢迎提出想法和贡献 — 请提交 issue 或 PR。

---

有用链接

• 用户文档
• Plus Tard API（v1.2）
• MCP 规范
• MCP Inspector
• mcp-remote（适用于 Claude Desktop 的 stdio↔HTTP 桥接）

---

许可证

MIT © 2026 Plus Tard — Boréales Créations。

❤️ 制作于法国。