Rayonne MCP

Serveur MCP (stdio) exposant le workspace Rayonne — contenus, soumissions, métriques AARRR — à tout agent compatible MCP (Claude Code, Claude Desktop…), via l'API publique v1 en lecture et écriture (docs/API.md du repo).

Prérequis

Une clé API (rk_…) : Rayonne → Réglages → « Clés d'API (extension, API, Claude) » (plan Business, entitlement api_access). Pour créer, configurer et initialiser des espaces (/rayonne-from-code), coche « Piloter toute l'organisation ». Il faut être propriétaire de l'organisation, et rayonne_workspace_access doit répondre org_admin: true. Une clé existante ne se promeut pas : crées-en une autre.

Installer la clé — pour l'utilisateur, jamais dans un dépôt

La clé ne se colle jamais dans une conversation et ne passe jamais en argument. Copie-la dans Rayonne, puis :

pbpaste | uvx rayonne-mcp login     # macOS ; Linux : wl-paste | … ou xclip -o -selection clipboard | …
uvx rayonne-mcp login               # dans un terminal : saisie masquée

Dans Claude Code : ! pbpaste | uvx rayonne-mcp login, puis /reload-plugins (commande /rayonne-setup). La clé est vérifiée auprès du serveur, puis enregistrée dans ~/.config/rayonne/credentials.json (0600, dossier 0700 ; $XDG_CONFIG_HOME ou $RAYONNE_CREDENTIALS_FILE si définis). Elle vaut pour tous les dépôts de l'utilisateur. uvx rayonne-mcp logout la retire ; une instance auto-hébergée ajoute --api-url.

Clé utilisée par le serveur, la première trouvée :

1. RAYONNE_API_KEY explicite (Claude Desktop, Codex, CI) ;
2. le fichier de rayonne-mcp login, enregistré pour cette URL d'API ;
3. la clé saisie à l'installation du plugin Claude Code (RAYONNE_PLUGIN_API_KEY).

rayonne_workspace_access dit laquelle est chargée (key_source) et, sans administration, l'action exacte à faire (next_step).

Codex

L’adaptateur rayonne-codex reprend les outils du serveur PyPI qu’il épingle — la version publiée — et les parcours du plugin Claude, avec configuration sécurisée macOS (trousseau). Sans profil Codex, il lit la clé de rayonne-mcp login. Construction : python3 mcp/build/build_codex_plugin.py depuis la racine du dépôt.

Claude Code

claude mcp add rayonne \
  --env RAYONNE_API_KEY=rk_xxxxxxxx \
  --env RAYONNE_API_URL=https://rayonne.sponge-theory.dev \
  -- uv run --project /chemin/vers/rayonne/mcp rayonne-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "rayonne": {
      "command": "uv",
      "args": ["run", "--project", "/chemin/vers/rayonne/mcp", "rayonne-mcp"],
      "env": {
        "RAYONNE_API_KEY": "rk_xxxxxxxx",
        "RAYONNE_API_URL": "https://rayonne.sponge-theory.dev"
      }
    }
  }
}

Le serveur démarre sans clé (non fatal) : chaque outil renvoie alors un message d'installation clair au lieu d'un crash.

Outils

168 outils, un par verbe de l'API publique, regroupés par module (voir CLAUDE.md du repo pour la carte fonctionnelle M1-M9). Ce que l'agent ne peut pas encore faire, et ce qu'il ne fera jamais (consentement OAuth, paiement, visage réel) : docs/AGENT_PARITY.md du repo.

Déposer un fichier (0.6.0) : rayonne_upload_product_asset et rayonne_upload_submission_asset prennent un chemin de fichier local — le serveur MCP tourne sur la machine de l'utilisateur et lit les octets lui-même. Un chemin fautif est refusé avant tout appel réseau.

Aucun dépôt d'avatar, par construction : enregistrer un VISAGE engage le consentement d'une personne réelle, au nom de l'utilisateur connecté ; une clé rk_ n'a pas d'utilisateur. Il n'y a donc ni outil ni route publique de dépôt d'avatar — rayonne_generate_avatar compose un portrait de synthèse, et déposer une vraie photo reste un acte humain, dans l'interface.

Listes : un outil qui rend une liste (rayonne_list_tasks, rayonne_list_experiments…) la rend en un bloc de contenu par élément — c'est ainsi que le SDK MCP (FastMCP 1.x) sérialise un retour non typé. Une liste d'un seul élément a donc, au niveau du protocole, la forme d'un objet, et une liste vide n'a aucun bloc. Noté par le parcours E2E « surfaces », laissé tel quel : envelopper les listes changerait la sortie de chaque outil.

