Passer au contenu principal
Connectez vos outils IA à Hyperline en utilisant le Model Context Protocol (MCP), un standard ouvert qui permet aux assistants IA d’interagir avec vos données de facturation, de gérer vos clients et d’automatiser vos opérations de revenus.

​
Qu’est-ce qu’Hyperline MCP ?

Hyperline MCP est notre serveur MCP hébergé qui donne aux outils IA un accès sécurisé à votre compte Hyperline. Il est conçu pour fonctionner de manière fluide avec les assistants IA populaires comme Claude, ChatGPT, Cursor et bien d’autres.

​
Pourquoi utiliser Hyperline MCP ?

  • Gestion de la facturation en langage naturel — Gérez les clients, abonnements et factures via une IA conversationnelle plutôt qu’en naviguant entre plusieurs écrans
  • Accès complet au compte — Les outils IA peuvent rechercher, lire, créer et mettre à jour des enregistrements dans tout votre compte Hyperline — clients, abonnements, factures, produits et données de consommation
  • Configuration facile — Connectez-vous via OAuth en un clic pour les outils IA pris en charge, ou utilisez un jeton API pour une authentification directe
  • Optimisé pour l’IA — Conçu spécifiquement pour les agents IA avec un formatage efficace des données et des réponses lisibles
  • Sécurisé par conception — S’authentifie avec vos identifiants Hyperline ; les opérations de lecture sont auto-approuvées tandis que les opérations d’écriture demandent confirmation

​
Que pouvez-vous faire avec Hyperline MCP ?

  • Gestion des clients — Consulter les détails d’un client, retrouver des contacts par e-mail ou nom, et créer de nouvelles fiches clients
  • Opérations sur les abonnements — Visualiser les abonnements actifs, vérifier les dates de renouvellement et gérer le cycle de vie des abonnements
  • Gestion des factures — Rechercher des factures par statut, consulter l’historique des paiements et suivre les paiements en retard
  • Suivi de la consommation — Interroger les données de consommation, vérifier les métriques d’usage et explorer les périodes de facturation
  • Analyse des revenus — Accéder au MRR, ARR et autres indicateurs clés via des requêtes en langage naturel
  • Catalogue produits — Parcourir les produits et tarifs, comprendre la structure de votre catalogue

​
Premiers pas

​
Prérequis

Avant de connecter Hyperline MCP, assurez-vous d’avoir :
  1. Un compte Hyperline actif
  2. Un client IA compatible MCP (Claude, ChatGPT, Cursor, VS Code, etc.)

​
Authentification

Le serveur Hyperline MCP utilise OAuth 2.0 pour l’authentification. La plupart des clients IA gèrent automatiquement le flux OAuth — vous serez simplement redirigé pour vous connecter avec vos identifiants Hyperline. Si votre client ne prend pas en charge OAuth (par exemple, dans un contexte serveur ou machine-à-machine), vous pouvez vous authentifier à l’aide d’un jeton API à la place. Les jetons API peuvent être générés depuis les Paramètres de votre espace de travail.

​
Connexion à Hyperline MCP

Ajoutez l’URL de serveur suivante à votre client IA : 
https://mcp.hyperline.co/mcp
Pour les environnements sandbox, utilisez plutôt https://sandbox.mcp.hyperline.co/mcp.
Pour Claude Desktop ou Claude.ai :
  1. Ouvrez Paramètres → Connecteurs
  2. Cliquez sur Ajouter un connecteur personnalisé
  3. Saisissez un nom (par exemple, hyperline) et l’URL : https://mcp.hyperline.co/mcp
  4. Suivez les invites OAuth pour vous connecter à votre compte Hyperline
