Please Send It FREN

API et MCP

Un agent IA (Claude, ChatGPT ou un autre) peut utiliser Please Send It pour son propriétaire : créer un projet de collecte de documents, le lancer, suivre qui a envoyé quoi, relancer, et récupérer les fichiers reçus.

Sommaire

La clé d'API

Créez une clé dans Mon abonnement, section « Accès pour les agents ». Elle commence par pse_, ne s'affiche qu'une fois, et se révoque à tout moment. Elle agit en votre nom, dans l'organisation qui était active quand vous l'avez créée : elle ne voit que les projets de cette organisation que vous avez le droit de voir.

Envoyez-la dans l'en-tête Authorization de chaque appel :

Authorization: Bearer pse_votre_cle

Le serveur MCP

Pour Claude et les assistants compatibles avec MCP : ajoutez un connecteur MCP distant avec l'adresse ci-dessous, et votre clé envoyée dans l'en-tête Authorization: Bearer.

https://pleasesendit.com/mcp

Transport « Streamable HTTP » : chaque message JSON-RPC 2.0 part en POST, la réponse revient en application/json (pas de flux SSE). Version du protocole : 2025-06-18. Les outils :

Essai à la main :

curl https://pleasesendit.com/mcp \
  -H "Authorization: Bearer $PSE_CLE" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"lister_projets","arguments":{}}}'

Lister les projets

curl https://pleasesendit.com/api/projets -H "Authorization: Bearer $PSE_CLE"

Réponse : {"projets": [{"id": 12, "nom": "…", "echeance": "2026-10-31", "statut": "actif", "attendues": 8, "recues": 5, "destinataires": 4, "complets": 2, …}]}. Statuts : brouillon, actif, pause.

Créer un projet

Chaque pièce et chaque destinataire porte une cle de votre choix ; affectations dit qui envoie quoi (clé du destinataire vers la liste des clés de pièces). Le projet est créé en brouillon : rien ne part avant le lancement.

curl https://pleasesendit.com/api/projets \
  -H "Authorization: Bearer $PSE_CLE" -H "Content-Type: application/json" \
  -d '{
  "nom": "Dossier de location",
  "echeance": "2026-10-31",
  "frequence": 3, "plafond": 6, "renforcee": true,
  "message": "Merci de tout envoyer avant la visite.",
  "pieces": [
    {"cle": "rib", "nom": "RIB", "format": "pdf"},
    {"cle": "dom", "nom": "Justificatif de domicile", "format": "pdf", "consigne": "Moins de trois mois"}
  ],
  "destinataires": [
    {"cle": "c", "prenom": "Camille", "nom_famille": "Martin", "email": "camille.martin@example.com", "canal": "email"},
    {"cle": "j", "prenom": "Jean", "telephone": "06 12 34 56 78", "canal": "sms", "langue": "en"}
  ],
  "affectations": {"c": ["rib", "dom"], "j": ["rib"]}
}'

Réponse : {"ok": true, "id": 12}.

Voir un projet

curl https://pleasesendit.com/api/projets/12 -H "Authorization: Bearer $PSE_CLE"

La réponse détaille pieces, destinataires (avec lien, leur lien personnel de dépôt, pieces demandées et depots reçus) et relances. Pour modifier un projet, renvoyez le même corps qu'à la création en POST /api/projets/12, avec l'id des pièces et des destinataires existants.

Lancer la collecte

curl -X POST https://pleasesendit.com/api/projets/12/lancer -H "Authorization: Bearer $PSE_CLE"

Chaque destinataire reçoit son lien personnel par email ou SMS, puis les relances automatiques partent entre 9 h et 19 h (heure de Paris), jamais le dimanche ni un jour férié, et s'arrêtent dès que la personne a tout envoyé. Réponse : {"ok": true, "invites": 2}. Les invitations suivent la même plage : lancé en dehors, le projet est actif et la réponse annonce "invites": 0, "differees": 2, "prochain_envoi": "lundi 5 octobre à 9 h". Le compte doit avoir confirmé son adresse email.

Relancer une personne

curl https://pleasesendit.com/api/projets/12/relancer \
  -H "Authorization: Bearer $PSE_CLE" -H "Content-Type: application/json" \
  -d '{"destinataire_id": 34}'

Une relance manuelle au plus toutes les dix minutes pour une même personne.

Pause et reprise

curl -X POST https://pleasesendit.com/api/projets/12/pause -H "Authorization: Bearer $PSE_CLE"

Bascule entre actif et pause ; la réponse donne le nouveau statut. En pause, les liens restent ouverts mais personne n'est relancé.

Télécharger un dépôt

L'identifiant d'un dépôt se lit dans destinataires[].depots[].id de la réponse de Voir un projet.

curl -OJ https://pleasesendit.com/api/projets/12/depots/56 -H "Authorization: Bearer $PSE_CLE"

Tout télécharger en ZIP

curl -OJ https://pleasesendit.com/api/projets/12/zip -H "Authorization: Bearer $PSE_CLE"

Le ZIP reprend le rangement : un dossier par destinataire, des fichiers nommés « Destinataire - Pièce ».

Autres routes

Voir aussi llms.txt, Vos données, CGU. Version anglaise.