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 workspace (rk_…) : Rayonne → Réglages → Clés API (plan Business, entitlement api_access).

Codex

L’adaptateur rayonne-codex reprend les 82 outils et neuf parcours du plugin Claude, avec configuration sécurisée macOS. 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

82 outils, un par verbe de l'API publique, regroupés par module (voir CLAUDE.md du repo pour la carte fonctionnelle M1-M9).

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.

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

M5 Analytics

M9 Vidéo et storyboard

Avatars vidéo

Quatre outils, pas cinq — aucun dépôt de visage (voir plus haut).

Galerie produit

Audit

Espaces de l'organisation

Workspace

Changelog

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, 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.