API et MCP
L’API ouvre au lancement. Vous voulez un accès anticipé ? Dites-le-nous.
Chaque formule payante inclut une API REST et un serveur MCP.
Cette page donne l’essentiel. La référence complète se trouve sur docs.ploffo.com.
L’essentiel
| API REST | https://api.ploffo.com/v1 |
|---|---|
| Serveur MCP | https://mcp.ploffo.com |
| Format | JSON, UTF-8, dates ISO 8601 avec fuseau horaire |
| Documentation | docs.ploffo.com — ouvre au lancement |
| Statut | status.ploffo.com — ouvre au lancement |
L’API travaille par espace de travail. Une clé donne accès à l’espace où elle a été créée.
Authentification
Créez une clé API dans l’app, dans les réglages de l’espace de travail.
Envoyez-la dans l’en-tête Authorization: Bearer <clé>. Gardez-la comme un mot de passe : qui a la clé peut planifier en votre nom.
Le serveur MCP accepte la même clé, ou une connexion OAuth.
Planifier un post avec curl
Cette requête planifie un post pour le mercredi 7 octobre à 9 h, heure belge. L’en-tête Idempotency-Key évite qu’une requête renvoyée par erreur crée un deuxième post. Regardez l’heure dans la réponse : vous planifiez 9 h à Bruxelles, le système enregistre 07:00Z et retient le fuseau horaire.
curl -X POST https://api.ploffo.com/v1/posts \
-H "Authorization: Bearer $PLOFFO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"channelIds": ["ch_7k2m"],
"body": "Un chiffre sans source est une opinion.",
"runAt": "2026-10-07T09:00:00+02:00"
}'Réponse
{
"id": "post_9fq3",
"status": "scheduled",
"runAt": "2026-10-07T07:00:00Z",
"timezone": "Europe/Brussels",
"channels": [{ "id": "ch_7k2m", "platform": "linkedin", "name": "ceeme" }]
}Serveur MCP
MCP est le standard qui permet aux assistants IA d’utiliser des outils. Ajoutez le serveur Ploffo : votre assistant planifie et vérifie, en langage courant.
Voici la configuration dans un client qui accepte un serveur MCP distant :
{
"mcpServers": {
"ploffo": {
"url": "https://mcp.ploffo.com",
"headers": { "Authorization": "Bearer <votre-clé>" }
}
}
}Les outils
list_channels | Les réseaux connectés. |
|---|---|
create_post | Créer un post. |
schedule_post | Planifier un post à une date et une heure. |
list_schedule | Ce qui est planifié. |
cancel_scheduled_post | Annuler un post planifié. |
create_approval_round | Lancer un tour de validation : lien et PDF pour une série de posts. |
get_publication_proof | La preuve d’une publication : quoi, quand, et le lien public. |
get_usage | Votre consommation du mois en cours. |
Assistants
Fonctionne dans Claude, ChatGPT, Cursor et tout assistant qui parle MCP. Vous écrivez là où vous écrivez déjà ; Ploffo planifie.
Connectez votre assistant ou votre plateforme
Votre assistant
Chaque assistant ci-dessous parle MCP. Le serveur est le même pour tous — https://mcp.ploffo.com — seule la manière de l’ajouter diffère selon l’assistant.
- ClaudeConnecteur personnalisé, sous Customize.
- ChatGPTMode développeur, par espace de travail.
- CursorUn bloc dans mcp.json.
- Claude CodeUne ligne dans le terminal.
- CoworkLe même connecteur que Claude.
- CodexUn bloc dans config.toml.
Votre pile d’automatisation
Un scénario dans n8n ou Make peut aussi appeler le serveur Ploffo, sans que personne n’ait à taper quoi que ce soit.
Documentation
Tous les endpoints, champs, codes d’erreur et limites sont sur docs.ploffo.com.
Questions fréquentes
Quelles formules incluent l’API ?
Toutes les formules payantes : Solo, Studio et Agency. Vous avez l’API REST et le serveur MCP.
Qu’est-ce qu’un serveur MCP ?
MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA d’utiliser des outils externes. Avec le serveur Ploffo, un assistant peut planifier des posts, demander une validation et consulter leur statut.
Un post créé par l’API peut-il éviter la validation ?
Non. Un post n’est planifié qu’après votre validation, même s’il arrive via l’API. Le soumettre aussi à votre client est un choix par post.
Y a-t-il des limites de requêtes ?
Oui, par clé. Les limites en vigueur sont dans la documentation.
Planifié. Validé. Prouvé.
Sans carte. 14 jours. Sans engagement.
