Passer au contenu
Menu de la documentation

Ce qu'un agent peut faire

Les outils que le serveur MCP TileSet donne à un agent, groupés par tâche.

Un agent installe TileSet via ces outils. Vous devez rarement les nommer : décrivez le résultat que vous souhaitez.

Configurer

  • setup_widget : celui avec lequel commencer. Connecte ou réutilise une source, crée ou réutilise un widget dessus, et renvoie le snippet. Sans risque en cas de répétition. Il prend une source (google, youtube, testimonials, pinterest, x, twitch, kick) et, pour les sources qui en ont besoin, une requête : un lien Maps, un @handle, un lien de profil ou de tableau Pinterest ou @name (connect_source prend le lien comme pinterestUrl), un X @handle ou lien de profil (connect_source le prend comme xHandle), un nom de chaîne Twitch ou un lien twitch.tv (connect_source le prend comme twitchChannel), un nom de chaîne Kick ou un lien kick.com (connect_source le prend comme kickChannel). Testimonials ne prend aucune requête. Si vous n'avez qu'un lien, laissez source de côté : setup_widget { "query": "https://www.youtube.com/@name" } déduit la plateforme de l'adresse (connect_source fait de même sans type). Un lien Google Maps va vers Google, et les liens YouTube, Twitch, Kick, Pinterest, X connectent leur propre source. Un lien qu'il ne peut pas placer revient comme une erreur demandant source ; rien n'est récupéré ni facturé pour le placer. Pour un flux mixte il prend sourceIds, des sources déjà connectées, à la place.
  • verify_install : verify_install { "url": "<the page's URL>", "widgetId": "w_..." } récupère une page publique et signale si le script et le div sont présents et si le widget sert des éléments. Une erreur reconnue (un id inventé, un script dépouillé par un constructeur de page, un mur de connexion ou de bot, une ancienne page mise en cache) renvoie une ligne Fix, et un tag de script manquant ou un div renvoie la ligne exacte à ajouter. La vérification « Check my page » (Vérifier ma page) du tableau de bord est la même. Une page qui se construit dans le navigateur (Lovable, React), ou une page Wix, dont la boîte Embed HTML est un cadre que notre serveur ne peut pas lire, n'est confirmée que lorsque le widgetId est fourni et que le widget s'est chargé une fois sur cette page. Une réussite s'affiche sur la carte du tableau de bord du widget sous la forme « Installed » (Installé).
  • get_embed_code, list_sources, connect_source, list_widgets, create_widget, update_widget, describe_widget_options.
  • describe_source_content : décrit ce qu'un compte source contient, comme des décomptes pour choisir un design : nombre d'éléments, leurs dates et la fréquence d'arrivée des nouveaux, les notes par étoiles, combien contiennent des photos, des vidéos ou plusieurs images, les formes des images, les longueurs de texte, les systèmes d'écriture et les réponses des propriétaires. Il ne renvoie jamais les éléments eux-mêmes.
  • Le lien Aperçu. Les outils de widget répondent avec un lien Aperçu, https://app.tileset.com/preview/<widgetId> : le widget tel que les visiteurs le voient, à ouvrir dans un navigateur.

Ce qu'un agent ne lit jamais

Un agent configure et exécute vos widgets. Il ne lit jamais votre contenu : aucun outil ne renvoie un post ou un avis, ses mots, noms, images ou liens. Il choisit une mise en page à partir des décomptes et regarde l'aperçu. Si une source échoue, l'agent reçoit une phrase fixe, pas la réponse de la plateforme elle-même. Vous voyez votre contenu dans le tableau de bord, et vos visiteurs le voient dans le widget.

  • create_bio_page : crée une page « Link in bio » avec un nom, une courte biographie, une image, un look et des blocs : des boutons de lien, des icônes sociales et des blocs des sources du compte (derniers posts, le dernier élément en tant que carte de présentation, avis). Renvoie l'adresse de la page à mettre dans la bio du profil. Une page sur le plan gratuit. Laissez slug de côté et la page reçoit une adresse courte propre ; le choix du slug est inclus avec Starter et supérieur, et le plan gratuit reçoit un refus clair nommant le plan.
  • update_bio_page : modifie n’importe quel champ d’une page, y compris son apparence (theme, mode et style : polices, arrière-plan, boutons, coins, forme et taille de l’image, espacement, en-tête et, dès Starter, votre propre couleur et un arrière-plan d’image) et searchable ; un bloc de lien prend une icon (un emoji) ou une image thumb (un lien https, ou un JPEG envoyé en data URI, relu comme uploaded), une description thumbAlt et une color de bouton (un nom prédéfini comme forest, ou n’importe quel hex) ; renvoyez blocks dans un nouvel ordre pour les réordonner. Une nouvelle adresse (dès Starter) garde l’ancienne en redirection pendant 30 jours, une adresse attribuée pour toujours. add_bio_blocks ajoute des blocs à la fin, et list_bio_pages liste les pages avec leurs adresses et tous leurs réglages. delete_bio_page supprime une page, et get_bio_analytics lit ses vues et ses clics sur les liens. Aucun ne renvoie jamais le contenu qu’affiche une page.

Témoignages

  • add_testimonials : ajoute jusqu'à 20 témoignages à une source de témoignages, chacun comprenant un nom et les mots, et si vous les avez, un rôle ou une entreprise, une note de 1 à 5, une date et un lien photo https. Ce qu'un agent ajoute attend votre approbation dans le tableau de bord. Il est dit de n'ajouter que des mots qu'un vrai client a dits, jamais d'écrire soi-même des témoignages.
  • list_testimonials : compte les entrées d'une source de témoignages : combien attendent votre approbation, combien sont sur le widget et combien le contrôle automatique a filtrés comme spam probable (seuls les témoignages envoyés via le lien sont vérifiés, jamais ce qu'un agent ajoute). Il ne renvoie jamais les entrées elles-mêmes. La lecture, l'approbation, le refus, la modification, la suppression, l'ordre et le lien « Share a testimonial » (Partager un témoignage) restent dans le tableau de bord, pour une personne. list_sources indique quand le lien d'une source s'est mis en pause car sa file d'attente est pleine.

Contrôle de mise à jour

  • update_source : renomme une source (label), définit sa vitesse ou son calendrier. Une source est nommée d'après son compte, sauf si connect_source reçoit un label.
  • update_source_now et get_update_status : « Update now » (Starter et supérieur) et suivant un plus lent.
  • get_source_schedule, create_source_webhook, delete_source_webhook.

Crédits

  • get_credits : solde, allocation, date de recharge, coût de chaque vitesse, et pour chaque source active, quelles vitesses vos crédits couvrent, lesquelles ils ne couvrent pas, et lesquelles dépassent votre forfait.
  • set_credit_limits : le plafond mensuel et le fuseau horaire du compte.

Votre agent n'achète jamais rien. Lorsque les crédits viennent à manquer, il vous le signale et vous ajoutez des crédits sous « Credits » (Crédits) ou changez de forfait sous « Plans » (Offres) dans le tableau de bord.

Destructeur

delete_source supprime une source et tous les widgets construits uniquement sur elle ; un widget mixte perd la source et conserve les autres. delete_widget supprime un widget ; les pages qui l'intègrent encore n'affichent rien. Les deux sont permanents. Si vous souhaitez que votre agent demande d'abord, indiquez-le dans les instructions de votre projet.

Pour les agents lisant ceci

La version faisant autorité, lisible par machine, est llms.txt.

Le serveur n'a que des outils, pas de ressources.