Cibler un autre espace (0.5.0) : tout outil ci-dessous, sauf rayonne_list_workspaces et rayonne_create_workspace, prend un workspace_id optionnel — passe l'id d'un espace rendu par rayonne_list_workspaces pour agir là-bas plutôt que dans l'espace d'origine de la clé. Omis, rien ne change par rapport à avant 0.5.0.

M1 Brief

M2 Stratégie

M3 Contenu

M3 Kit de vente et médias

M4 Soumission

Comptes connectés

Lire et couper, jamais connecter : le consentement OAuth et le jeton collé restent des gestes de l'utilisateur, dans l'application.

M5 Analytics

GEO

« À faire » — les gestes du fondateur

Rayonne organise l'engagement humain, il ne le fait jamais : ces outils rappellent et enregistrent, ils ne répondent à personne.

Lancement (WS7)

Le plan organise, les kits préparent, le fondateur publie : aucun outil ne publie sur Reddit, Hacker News, Product Hunt ou Indie Hackers, ni n'écrit un Show HN.

M9 Vidéo et storyboard

Avatars vidéo

Aucun dépôt de visage (voir plus haut).

Galerie produit

Audit

Espaces de l'organisation

Workspace

Changelog

0.10.0 (non publiée)

Trente-quatre outils ajoutés depuis la 0.9.0 publiée (129), 163 au total (tests/published_tools.json garde la liste publiée) : l'essai et la lecture d'un run de l'agent de remplissage (rayonne_fill_trial, rayonne_get_agent_run) ; la première image d'une vidéo livrée (rayonne_suggest_video_cover, rayonne_set_video_cover) et l'annulation d'une reprise (rayonne_cancel_reopen_storyboard) ; le lien de bio (rayonne_confirm_bio_link) ; la parité de la revue du 2026-10-31 — rodage (rayonne_content_warmup), médias suggérés (rayonne_media_candidates), vidéos d'un post (rayonne_post_videos), document LinkedIn (rayonne_get_carousel, rayonne_compose_carousel, rayonne_set_carousel_publish), autopilote par compte (rayonne_set_account_autopilot), page LinkedIn (rayonne_linkedin_pages, rayonne_select_linkedin_page), checklist de lancement, coût d'API et extension (rayonne_launch_checklist, rayonne_api_costs, rayonne_extension_status), GEO en écriture (rayonne_add_geo_prompt, rayonne_remove_geo_prompt, rayonne_restore_geo_prompts, rayonne_add_geo_source_task, rayonne_run_geo_robots), vérification hebdomadaire (rayonne_hallucination_audit), mesure produit (rayonne_measurement, rayonne_rotate_event_secret), aperçu cartoon (rayonne_preview_cartoon_avatar, rayonne_cartoon_traits_of_avatar), portée de la clé et plateformes de départ (rayonne_workspace_access, rayonne_set_starter_platforms), supprimer une version du brief (rayonne_delete_brief), plan et usage, vue de l'organisation et export (rayonne_usage, rayonne_org_overview, rayonne_export_workspace).

Démarrage : instructions ramenées sous 3 800 caractères, règles dures en tête, la carte des modules dans la ressource rayonne://guide ; serverInfo porte la version de rayonne-mcp ; mcp sans l'extra cli ; python -m rayonne_mcp ; les routes qui attendent un modèle ont 150 s et un délai dépassé rend timeout. Les refus TikTok / LinkedIn portent publish_url.

0.9.0

Audit du 2026-10-14 : dix outils ajoutés, 128 au total. Nécessite le backend qui porte les routes publiques correspondantes (/accounts, /notifications, /reviews/{id}, /geo*, /content/selling-coverage, /content/{id}/regenerate).

• rayonne_reset_content ne réécrit rien — il remet en relecture. Les instructions disaient « re-runs a piece from the corrected source » : un agent corrigeait le brief, « relançait », et ré-approuvait le même texte. La réécriture est rayonne_regenerate_content (même venue, même type, même argument, quota consommé, retour en relecture).
• Comptes connectés — rayonne_list_accounts, rayonne_disconnect_account : un agent sait enfin si une venue api peut publier. Connecter reste un geste humain.
• Attention requise — rayonne_notifications.
• Revue hebdo lisible — rayonne_get_review ; rayonne_run_review prend review_id.
• GEO en lecture — rayonne_geo_overview, rayonne_geo_prompts, rayonne_geo_sources, rayonne_geo_robots.
• Couverture vendeuse — rayonne_selling_coverage.
• Corrigés — rayonne_generate_submission_assets répondait 422 à chaque appel (le serveur lisait modes comme corps) ; il prend modes. rayonne_list_tasks prend plusieurs statuts et offset. Les segments libres d'un chemin (clés d'action et de garde, slug, nom de fichier) sont échappés.
• Gardes dites à l'agent — TikTok refusé à une clé (422 tiktok_requires_app), vidéo du plan validée par une personne, médias d'un contenu validé qui le renvoient en relecture, repurpose refusé sur un type que la venue ne prend pas.
• Une version, un code — la 0.8.0 de PyPI et celle du bundle Desktop différaient : la source passe en 0.9.0, build_mcpb.sh reconstruit toujours la roue qu'il embarque, et tests/test_release_version.py épingle les sources d'une version publiée.

