API et serveur MCP

cutty dispose d'une API publique et d'un serveur MCP. La première permet de créer et de modifier des liens via le code, la seconde — directement depuis un assistant IA utilisant le protocole MCP. Les deux utilisent la même clé API.

Clé API

Chaque appel doit être authentifié avec l'en-tote :

Authorization: Bearer ck_votre_clé

Où trouver la clé : connectez-vous, allez dans le panneau de configuration → Clés API → Créer une clé. La clé complète (commençant par ck_) n'est affichée qu'une seule fois lors de sa création — enregistrez-la immédiatement dans un endroit sûr. La limite est de 120 requêtes par minute par clé.

Adresse de base

Tous les endpoints REST sont disponibles sous https://cutty.dev/api/v1. Les requêtes et les réponses sont au format JSON.

Création de lien

POST /api/v1/links — dans le corps JSON, vous devez fournir au moins l'élément url. Le reste est optionnel :

• url — adresse de destination (requis)
slug — votre propre extension, 3 à 40 caractères ; si omis = aléatoire
• expiresAt — date d'expiration au format ISO 8601
• maxHits — limite de clics (1–1 000 000)
• password — mot de passe pour protéger le lien
• utmSource, utmMedium, utmCampaign — paramètres UTM ajoutés lors de la redirection

En réponse, vous recevez le slug, le shortUrl et la target.

curl -X POST https://cutty.dev/api/v1/links \
  -H "Authorization: Bearer ck_votre_clé" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/adresse/tres/longue","slug":"offre"}'

Liste et lien individuel

GET /api/v1/links renvoie tous vos liens. GET /api/v1/links/{slug} — les détails d'un seul lien.

curl https://cutty.dev/api/v1/links/offre \
  -H "Authorization: Bearer ck_votre_clé"

Modification et suppression

PATCH /api/v1/links/{slug} met à jour les champs sélectionnés (ex: targetUrl, expiresAt, maxHits, status, password). DELETE /api/v1/links/{slug} supprime le lien.

curl -X PATCH https://cutty.dev/api/v1/links/offre \
  -H "Authorization: Bearer ck_votre_clé" \
  -H "Content: application/json" \
  -d '{"maxHits":500}'

Serveur MCP

Si vous travaillez avec un assistant IA, vous pouvez connecter cutty via MCP (Model Context Protocol) et lui demander de raccourcir et d'organiser vos liens directement dans la conversation. Le serveur est disponible sous https://mcp.cutty.dev/mcp via le transport Streamable HTTP, et vous vous authentifiez avec la même clé API — l'en-tête Authorization: Bearer ck_....

Outils disponibles : create_link, list_links, get_link, update_link, delete_link et qr_link (générer un code QR pour le lien).

Exemple d'entrée dans la configuration du client MCP :

{
  "mcpServers": {
    "cutty": {
      "url": "https://mcp.cutty.dev/mcp",
      "headers": {
        "Authorization": "Bearer ck_votre_clé"
      }
    }
  }

Un problème ?

Écrivez à [email protected] — je réponds le jour même.