Hela

Publier le SDK et les apps

Le code des paquets npm et des applications Zapier, Make et n8n est dans le dépôt, prêt. Les publier dans les annuaires est une démarche de l'éditeur de Hela, une fois ; les entreprises qui les utilisent n'ont ensuite besoin que de leur propre clé d'API Hela, créée dans Administration → Développeurs, et de leurs propres comptes chez les partenaires.

Ce que les entreprises apportent

Chez Ce que l'entreprise fournit elle-même
Zapier, Make, n8n, Power Automate, MCP Sa clé d'API Hela (portées voulues + webhooks:manage, events:read), l'identifiant de son entreprise, l'adresse de l'API si auto-hébergée
Stripe, Mollie, PayPal, Square, SumUp, mobile money, Odoo, Yousign, Clockify, Toggl, Shopify, WooCommerce, GoCardless, Ponto, Plaid, WhatsApp, Slack, Twilio… Ses propres identifiants chez le partenaire, saisis dans Intégrations
Google, Microsoft, Dropbox, QuickBooks, Xero, Yuki, Exact, Pennylane, DocuSign, Sage, Zoho, Apple Rien : l'entreprise clique Continuer avec… ; c'est l'exploitant du serveur qui a enregistré Hela une fois chez le fournisseur (Clés et variables d'environnement)

npm : @hela/sdk et @hela/mcp

  1. Un compte npm et une organisation hela (npmjs.com → Add organization), ou un autre préfixe à reporter dans les package.json.
  2. Les deux paquets vivent dans le workspace pnpm (packages/sdk, packages/mcp) et pointent sur leurs sources TypeScript. Pour publier une version compilée : ajoutez un tsconfig.build.json avec outDir: dist, remplacez main/types/exports par dist/…, et files par ["dist", "bin", "README.md"].
  3. npm login, puis depuis chaque dossier : pnpm publish --access public. Le bin de @hela/mcp démarre le serveur via tsx ; une build dist le rend inutile.
  4. Une version suit celle de l'API (3.0.x) ; un changement de schéma OpenAPI mérite une version du SDK.

Zapier

  1. Un compte développeur Zapier et la CLI : npm i -g zapier-platform-cli, zapier login.
  2. Dans integrations/zapier : npm install, zapier register "Hela" (une fois ; crée .zapierapprc), zapier push. L'app est alors privée : partagez un lien d'invitation (zapier users:add) ou publiez.
  3. Publication dans l'annuaire (zapier promote, puis Developer Platform → Publish) : Zapier exige une description, un logo 256×256, une politique de confidentialité, trois Zaps de test et une revue — deux à six semaines. L'authentification custom par clé d'API est acceptée ; l'adresse de l'API par défaut (https://api.hela.co/v1) doit répondre publiquement.
  4. Chaque entreprise se connecte ensuite avec sa clé et son identifiant d'entreprise ; aucun secret de Hela n'est dans l'app.

Make

  1. Un compte Make avec l'accès Custom apps (Developer Hub).
  2. Create a new app : nom hela, puis collez les sections base, connections, webhooks et modules de integrations/make/app.json dans les onglets correspondants (l'éditeur attend un bloc par onglet). Un logo carré pour l'app.
  3. Testez un scénario avec votre clé. Publier dans l'annuaire : Make → Publish → Submit for review (description, politique de confidentialité, revue de quelques semaines). Entre-temps, Share donne un lien d'installation privé.

n8n

  1. Un compte npm (la communauté installe depuis npm).
  2. Dans integrations/n8n-nodes-hela : npm install, npm run build (compile dist/), npm publish --access public. Le package.json porte le mot-clé n8n-community-node-package et la section n8n qui liste le nœud, le déclencheur et les identifiants.
  3. Les utilisateurs installent depuis Settings → Community nodes avec le nom du paquet. Pour l'affichage dans la liste vérifiée de n8n, soumettez le dépôt via le formulaire Community node verification (revue de code, licence MIT requise — c'est le cas).
  4. Version : 3.0.x ; une nouvelle opération est une version mineure.

Power Automate

Le connecteur personnalisé se crée depuis le schéma OpenAPI sans publication (Power Automate). Un connecteur certifié passe par le programme Independent Publisher Connectors de Microsoft (dépôt GitHub public, revue) ; prévoir quatre à huit semaines.

Serveur MCP

Au-delà de npm, deux annuaires référencent les serveurs MCP : le MCP Registry (registry.modelcontextprotocol.io, un server.json dans le dépôt) et la liste de Claude Desktop (Anthropic Connectors Directory, formulaire). Aucun n'est nécessaire pour qu'une entreprise utilise npx @hela/mcp.

Ce qu'il faut tenir

  • Les clés que les apps utilisent sont celles des entreprises ; Hela n'a aucun secret dans aucune app, et rien à faire tourner quand une clé change.
  • Les annuaires revoient les apps à chaque version : gardez le changelog (Nouveautés) et testez contre /openapi.json avant de pousser.

Un passage est faux ou manquant ? Écrivez-nous.