Développeurs · API · MCP

Construisez sur PurrPlan.

Une API REST et un serveur MCP natif pour planifier, publier et piloter vos 12 réseaux depuis votre code, votre agent IA (Claude, Cursor…) ou votre terminal.

Connecter à Claude / Cursor Voir l’API REST

REST · /app/api MCP · /api/mcp JSON-RPC 2.0 · 2025-06-18

01 · Authentification

Un token, deux surfaces.

Le même token bearer ouvre l’API REST et le serveur MCP. Créez-le en 30 secondes depuis votre compte, avec les scopes que vous choisissez.

1. Ouvrez app.purrplan.ai/app/mcp-integration
2. Créez un token : nom, expiration (30/90/365 j ou jamais), et les scopes souhaités.
3. Copiez le token (affiché une seule fois) et passez-le en en-tête.

# en-tête d’auth (REST & MCP)

Authorization: Bearer $TOKEN

# bases

REST app.purrplan.ai/app/api

MCP app.purrplan.ai/api/mcp

Les clients MCP compatibles OAuth peuvent aussi enregistrer un client dynamiquement (DCR + PKCE) sur /app/oauth.

02 · API REST

Créez et programmez par HTTP.

Base https://app.purrplan.ai/app/api. Le {workspace} est l’uuid de votre espace de travail.

Méthode	Endpoint	Rôle
GET	/me	Utilisateur courant
GET	/workspaces	Vos espaces de travail
GET	/{workspace}/accounts	Comptes sociaux connectés
GET	/{workspace}/posts	Lister les posts (paginé)
POST	/{workspace}/posts	Créer un post (brouillon, programmé, file ou immédiat)
POST	/{workspace}/posts/schedule/{post}	Programmer un post existant
POST	/{workspace}/posts/add-to-queue/{post}	Ajouter au prochain créneau libre
GET	/{workspace}/media	Bibliothèque média
POST	/{workspace}/media	Uploader un média
POST	/{workspace}/ai/text/generate	Générer du texte via IA

Exemple — créer & programmer un post

# POST /app/api/{workspace}/posts curl -X POST https://app.purrplan.ai/app/api/$WS/posts \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "accounts": [12, 18], "date": "2026-07-25", "time": "09:30", "timezone": "Europe/Paris", "schedule": true, "versions": [ { "account_id": 0, "is_original": true, "content": [{ "body": "Notre produit est là 🎉" }] } ] }'

201 → le post (uuid, versions, scheduled_at)

account_id: 0 = version « originale » appliquée à tous. Remplacez schedule par queue: true (prochain créneau libre) ou schedule_now: true (publication immédiate). Sans date ni flag → brouillon.

03 · Serveur MCP

Branchez votre agent IA.

Serveur MCP natif (Model Context Protocol, spec 2025-06-18, JSON-RPC 2.0 sur HTTP + SSE). Connectez Claude Desktop, Cursor ou tout client MCP et laissez votre IA planifier pour vous — avec des permissions que vous contrôlez.

Config client (URL + Bearer)

{ "mcpServers": { "purrplan": { "url": "https://app.purrplan.ai/api/mcp", "headers": { "Authorization": "Bearer $TOKEN" } } } }

Client stdio uniquement ? Passez par un pont type mcp-remote.

7 tools · scope requis

list_workspaces read

Liste vos espaces de travail.

—

list_accounts read

Comptes sociaux connectés (id, provider…).

workspace_uuid

list_posts read

Liste des posts (contenu, statut, date).

workspace_uuid, status?, limit?

get_post read

Détail d’un post (versions par réseau).

workspace_uuid, post_uuid

generate_ai_text ai

Génère un texte de post (consomme des crédits).

workspace_uuid, prompt, tone?…

create_draft_post write

Crée un post — brouillon, ou programmé si scheduled_at.

workspace_uuid, account_ids, content, scheduled_at?

upload_media_from_url media

Ingère un média depuis une URL publique.

workspace_uuid, url, type?

Scopes

Donnez juste ce qu’il faut.

read Lecture — workspaces, comptes, posts

write Écriture — créer / programmer des posts

ai IA — génération de texte (consomme les crédits)

media Médias — upload, gestion de la bibliothèque

Limites

Débits par défaut.

API REST & MCP 100 requêtes / min / utilisateur

Génération IA 20 / min / utilisateur

Upload média 30 / min / utilisateur

OAuth (token) 10 / min / IP

Dépassement → 429.

Prêt à construire ?

Créez votre token et branchez votre premier appel en quelques minutes. Dès 9 €/mois, essai 7 jours.

Démarrer gratuitement Créer un token