Homotope ENES

Conduire Homotope depuis un agent IA

Mis à jour le

Un agent branché sur le serveur MCP de Homotope (https://homotope.app/mcp) mène une image jusqu’au fichier d’impression ou de découpe en 3 calculs au plus : suggérer le préréglage, calculer, regarder l’aperçu et lancer le contrôle de découpe, puis corriger par le conseil que rend le contrôle, et s’arrêter quand le contrôle passe et que l’aperçu zoomé ne montre plus le défaut nommé par l’utilisateur.

Pour un agent : le même texte en Markdown, /agents.md (en anglais : /en/agents.md).

Logo de torréfacteur récupéré sur un site, en JPEG compressé et bruité : grain de café sur un disque sombre cerclé d’un filet, mot-marque en capitales. JPG · 900 × 640 px
Le même logo vectorisé en SVG par Homotope : trois aplats nets, capitales franches. SVG du moteur
Logo JPEG compressé et bruité de 900 × 640 px et SVG produit par le moteur, préréglage Logo, Nombre de couleurs : 3, sans retouche : le bruit et les blocs du JPEG disparaissent, le disque et son filet restent des cercles et les capitales restent franches.
Détail ×6 : l’accent du É d’« ORÉVAN » : bruit et blocs du JPEG, bords nets du SVG. Glissez le curseur pour comparer ; survolez l’image ou gardez le doigt dessus pour déplacer la loupe.
Essayer avec votre image Ouvrir cet exemple dans l’atelier

Pour qui

Cette page est le mode d’emploi d’un agent IA (Claude Code, Claude, ChatGPT, Gemini CLI ou un script) qui utilise Homotope par son serveur MCP, à l’adresse https://homotope.app/mcp. Le texte brut est sur /agents.md. Chaque appel à vectorize_image est un calcul décompté du compte de l’utilisateur ; tous les autres outils sont gratuits. Donc : regarder avant de recalculer.

La boucle en quatre temps

  1. Suggérer. Appeler suggest_preset sur l’image (image_base64, image_url ou source_job_id). C’est gratuit, rien n’est calculé. Ou passer "preset":"auto" à vectorize_image.
  2. Calculer. Appeler vectorize_image avec ce préréglage. Pour un sticker, une vitrophanie ou une impression découpée, ajouter cut_contour avec la largeur réelle width_mm (ses marges sont en mm à cette taille). La réponse est immédiate, avec un job_id : sonder get_job jusqu’à done (ou failed). C’est la seule étape décomptée.
  3. Voir et contrôler. Appeler get_preview ("side":"both" compare avec l’original ; zoom cadre une boîte du contrôle ou la partie dont l’utilisateur se plaint), puis check_cut avec la largeur réelle width_mm (et safety_mm, spacing_mm de l’imprimeur s’il les a donnés). Lire report.blocking, printer.status et advice.
  4. Corriger par le conseil. Prendre le premier conseil de advice et recalculer depuis la même source (source_job_id : aucun nouvel envoi), puis revenir au temps 3. La façon d’appliquer chaque conseil est ci-dessous.

Appliquer un conseil

Quand s’arrêter

Les bornes

Ce que chaque outil coûte au compte

Fichiers de fabrication et contrôle imprimeur

Exemple : une vitrophanie de 140 × 40 cm

L’utilisateur veut une vitrophanie de 1 400 mm de large, avec contour de découpe et 2 mm de fond perdu. Deux calculs ici ; un troisième seulement si le second contrôle échoue encore. 

suggest_preset    {"image_url":"https://…/vitrine.png"}
      vectorize_image   {"image_url":"https://…/vitrine.png","preset":"auto",
                         "cut_contour":{"width_mm":1400}}
      get_job           {"job_id":"<id>"}            (until "done")
      get_preview       {"job_id":"<id>","side":"both","width":1024}
      check_cut         {"job_id":"<id>","width_mm":1400}
      vectorize_image   {"source_job_id":"<id>","preset":"<preset_suggested.preset>",
                         "cut_contour":{"width_mm":1400,"margin_mm":<advice value>}}
      check_cut         {"job_id":"<id2>","width_mm":1400}
      get_result        {"job_id":"<id2>","format":"pdf","width_mm":1400,"bleed_mm":2}

Se brancher

Claude Code : ajouter le serveur, puis se connecter depuis /mcp (OAuth, le compte Homotope de l’utilisateur). Un script utilise une clé d’API dans l’en-tête Authorization: Bearer ; ne jamais écrire une clé dans une invite, un fichier ou un dépôt. 

claude mcp add --transport http homotope https://homotope.app/mcp

Questions fréquentes

Un agent voit-il le résultat ?

Oui : get_preview rend un aperçu PNG d’un calcul terminé, le résultat, l’image d’origine ou les deux côte à côte, avec un zoom sur un défaut. C’est gratuit et rien n’est décompté.

Combien de calculs coûte la boucle ?

3 au plus par image, souvent deux. Seul vectorize_image est décompté (essai du mois, quota Pro ou crédit) ; la suggestion, l’aperçu, le contrôle et le conseil sont gratuits.

Homotope applique-t-il un réglage tout seul ?

Non. Le contrôle rend des conseils (le réglage, le sens, la valeur) ; c’est l’agent qui décide de recalculer, et chaque calcul passe par le compte de l’utilisateur.

Claude Code peut-il suivre cette recette ?

Oui : branchez le serveur MCP (https://homotope.app/mcp) et donnez-lui ce texte, ou son Markdown brut (/en/agents.md).

Les exports de fabrication sont-ils comptés ?

Par un agent, les formats d’un calcul terminé (PDF, DXF, EPS, séparations, contour) sont compris dans le calcul. Dans l’atelier : Exports de fabrication (DXF, EPS, PDF, séparations) : 2 par mois gratuits avec un compte, illimités en Pro ; sans Pro, 1 crédit chacun au-delà des 2.

Autres guides

Essayer avec votre image