MCP & agents

Serveur MCP pour vos liens et ventes

Votre agent sait déjà parler MCP. Le nôtre est un point d'entrée, huit outils, et l'authentification par clé d'API — le protocole fait le reste.

Créer une clé d'API

Trois lettres, zéro SDK

MCP

Le protocole de vos agents IA

Model Context Protocol : la prise standard entre un agent et un outil. Pas de bibliothèque à installer, pas de wrapper à maintenir — une URL, une clé, et l'agent découvre les outils tout seul.

Ce que l'agent pilote, en images

Lus du code, pas d'une plaquette

8 outils exposés à l'agent

Cette liste est importée du registre que le serveur expose réellement — si un outil change, cette page change avec lui.

list_spaces

Liste les espaces clients de l'agence. Un espace = un client final, une marque ou un projet ; tout le reste (liens, clics, ventes) vit dedans.

create_space

Crée un espace client. Refusé avec le code `space_limit_reached` si la formule est pleine.

list_links

Liste les liens. Un lien PARENT porte la destination ; un PLACEMENT (sublink) porte les UTM d'une publication précise et hérite du reste.

create_link

Crée un lien court. Sans `parentId`, c'est un lien parent et `destination` est obligatoire. Avec `parentId`, c'est un placement : il hérite de la destination du parent et porte ses propres UTM. Renvoie `shortUrl`, prêt à publier.

get_link

Détaille un lien : sa destination FINALE (UTM comprises, telle que la reçoit le site d'arrivée) et ses clics sur 30 jours.

update_link

Modifie la destination ou le libellé d'un lien, ou l'archive. Un lien n'est JAMAIS supprimé : archivé, il cesse de rediriger mais son historique reste.

get_analytics

Les chiffres d'un espace : clics, prospects, ventes, revenu ATTRIBUÉ et revenu NON attribué, plus le détail placement par placement. Montants en CENTIMES. Subtraq ne convertit pas les devises : si `mixedCurrencies` est vrai, les totaux ne concernent que `currency`. `model` choisit la lecture de l'attribution ; la réponse rappelle toujours lequel a servi.

track_sale

Enregistre une VENTE et la rattache au placement d'origine de la personne. Montant en CENTIMES. `invoiceId` rend l'appel idempotent : le rejouer ne facture jamais deux fois. Une vente ne peut PAS être envoyée depuis un navigateur.

À quoi ça sert, concrètement

Trois tâches. L’agent les fait mieux.

Le lien au fil de la conversation

« Crée un lien vers la page promo, canal newsletter, espace Lartigue » — l'agent appelle create_link et colle l'adresse courte dans votre brouillon.

Le point du lundi matin

« Qu'est-ce qui a rapporté cette semaine, client par client ? » — l'agent enchaîne list_spaces et get_analytics et vous répond en français, pas en tableau.

La vente hors ligne

Un contrat signé au téléphone ? « Enregistre 2 400 € sur le lien du salon » —track_sale, et l'attribution est complète.

Ce que l'agent lit : l'attribution et le ROAS

Et sans agent

Une API documentée en OpenAPI

Le serveur MCP et l'API v1 partagent le même registre : huit outils, une seule vérité. Vos scripts existants passent par l'API ; vos agents passent par le MCP ; personne n'attend une « intégration IA » de plus.

GET /api/v1/openapi.json

Le contrat complet, généré depuis le même registre d'outils. Ce que le MCP expose, l'API l'expose — jamais l'un sans l'autre.

8

outils, identiques entre MCP et API

1

clé d'API — la même pour les deux

0

SDK à installer côté agent

Questions fréquentes

Avec quels agents ça marche ?

Tout client MCP : Claude (Desktop et Code), et les autres clients compatibles avec le protocole. Le serveur parle le MCP standard — initialize, tools/list, tools/call — sans extension propriétaire.

L'agent peut-il casser quelque chose ?

Il fait exactement ce que sa clé d'API permet, dans l'espace de la clé. Pas de suppression de masse exposée : les outils créent, lisent et mettent à jour. Et chaque appel est journalisé comme un appel d'API normal.

C'est inclus dans quelle formule ?

L'API et le MCP sont liés à la clé d'API de votre espace. La création de clé est disponible dans le produit — les limites de votre formule s'appliquent aux liens créés, d'où qu'ils viennent.

Pourquoi un raccourcisseur a-t-il besoin d'un MCP ?

Parce que le travail autour des liens est conversationnel : on écrit une newsletter, on prépare une campagne, on fait un point client. L'agent est déjà dans la conversation — autant qu'il pose les liens et lise les chiffres sans changer d'onglet.

Branchez votre agent aujourd'hui

Créez un compte, générez une clé d'API, donnez l'URL du serveur MCP à votre agent. La première conversation qui finit par « lien posé, 3 clics déjà » est assez convaincante.

Commencer gratuitement