Développeurs · API et MCP

L’API et le MCP d’Unisoft, ouverts à votre code et à vos agents IA.

Une API REST documentée, des webhooks signés et un serveur MCP auquel ChatGPT, Claude, Gemini ou Grok se connectent. Votre bénévole technique, votre agence ou vos propres agents travaillent avec les données de votre communauté, uniquement dans les permissions que vous accordez.

  • Plus de 700 opérations documentées
  • Connexion OAuth 2.1 pour les IA
  • Webhooks signés, renvoyés

L’essentiel

Puis-je relier mes outils ou mon IA à Unisoft ?

Oui. Unisoft propose une API REST documentée, des webhooks signés et un serveur MCP pour ChatGPT, Claude, Gemini, Grok ou vos propres agents, toujours limités aux permissions que vous accordez.

  • API REST V2 avec plus de 700 opérations documentées ; V1 conservée pour les intégrations existantes.
  • Serveur MCP à api.unisoft.world/integrations/mcp, connexion OAuth 2.1.
  • Webhooks signés HMAC SHA-256, jusqu’à six essais sur environ neuf heures.
  • Documentation publique, avec exports Markdown, llms.txt et OpenAPI.

Trois portes d’entrée

Choisissez celle qui convient à votre projet.

Synchroniser un autre système, confier une tâche à un assistant IA ou réagir dès qu’un événement se produit : les trois partagent les mêmes permissions et la même documentation.

API REST

Une clé, une organisation, les permissions que vous choisissez.

Un administrateur crée la clé dans l’espace Développeurs d’Unisoft et ne coche que ce dont l’intégration a besoin. Votre code lit et écrit ensuite en JSON standard sur HTTPS, avec une pagination par curseur et des erreurs documentées.

  • La version 2 pour tout nouveau projet ; la version 1 reste disponible pour les intégrations déjà en place.
  • Lecture, écriture et envoi sont des permissions distinctes, modifiables ensuite sans changer de clé.
  • Une clé peut être limitée à des collectes choisies.
  • La clé s’affiche une seule fois à sa création et se révoque à tout moment.
curl "$UNISOFT_API_URL/me" \
  -H "Authorization: Bearer $UNISOFT_API_KEY"

{ "success": true,
  "data": {
    "apiKey": {
      "name": "Synchro du site",
      "scopes": ["contacts:read",
                 "paiements:read"] },
    "organisation": {
      "name": "Votre communauté",
      "enabledLanguages":
        ["en", "fr", "he"] } } }
Votre premier appel : vérifier l’organisation et les permissions ouvertes par la clé.

Ce que vous pouvez atteindre

  • Contacts et familles
  • Paiements
  • Promesses de dons
  • Reçus fiscaux
  • Dons récurrents
  • Mandats SEPA
  • Collectes
  • Formulaires et inscriptions
  • Événements et billets
  • Calendrier communautaire
  • Enchères de montées
  • E-mail, SMS et WhatsApp
  • Pages du site
  • Statistiques
  • Budgets et banque
  • Tourisme

Chaque opération indique dans la référence la permission qu’elle demande.

Serveur MCP

Votre assistant IA relié à Unisoft en quelques minutes.

Le MCP est le standard ouvert qui permet aux assistants IA d’utiliser d’autres logiciels. Le serveur MCP d’Unisoft leur donne ses outils et les bonnes méthodes de travail : ils traitent vos demandes comme le ferait votre équipe.

  1. L’activer

    Un administrateur active le serveur MCP dans l’espace Développeurs.

  2. Ajouter l’adresse

    Collez l’URL du serveur dans ChatGPT, Claude, Gemini ou Grok comme connecteur personnalisé.

  3. Autoriser l’accès

    Connectez-vous à Unisoft et vérifiez les permissions demandées par l’assistant.

  4. Demander

    « Quelles promesses restent ouvertes ? », « Crée le formulaire d’inscription au Séder. »

URL du serveur MCP

https://api.unisoft.world/integrations/mcp

Compatible avec

  • ChatGPT
  • Claude
  • Gemini
  • Grok

Connexion

OAuth 2.1 avec PKCE · vos propres agents peuvent utiliser une clé API

Des méthodes de travail prêtes à l’emploi

L’assistant ne devine pas le fonctionnement d’Unisoft : cinq guides intégrés lui expliquent chaque domaine, ses règles et ses pièges.

  • Contacts

    Trouver, compléter, corriger ou importer des fiches, avec liens familiaux, échanges et documents.

  • Finance

    Dons, liens de paiement, promesses, dons récurrents, reçus, statistiques et rapports.

  • Inscriptions et messages

    Créer des formulaires, suivre inscriptions et événements, préparer des campagnes e-mail, SMS et WhatsApp.

  • Contenu du site

    Pages, blocs réutilisables, menus, albums photo et traductions de votre site.

  • Tourisme

    Lieux, rubriques et sessions de Chabbat d’un site de Beth Habad touristique.