Une fois connecté, vous serez authentifié avec accès aux données de votre compte Hyperline.
Si votre client MCP s’exécute dans un environnement serveur sans navigateur (par exemple, un agent backend ou un pipeline automatisé), vous pouvez ignorer OAuth et vous authentifier directement avec une clé API.Générez une clé API depuis les Paramètres de votre espace de travail, puis transmettez-la dans l’en-tête Authorization lors de la connexion au serveur MCP :
Authorization: Bearer <YOUR_API_KEY>
Par exemple, dans une configuration de client MCP qui prend en charge les en-têtes personnalisés :
{
  "mcpServers": {
    "hyperline": {
      "url": "https://mcp.hyperline.co/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Gardez votre clé API secrète. Ne la commitez pas dans un système de gestion de versions — utilisez plutôt des variables d’environnement ou un gestionnaire de secrets.

​
Accès multi-entreprises

Si votre utilisateur Hyperline a accès à plusieurs entreprises, le serveur MCP utilise par défaut la première entreprise (la plus ancienne) liée à votre compte. Pour cibler une entreprise spécifique, incluez l’en-tête Hyperline-CompanyId dans la configuration de votre serveur MCP : 
{
  "mcpServers": {
    "hyperline": {
      "url": "https://mcp.hyperline.co/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>",
        "Hyperline-CompanyId": "<YOUR_COMPANY_ID>"
      }
    }
  }
}
Vous pouvez récupérer la liste des entreprises auxquelles votre compte a accès en utilisant l’endpoint /v1/companies.

​
Outils pris en charge

Le serveur Hyperline MCP expose plus de 100 outils couvrant l’ensemble de vos opérations de facturation. Cela inclut la liste et la récupération des clients, devis, abonnements, factures et informations produits, ainsi que des actions comme la création et l’annulation de factures, la génération de devis, l’attribution d’abonnements, la consultation des données de consommation et l’accès aux métriques de revenus — entre autres. Une fois connecté, votre assistant IA découvre automatiquement tous les outils disponibles. Décrivez simplement ce dont vous avez besoin en langage naturel, et l’assistant utilisera les bons outils pour accomplir la tâche.

​
Exemples de prompts

​
Recherche de clients et comptes

PromptAction
« Trouve tous les clients ayant des factures en retard »Recherche les clients ayant des factures impayées dépassant la date d’échéance
« Quel est l’e-mail d’Acme Corp ? »Recherche les informations de contact d’un client spécifique
« Montre-moi tout ce que nous savons sur le client X »Récupère les informations complètes d’un client
« Trouve les clients sur le forfait Enterprise »Filtre les clients par forfait d’abonnement
« Liste les clients créés au cours des 30 derniers jours »Affiche les clients récemment acquis

​
Abonnements et facturation

PromptAction
« Quels abonnements possède Acme Corp ? »Liste tous les abonnements d’un client
« Montre-moi les abonnements qui se renouvellent la semaine prochaine »Trouve les renouvellements à venir
« Quels clients sont sur le forfait Pro ? »Liste les clients filtrés par forfait
« Crée un abonnement pour le client X sur le forfait Starter »Crée un nouvel abonnement

​
Factures et paiements

PromptAction
« Liste les factures impayées des 30 derniers jours »Recherche les factures en attente
« Quel est le montant total facturé ce mois-ci ? »Calcule le total de facturation mensuel
« Montre-moi l’historique de paiement d’Acme Corp »Récupère les enregistrements de paiement d’un client
« Trouve les factures de plus de 10 000 $ »Filtre les factures par montant

​
Analyse des revenus

PromptAction
« Quel est mon MRR actuel ? »Renvoie le revenu récurrent mensuel
« Montre-moi les tendances de revenus du dernier trimestre »Affiche les métriques de revenus dans le temps
« Combien d’abonnements actifs avons-nous ? »Compte les abonnements actifs
« Quel est notre taux d’attrition ce mois-ci ? »Calcule les métriques d’attrition

​
Bonnes pratiques de sécurité

Traitez vos identifiants et vos données de facturation comme des informations sensibles. Ne vous connectez qu’à des applications IA de confiance et utilisez les identifiants sandbox lors de vos expérimentations.

​
Sécurité des outils

Hyperline MCP utilise les annotations de sécurité MCP :
  • Opérations de lecture — Auto-approuvées pour une recherche et une consultation fluides
  • Opérations d’écriture — Demandent une confirmation utilisateur avant de créer ou de mettre à jour des données

​
Permissions utilisateur

Hyperline MCP respecte vos permissions utilisateur existantes. Les outils disponibles via le serveur MCP dépendent des rôles et permissions configurés pour votre compte utilisateur dans les Paramètres de votre espace de travail, ou des scopes de la clé API. Les assistants IA ne peuvent accéder et modifier que ce que vous êtes autorisé à faire dans Hyperline. Vous pouvez révoquer l’accès à tout moment en supprimant les clés API ou en révoquant l’accès des utilisateurs.

​
Limites de débit

Les limites de débit standard de l’API s’appliquent à toutes les opérations MCP. Voir Limitation du débit pour plus de détails. Dans la plupart des cas, un usage conversationnel normal reste largement en dessous des limites.

​
Dépannage

Si votre assistant IA ne parvient pas à se connecter à Hyperline :
  1. Vérifiez vos identifiants — Assurez-vous que les identifiants sont corrects et n’ont pas été régénérés ou révoqués
  2. Vérifiez l’environnement — Assurez-vous d’utiliser l’URL correcte pour votre environnement (production vs sandbox)
  3. Testez la connexion — Essayez une requête simple comme « Lister les clients » pour vérifier que la connexion fonctionne
  4. Vérifiez les permissions — Assurez-vous que votre utilisateur Hyperline possède les permissions nécessaires pour les opérations que vous tentez
Quelque chose reste flou ? N’hésitez pas à contacter notre équipe via le chat in-app si vous avez besoin d’aide supplémentaire.