Intégration des agents IA · MCP

Chikaboom pour les agents IA

Chikaboom expose ses outils de rendu et de planification via MCP (Model Context Protocol). Tout client IA compatible MCP peut s'authentifier avec une clé API et appeler les outils Chikaboom au nom de l'utilisateur.

Ce que permet cette intégration

Lorsque vous connectez un agent IA externe à Chikaboom, votre assistant IA peut :

  • lister vos marques et découvrir les modèles disponibles
  • générer des publications sociales conformes à votre marque (unitaires, par lot ou en carrousel multi-diapositives)
  • planifier les publications générées dans votre calendrier de contenu pour une publication automatique
  • lire vos publications planifiées pour éviter les doublons

L'agent travaille avec les mêmes modèles de marque qu'un designer a créés pour vous, le résultat respecte donc toujours votre marque. L'agent ne peut ni dessiner de formes ni modifier l'identité visuelle ; il remplit seulement les champs de texte que votre designer a exposés.

Démarrage rapide : Claude Desktop

  1. Générez une clé API. Connectez-vous à Chikaboom, ouvrez Paramètres → API et MCP, cliquez sur Créer une clé. Copiez le jeton (bs_live_…). Il n'est affiché qu'une fois.
  2. Modifiez la configuration de Claude Desktop. Sur macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
    {
  "mcpServers": {
    "chikaboom": {
      "url": "https://<your-chikaboom-domain>/api/mcp",
      "headers": {
        "Authorization": "Bearer bs_live_YOUR_TOKEN"
      }
    }
  }
}
  3. Redémarrez Claude Desktop. Les outils Chikaboom apparaissent désormais dans la liste des outils de Claude.
  4. Demandez en langage naturel. Essayez : « Génère un post LinkedIn pour le lancement de notre dernier produit et planifie-le vendredi à 9 h. » L'agent appelle les outils Chikaboom et renvoie des URL d'aperçu cliquables.

Référence des outils

Chikaboom expose les outils suivants via MCP :

list_brands

Trouve les marques auxquelles l'utilisateur authentifié a accès.

Entrée(aucun paramètre)
SortieArray of { brand_id, brand_name, role, templates_count }
list_templates

Liste les modèles d'une marque, avec le schéma de champs de chaque modèle (pour que l'agent sache quelles clés il peut remplir).

Entrée{ brand_id: string }
SortieArray of { template_id, name, category, width, height, fields[] }
render_post

Génère une publication unique en PNG. Renvoie une URL publique.

Entrée{ brand_id, template_id, content: Record<string,string>, format_id? }
Sortie{ url, template_id, template_name, width, height, duration_ms }
render_batch

Génère de nombreuses publications en un seul appel. Renvoie une URL de ZIP.

Entrée{ brand_id, template_id, rows: Array<Record<string,string>> }
Sortie{ zip_url, total, succeeded, failed, failures[] }
render_carousel

Génère un carrousel multi-diapositives en PDF pour les publications de document LinkedIn. Renvoie l'URL du PDF et un PNG de la diapositive de couverture pour les aperçus.

Entrée{ brand_id, slides: Array<{template_id, content}>, title? }
Sortie{ pdf_url, cover_url, slides_count }
schedule_post

Crée une publication planifiée dans le calendrier de contenu de l'utilisateur. Peut aussi pré-générer le visuel ou planifier en brouillon.

Entrée{ brand_id, template_id, content, scheduled_for (ISO 8601), caption?, platforms?, asset_url? }
Sortie{ post_id, status, scheduled_for, calendar_url }
list_scheduled_posts

Lit le calendrier de l'utilisateur sur une plage de dates. Utile avant de planifier, pour éviter les doublons.

Entrée{ brand_id, from?, to? }
Sortie{ posts[], count }
ask_user

Outil côté client : présente des options cliquables à l'utilisateur. L'agent l'utilise quand la réponse fait partie d'un petit ensemble (quelle marque, quel modèle, quelle heure, etc.).

Entrée{ question, options: string[2..6], allow_other? }
Sortie(le texte choisi par l'utilisateur revient comme son message suivant)

Détails du protocole

Chikaboom implémente MCP version 2024-11-05 sur JSON-RPC 2.0 à l'adresse POST /api/mcp.

Méthodes prises en charge :

  • initialize: handshake, renvoie la version du protocole et les infos du serveur
  • tools/list: liste les définitions d'outils disponibles
  • tools/call: appelle un outil avec des arguments
  • notifications/initialized: accusé de réception sans effet (renvoie 204)

Les erreurs suivent les codes standard de JSON-RPC 2.0. Les échecs d'authentification renvoient -32000 avec un message clair ; les méthodes inexistantes renvoient -32601.

Questions fréquentes

Quel protocole utilise l'intégration IA de Chikaboom ?

MCP (Model Context Protocol). Chikaboom implémente un serveur JSON-RPC 2.0 sur POST /api/mcp qui prend en charge les méthodes MCP standard : initialize, tools/list, tools/call.

Quels clients IA peuvent se connecter à Chikaboom ?

Tout client compatible MCP. Fonctionnement confirmé : Claude Desktop. Devrait aussi fonctionner avec Cursor, les agents personnalisés construits sur l'Anthropic SDK et d'autres clients MCP à mesure qu'ils adoptent le standard.

Comment fonctionne l'authentification des agents IA ?

Par clés API. Chaque utilisateur génère une ou plusieurs clés dans sa page Paramètres. Les clés sont limitées aux marques auxquelles cet utilisateur a accès. Envoyez-les sous la forme Authorization: Bearer <key>. Les clés sont révocables à tout moment et l'heure de dernière utilisation est enregistrée.

Un agent IA peut-il publier sur LinkedIn/Twitter directement via Chikaboom ?

Indirectement. L'agent appelle schedule_post pour placer une publication dans le calendrier. Le cron worker de Chikaboom la publie ensuite sur les plateformes connectées à l'heure prévue. L'agent lui-même n'accède jamais aux API des plateformes.

Le point de terminaison MCP a-t-il des limites de débit ?

Chaque rendu prend environ 200-400 ms selon la complexité du modèle. Il n'y a pas de limite stricte pour l'instant ; un abus entraîne la suspension automatique de la clé. L'outil de lot réduit la charge pour les opérations en masse.

Prêt à connecter ?

Connectez-vous, créez une clé API dans les Paramètres, et votre client IA dispose nativement d'un rendu conforme à votre marque.

Se connecter et créer une clé