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 時に予約しました。

---

ツール（5）

ツール	説明
validate_api_key	API キーが有効か確認し、そのメタデータを返します。
list_accounts	Plus Tard に接続されたすべてのソーシャルネットワークアカウントを一覧表示します。
schedule_post	1 つのネットワークに投稿を予約します（1 回の呼び出しにつき 1 ネットワーク）。
register_user	新しいユーザーを作成し、OAuth URL を返します。
get_user	ユーザーの詳細：接続済みのプロバイダーとサブアカウント。

リソース（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（web）

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

Cursor / n8n

URL とヘッダーは同じです。完全なドキュメントを参照してください。

---

セルフホスト（開発者向け）

技術スタック

• 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 によるデプロイ（本番環境）

このリポジトリには、nginx-proxy + acme-companion を使用する VPS 向けの Dockerfile と docker-compose.yml が用意されています：

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 ヘッダーで行われます。トークンはサーバー側に保存されません。

許可されたホスト

MCP SDK は DNS リバインディング対策を有効にしており、ホワイトリストに登録されたホストのみを許可します。デフォルトのホストは次のとおりです：

• 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フロー（キーをコピーして貼り付ける方式の代わり）
• page_idの候補提示に向けたMCPのcompletion/completeサポート （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.

フランスで❤️を込めて作成。