Développeurs · API · MCP

Ton agent IA pilote tes 12 réseaux. Nativement.

Un token, 12 réseaux, 12 systèmes d'auth en moins à maintenir. API REST + serveur MCP natif : dis à Claude ou Cursor « prépare ma semaine » — c'est fait. Buffer et Hootsuite n'ont pas ça.

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ée-le en 30 secondes depuis ton compte, avec les scopes que tu choisis.

1. Ouvre app.purrplan.ai/app/mcp-integration
2. Crée un token : nom, expiration (30/90/365 j ou jamais), et les scopes souhaités.
3. Copie le token (affiché une seule fois) et passe-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

Évalue le serveur avant de créer un compte

La poignée de main MCP est ouverte : initialize, ping et tools/list répondent sans jeton, et renvoient les 18 outils avec leurs schémas d’entrée. Tu peux donc inspecter ce que PurrPlan sait faire, depuis ton terminal ou ton client MCP, avant toute inscription. Appeler un outil (tools/call) exige un jeton — c’est la seule chose qui en demande un.

# aucun jeton requis

curl -s -X POST https://app.purrplan.ai/api/mcp \

-H 'Content-Type: application/json' \

-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

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

Librairie gratuite (MIT), sans SDK payant : github.com/sebastiendb/purrplan-mcp. Elle encapsule les 18 tools ci-dessous vers /api/mcp. Le jeton vient de ton compte.

02 · API REST

Crée et programme par HTTP.

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

Méthode	Endpoint	Rôle
GET	/me	Utilisateur courant
GET	/workspaces	Tes 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. Remplace schedule par queue: true (prochain créneau libre) ou schedule_now: true (publication immédiate). Sans date ni flag → brouillon.

03 · Serveur MCP

Branche ton agent IA.

Serveur MCP natif (Model Context Protocol, spec 2025-06-18, JSON-RPC 2.0 sur HTTP + SSE). Connecte Claude Desktop, Cursor ou tout client MCP et laisse ton IA planifier pour toi — avec des permissions que tu contrôles.

Config client (URL + Bearer)

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

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

18 tools · scope requis

list_workspaces read

Liste tes 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?

create_stories write

Crée des stories (Instagram, Facebook).

workspace_uuid, account_ids, media_ids

update_draft_post write

Modifie un brouillon existant.

workspace_uuid, post_uuid, content?, scheduled_at?

delete_post write

Supprime un post non publié.

workspace_uuid, post_uuid

upload_media_from_url media

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

workspace_uuid, url, type?

list_inbox inbox:read

Conversations et commentaires reçus.

workspace_uuid, status?, type?, limit?

get_inbox_thread inbox:read

Fil complet d’une conversation.

workspace_uuid, message_id

manage_inbox_messages inbox:read

Marquer lu, archiver, confier à un membre.

workspace_uuid, message_ids, action

refresh_inbox inbox:read

Relève les nouveaux messages chez les réseaux.

workspace_uuid, account_id?

reply_to_inbox_message inbox:reply

ENVOI RÉEL — répond au nom du compte. Confirmation obligatoire.

workspace_uuid, message_id, text, confirm

plan_my_week write + ai

Une semaine de contenu générée et posée sur tes créneaux.

workspace_uuid, brief, count?, schedule?

get_analytics analytics:read

Abonnés, portée, engagement, clics + ventilation par réseau.

workspace_uuid, days?

get_top_posts analytics:read

Meilleures publications de la période et tendances.

workspace_uuid, days?, limit?

Scopes

Donne 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

inbox:read Boîte de réception — lire messages et commentaires

inbox:reply Boîte de réception — répondre en ton nom (envoi réel)

analytics:read Analyse — audience, portée, engagement, clics

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.

Guides MCP

Le serveur MCP PurrPlan, expliqué Tutoriel : programmer ses posts avec Claude Tutoriel : programmer avec ChatGPT Tutoriel : programmer avec Cursor Groupes Facebook

Prêt à construire ?

Crée ton token et branche ton premier appel en quelques minutes. Dès 9 €/mois, essai 7 jours.

Offre à vie 597 € — une seule fois

Paie une fois, ton agent publie pour toujours : API + MCP, crédits IA et quotas du plan Pro inclus, zéro abonnement. Le seul planificateur social avec une option lifetime pensée pour les workflows agentiques.

Démarrer gratuitement Créer un token