Connecter un agent IA (MCP)

Utilisez Veeton depuis Claude, Claude Code ou tout agent compatible avec le Model Context Protocol. Le connecteur, c'est l'API avec des outils qu'un agent appelle en langage courant.

Veeton dispose d’un serveur MCP : un agent IA peut ainsi trouver vos produits, regarder leurs images, lancer des shootings photo, des packshots et des retouches, puis vérifier les résultats, depuis une conversation. C’est la même API que dans le reste de cette documentation : mêmes organisations, mêmes prix, même journal des requêtes.

https://api.veeton.com/v1/mcp

Le serveur parle MCP en Streamable HTTP et n’expose que des outils.

Qui peut l’utiliser

Le connecteur est ouvert aux organisations auxquelles l’API est ouverte : accès API activé par l’équipe Veeton, et formule payante. Voir Authentification.

Une organisation sans accès peut tout de même se connecter. Chaque outil répond alors par la raison, en clair, que l’agent vous transmet, et rien ne s’exécute.

Se connecter

Il y a deux façons de s’authentifier. Choisissez celle que votre agent prend en charge.

Connexion (Claude, Claude Code)

L’agent ouvre la page de connexion de Veeton, vous choisissez votre organisation et autorisez l’accès. Aucune clé à créer ni à conserver.

Claude (web et bureau) : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, nommez-le Veeton et collez l’URL ci-dessus. Connectez-vous ensuite.

Claude Code :

claude mcp add --transport http veeton https://api.veeton.com/v1/mcp

Lancez ensuite /mcp, sélectionnez veeton et choisissez Authenticate.

Si vous appartenez à plusieurs organisations, l’écran d’autorisation propose un sélecteur d’organisation. Le connecteur fonctionne pour l’organisation choisie à cet endroit, et aucune autre ; pour en changer, déconnectez-vous puis reconnectez-vous.

Clé API (tout autre agent)

Les agents qui prennent une URL et des en-têtes peuvent envoyer une clé ak_, la même que pour l’API :

{
  "mcpServers": {
    "veeton": {
      "url": "https://api.veeton.com/v1/mcp",
      "headers": { "Authorization": "Bearer ak_…" }
    }
  }
}

Le fichier et les noms de champs exacts dépendent de l’agent ; ce qui compte, c’est l’URL et l’en-tête. Chaque outil a besoin des scopes des routes de l’API qu’il appelle : une clé limitée à products:read peut chercher des produits, pas lancer un shooting photo.

Outils

Outil	Ce qu’il fait	Dépense
`find_products`	Cherche vos produits par nom ou par référence
`get_product`	Un produit : ses photos et tous les résultats qui en sont issus
`view_images`	Montre jusqu’à 4 images à l’agent, pour qu’il regarde avant de décrire ou de retoucher
`list_models`	Les mannequins utilisables dans un shooting photo, avec des filtres
`list_options`	Angles de vue, arrière-plans et styles de packshot, avec les slugs à transmettre
`get_credits`	Votre solde et le prix de chaque type de génération
`get_results`	L’état de 20 tâches au plus, et leurs images de sortie
`read_help`	Le centre d’aide de Veeton, pour les questions sur le produit, les formules et la facturation
`add_product`	Crée un produit à partir de photos en ligne (liens https)
`create_tryon`	Lance jusqu’à 4 shootings photo : un produit porté par un mannequin, dans un angle de vue, sur un arrière-plan	Un shooting photo chacun
`create_beautifier`	Lance un packshot d’un produit	Un packshot
`create_edit`	Modifie un résultat à partir d’une consigne, sous forme de nouvelle image	Une retouche

Les générations coûtent le même prix que par l’API et le tableau de bord. Une génération prend une à trois minutes ; l’agent la lance, puis la vérifie avec get_results.

Protection des dépenses

Un agent peut tourner sans surveillance : le connecteur ajoute donc trois garde-fous à ceux de l’API.

Une limite quotidienne. Une organisation peut lancer 50 générations par jour (UTC) par le connecteur. Au-delà, les outils refusent jusqu’au lendemain. L’API et le tableau de bord ne sont pas concernés.
Une limite par appel. Un appel lance au plus 4 shootings photo.
Pas de doublon accidentel. La même demande renvoyée dans les dix minutes retourne la première tâche au lieu d’en créer et d’en facturer une seconde. L’agent transmet again: true quand vous voulez réellement une autre version.

Ces limites peuvent évoluer. Vos crédits et votre formule s’appliquent comme partout ailleurs.

Ce que voit le connecteur

Le connecteur montre ce que montre l’API. Aujourd’hui, ce sont les produits créés par l’API ou par un import, et les résultats qui en sont issus. Les produits créés dans le tableau de bord ne sont pas encore listés.

Chaque appel d’outil est enregistré dans le journal des requêtes API de votre organisation, avec les requêtes API qu’il a faites.

Erreurs

Un outil qui ne peut pas faire ce qui est demandé répond par une phrase, pas par un code : le message de l’API quand c’est elle qui a refusé, ou la raison pour laquelle votre organisation ne peut pas utiliser le connecteur. L’agent la lit et vous la transmet.

Situation	Ce que l’agent apprend
L’organisation n’a pas l’accès API	L’accès API n’est pas activé pour cette organisation
L’organisation est en essai, ou sans abonnement	L’API est réservée aux formules payantes
La limite quotidienne est atteinte	L’organisation a atteint 50 générations aujourd’hui par le connecteur
Crédits insuffisants	Le refus de l’API, comme pour `POST /v1/tasks/*`

Une requête envoyée depuis une page web (avec un en-tête Origin) est refusée : le connecteur est fait pour les agents, pas pour les navigateurs.