0.8.0

L'audit produit (v1.33 → v1.41) arrive dans Claude : 36 outils ajoutés depuis 0.7.0, 118 au total, un par verbe de l'API publique. Nécessite le backend v1.41 ou plus récent.

• Faits du produit (WS1a) — rayonne_list_facts, rayonne_create_fact, rayonne_update_fact, rayonne_archive_fact : le registre de preuves sur lequel chaque texte s'ancre.
• Stratégie (WS4) — rayonne_founder_context ; le plan modifiable : rayonne_add_plan_action, rayonne_edit_plan_action, rayonne_remove_plan_action, rayonne_generate_plan_action ; les expériences pré-enregistrées : rayonne_list_experiments, rayonne_add_experiment, rayonne_update_experiment, rayonne_delete_experiment, rayonne_record_experiment_result, rayonne_decide_experiment.
• « À faire » (WS3) — rayonne_list_tasks, rayonne_update_task : les gestes du fondateur (fenêtres de réponse, participation hebdomadaire, demande d'avis, étapes de lancement), rappelés, jamais faits à sa place.
• Mesure (WS5) — rayonne_metrics_channels : quel canal amène des clients, avec n et sans gagnant sous l'échantillon minimal.
• Lancement (WS7) — rayonne_launch_plan, rayonne_create_launch_plan, rayonne_reschedule_launch, rayonne_move_launch_step, rayonne_delete_launch_plan, rayonne_launch_gates, rayonne_answer_launch_gate, rayonne_recheck_launch_gates ; les pages de comparaison sourcées : rayonne_list_comparisons, rayonne_get_comparison, rayonne_create_comparison, rayonne_update_comparison, rayonne_confirm_comparison, rayonne_check_comparison, rayonne_generate_comparison, rayonne_delete_comparison.
• Avatars cartoon — rayonne_cartoon_avatar_options, rayonne_create_cartoon_avatar (le personnage qui chante un clip).
• Outils changés — rayonne_update_workspace prend founder_context, activation_event, north_star_metric, venue_cadence, paid_partnership, bluesky_account et engagement_emails ; rayonne_edit_content prend paid_partnership et dit la forme d'un fil ; rayonne_approve_content est refusé (409) sur LinkedIn, une page LinkedIn, Hashnode (founder_approval_required) et une page de comparaison (comparison_human_review_required) : une personne valide dans l'application ; rayonne_retry_submission nomme ses refus 409 ; rayonne_create_submission, rayonne_retry_submission, rayonne_schedule_submission et rayonne_publish_video exigent un contenu validé (409 content_not_approved) — une page de comparaison, validée par une personne dans l'application ; un contenu validé que rayonne_edit_content retouche repart en relecture ; rayonne_publish_video saute LinkedIn ; rayonne_list_platforms porte les règles écrites de chaque venue (tos) et sa cadence ; rayonne_metrics_aarrr rend une valeur par métrique et le GEO en taux.
• Refus entiers — un refus de l'API rend {"error": "request_failed", "status", "detail", "message"} : detail est le refus structuré du serveur (son code, hint_fr / hint_en, les problems d'un comparatif), là où message coupait à 300 caractères.

0.7.0

rayonne_onboard_workspace termine l’initialisation d’un espace via une clé administratrice, sans régénération ni activation. rayonne_patch_brief conserve les champs absents, fusionne les objets imbriqués, remplace les tableaux et enregistre les valeurs nulles. Nécessite le backend corrigé.

0.6.0