Vous gardez la main

  • L’assistant agit dans les droits actuels de la personne qui l’a connecté.
  • Les éléments personnels, comme vos propres suggestions, demandent votre consentement explicite et restent invisibles des autres utilisateurs, administrateurs compris.
  • Désactiver le serveur MCP coupe immédiatement l’accès de toute IA connectée.
  • Des consignes partagées indiquent à chaque assistant connecté la manière de travailler de votre organisation.

Vous cherchez l’IA déjà intégrée à Unisoft ? Découvrir Yossi

Quelques événements disponibles
  • paiement.successPaiement reçu
  • paiement.refundedPaiement remboursé
  • form.submittedRéponse à un formulaire reçue
  • contact.createdNouvelle personne ajoutée
  • fundraising.donation.completedDon de collecte confirmé
  • fundraising.pledge.updatedPromesse de don mise à jour
  • fundraising.publishedCollecte publiée
signed_payload =
  X-Unisoft-Timestamp + "." + raw_body
expected = "sha256=" +
  HMAC_SHA256_HEX(secret, signed_payload)
Vérifier la signature avant de lire le JSON

Webhooks

Soyez prévenu à l’instant même.

Choisissez les événements, indiquez une adresse HTTPS : Unisoft envoie un message JSON signé à votre serveur ou à votre outil d’automatisation. Un événement de test vérifie la connexion avant la mise en service.

  • Signature HMAC SHA-256 sur l’horodatage et le corps brut.
  • Jusqu’à six essais sur environ neuf heures si votre serveur ne répond pas.
  • Un identifiant d’événement pour ignorer une livraison déjà traitée.
  • Un secret affiché une seule fois, que vous pouvez régénérer.

Make, n8n et Zapier

Il n’existe pas d’application Unisoft dédiée à installer dans ces outils : vous utilisez leurs modules HTTP et webhooks standards, qui donnent accès à toutes les opérations et à tous les événements documentés.

  • MakeModule HTTP + webhook personnalisé
  • n8nHTTP Request + déclencheur Webhook
  • ZapierWebhooks by Zapier

Pensé pour les données d’une communauté

Ouvert aux intégrations, fermé au reste.

Les données des donateurs et des membres méritent du soin. L’accès développeur suit les mêmes règles que le reste d’Unisoft.

Une organisation par clé

Une clé ou une connexion IA n’atteint jamais que l’organisation qui l’a créée.

Le strict nécessaire

Seuls les administrateurs ouvrent l’espace Développeurs, et chaque clé ou IA reçoit uniquement les permissions utiles.

Consentement personnel

Ce qui appartient à un utilisateur reste à lui : une IA n’y accède qu’avec son accord explicite.

Pour aller plus loin

Questions de développeurs

Non. Un administrateur active le serveur MCP dans l’espace Développeurs, puis vous ajoutez son adresse comme connecteur dans ChatGPT, Claude, Gemini ou Grok et vous vous connectez à Unisoft. Les méthodes de travail sont déjà incluses. Le code n’est utile que pour l’API REST ou vos propres agents.

La version 2 pour toute nouvelle intégration. La version 1 reste disponible pour que les intégrations déjà en place continuent de fonctionner. Le serveur MCP utilise toujours la version courante, à la même adresse.

Uniquement ce que la personne qui l’a connectée a le droit de faire, dans les permissions acceptées lors de la connexion. Les éléments personnels, comme les suggestions propres à un utilisateur, demandent son consentement explicite, et un administrateur peut désactiver le serveur MCP à tout moment.

Pas d’application dédiée. Ces outils se connectent par leurs modules standards : des requêtes HTTP avec une clé API pour appeler Unisoft, et des déclencheurs webhook (webhook personnalisé, Webhooks by Zapier) pour recevoir ses événements.

Chaque livraison porte un horodatage et une signature HMAC SHA-256 calculée avec votre secret. Vérifiez-la sur le corps brut avant de lire le JSON, puis utilisez l’identifiant de l’événement pour ignorer les doublons : une livraison peut être répétée ou arriver dans le désordre.

À l’adresse api.unisoft.world/integrations/latest/docs, publique et lisible sans compte. Elle existe aussi en fichier Markdown, en index llms.txt et en fichier OpenAPI JSON.

Vous construisez quelque chose pour votre communauté ?

Dites-nous ce que vous voulez relier. Notre équipe étudie avec vous la bonne approche : API, webhooks ou MCP.