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

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

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.

Prêt à construire ?

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

Démarrer gratuitement Créer un token