Le dépôt, l'atelier vidéo et les pièces jointes d'un kit sortent du navigateur. Dix-huit outils s'ajoutent : la galerie produit devient inscriptible (rayonne_upload_product_asset — un CHEMIN de fichier local, lu par le serveur sur la machine de l'utilisateur —, rayonne_update_product_asset, rayonne_suggest_asset_caption, rayonne_delete_product_asset) ; l'atelier vidéo s'ouvre en entier (avatars rayonne_list_avatars / rayonne_generate_avatar / rayonne_update_avatar / rayonne_cutout_avatar, relecture rouvrable rayonne_reopen_storyboard (annulable : rayonne_cancel_reopen_storyboard), aide IA rayonne_assist_storyboard et rayonne_chat_storyboard, vignette réelle rayonne_storyboard_thumbnail, choix de l'avatar rayonne_update_video, catalogue rayonne_music_presets) ; et un kit Mode C accepte enfin des visuels déposés à la main (rayonne_upload_submission_asset, rayonne_generate_submission_assets, rayonne_list_submission_assets, rayonne_delete_submission_asset). 81 outils au total.

Une absence est délibérée : il n'y a pas d'outil de dépôt d'avatar, et pas de route publique derrière. Déposer un visage engage le consentement d'une personne réelle au nom de l'utilisateur connecté ; une clé rk_ n'a pas d'utilisateur, donc un agent ne peut pas l'attester à sa place. Le portrait de synthèse (rayonne_generate_avatar) est la voie ouverte ici ; une vraie photo se dépose dans l'interface, par un humain.

0.5.0

Une clé peut désormais piloter TOUTE l'organisation, pas seulement son espace d'origine : rayonne_list_workspaces énumère ce qu'elle peut atteindre (l'origine marquée is_home), rayonne_create_workspace et rayonne_delete_workspace ouvrent et ferment des espaces (clé avec le cran d'administration), et rayonne_update_workspace règle l'espace visé sur l'objet complet des réglages. Les 59 outils existants gagnent un workspace_id optionnel pour agir sur un autre espace que celui de la clé — omis, comportement inchangé. Rupture : le format rendu par rayonne_workspace (et par rayonne_update_workspace) n'est plus le format étroit d'avant — autopilot_enabled devient autopilot, et locale, paused, autopublish_live, video_music apparaissent. 63 outils au total.

0.4.0

Kit de vente et médias d'un post pilotables depuis Claude : inspecter la sélection média résolue, la fixer à la main ou la recalculer depuis le playbook, composer une carte de marque, changer d'argument de vente, et prévisualiser texte + médias par venue avant publication. Huit outils ajoutés (rayonne_content_media, rayonne_set_content_media, rayonne_recompute_content_media, rayonne_brand_card, rayonne_regenerate_text, rayonne_preview_content, rayonne_workspace, rayonne_set_ai_illustrations) — 59 outils au total.

Tests

cd mcp && uv run --extra dev pytest -q

Publication marketplace

À faire via le flux commun Sponge Theory (même patron qu'audigeo-mcp : stdio + PyPI, vendored dans ezeeFlop/claude-plugins) — voir l'agent mcp-plugin-publisher. Pour une version (tests/test_release_version.py garde les déclarations d'accord), dans cet ordre :

1. ./build/publish_pypi.sh — construit la roue et le sdist (build_wheel.sh) et publie rayonne-mcp==<version> sur PyPI ;
2. l'adaptateur Codex, qui lance uv run --locked, garde la version publiée jusque-là ; il passe à la nouvelle juste après l'envoi PyPI : rayonne-codex/pyproject.toml (rayonne-mcp==<version>, sa propre version), .codex-plugin/plugin.json, le compte d'outils de scripts/check_connection.py, de son README et du skill rayonne-setup, puis cd rayonne-codex && uv lock (le verrou ne se régénère qu'une fois le paquet sur PyPI) et tests/test_release_version.py (PUBLISHED, PUBLISHED_TOOLS, et PUBLISHED_SOURCES_SHA256 — l'empreinte que le test affiche : dès lors, toute retouche de src/ exige un nouveau numéro) ; Le plugin Claude Code suit le même chemin, juste après : il épingle lui aussi le serveur publié dans claude_code_plugin/pyproject.toml (rayonne-mcp==<version>, sa propre version = celle de .claude-plugin/plugin.json) et démarre par uv run --locked sur claude_code_plugin/uv.lock : cd claude_code_plugin && uv lock, puis le compte d'outils de son README (tests/test_release_version.py) et tests/published_tools.json (la liste publiée) ;
3. ./build/build_plugin.sh, ./build/build_mcpb.sh et python3 build/build_codex_plugin.py — les trois paquets dans dist/. L'image API copie mcp/dist/ (docker/Dockerfile.api) et sert le .mcpb et le plugin depuis Réglages (/api/v1/integrations/…) : reconstruire l'image ensuite ;
4. reporter claude_code_plugin/ et rayonne-codex/ dans la marketplace ezeeFlop/claude-plugins (Codex sous plugins/rayonne-codex), et pousser.