Connectez Ringhum à Claude et à d'autres outils d'IA (MCP)

Ringhum dispose d'un serveur MCP. MCP (Model Context Protocol) est une façon standard pour les applications d'IA d'utiliser des outils externes. Une fois Ringhum connecté à une application d'IA comme Claude ou ChatGPT, vous pouvez lui poser des questions sur votre espace de travail en langage naturel. Par exemple : « Résume les appels manqués d'hier », « Quels appelants ont demandé un rappel cette semaine ? » ou « Ajoute nos nouveaux horaires d'ouverture aux FAQ ». L'application d'IA fonctionne avec les mêmes règles et permissions que l'API Ringhum.

Ce dont vous avez besoin

• URL du serveur : https://ringhum.com/mcp. Elle est aussi affichée dans la carte Serveur MCP de la page Développeurs, avec un bouton Copier.
• Une application d'IA compatible avec les serveurs MCP distants, comme Claude, ChatGPT, Claude Code, Cursor, Windsurf ou VS Code.
• Le rôle Propriétaire ou Admin dans l'espace de travail. Seuls les propriétaires et admins peuvent connecter une application ou créer une clé API.

Il existe deux façons de se connecter. Se connecter est le plus simple et convient aux applications de chat comme Claude et ChatGPT. Une clé API convient aux outils de développement qui utilisent une URL et un en-tête.

Accès en lecture seule ou en lecture et modification

Vous choisissez ce que l'application d'IA peut faire.

Avec un accès en lecture seule, les outils qui modifient des données ne sont pas proposés du tout à l'application.

Important : avec l'accès en modification, l'application d'IA peut envoyer de vrais messages et passer de vrais appels à vos clients. Ringhum signale ces outils comme sortant de votre espace de travail, et les suppressions comme destructrices, la plupart des applications d'IA vous demandent donc confirmation avant de les exécuter. Lisez ce que l'application s'apprête à faire avant d'approuver.

Connecter Claude en vous connectant

1. Dans Claude (sur le web, sur ordinateur ou sur mobile), ouvrez Paramètres → Connecteurs et choisissez Ajouter un connecteur personnalisé.
2. Collez https://ringhum.com/mcp comme URL et enregistrez.
3. Cliquez sur Connecter. Une page Ringhum s'ouvre. Connectez-vous si on vous le demande.
4. Sur la page Connecter, choisissez l'Espace de travail que l'application peut utiliser.
5. Sous Ce qu'elle peut faire, choisissez Consulter ou Consulter et modifier.
6. Cliquez sur Autoriser. Vous êtes renvoyé vers Claude.

L'application ne voit jamais votre mot de passe. Les noms exacts des menus dans Claude peuvent changer avec le temps ; cherchez connecteurs ou intégrations dans ses paramètres.

ChatGPT : ajoutez l'URL comme connecteur personnalisé (serveur MCP) sous Paramètres → Applications et connecteurs, puis cliquez sur Connecter et suivez les étapes 3 à 6.

Claude Code : exécutez la commande ci-dessous, puis exécutez /mcp et choisissez S'authentifier.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Une fois l'accès autorisé, la connexion se renouvelle d'elle-même tant que vous l'utilisez. Si l'application n'est pas utilisée pendant 90 jours, vous devrez vous reconnecter.

Connecter avec une clé API

Utilisez ceci pour les outils qui vous permettent de définir un en-tête de requête, ou lorsque vous ne voulez pas vous connecter.

1. Sur Développeurs, créez une clé API. Cochez uniquement read pour une connexion en lecture seule, ou read et write pour autoriser les modifications. Voir Clés API et portées.
2. Ajoutez le serveur à votre application avec la clé dans l'en-tête Authorization.

Claude Code :

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf et Claude Desktop :

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json) :

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Une application ne pouvant exécuter que des serveurs locaux peut se connecter via npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Ce que couvrent les outils

Chaque opération de l'API Ringhum est disponible comme outil : votre compte et son utilisation, les assistants, numéros de téléphone, appels et transcriptions, contacts, rendez-vous et disponibilité, commandes et produits, réservations de chambres, la boîte de réception, les SMS et messages WhatsApp, campagnes, webhooks, le profil de l'entreprise, services, FAQ et base de connaissances, questions sans réponse, liens de paiement, demandes d'avis, revenus et protection contre les indésirables. Les enregistrements d'appels sont la seule exception : ils ne sont pas disponibles comme outil.

Chaque outil exécute la requête API correspondante, si bien que les mêmes limites de forfait, validations et limites de débit s'appliquent. Les appels d'outils comptent dans la limite de 120 requêtes par minute de l'API. La liste complète des outils se trouve dans la section MCP de la référence API sur /docs.

Voir et déconnecter les applications connectées

Les applications que vous avez connectées en vous connectant sont listées sur Développeurs sous Applications d'IA connectées, avec qui les a connectées, leur Accès (Lecture seule ou Lecture et modification) et leur dernière utilisation.

Pour retirer une application, cliquez sur Déconnecter et confirmez. Elle perd l'accès immédiatement et doit être approuvée à nouveau. Pour changer l'accès d'une application, déconnectez-la et reconnectez-la avec l'autre choix.

Pour une connexion faite avec une clé API, révoquez la clé sous Clés API.

Dépannage

« Seuls les propriétaires et admins d'un espace de travail peuvent connecter des applications. » Demandez au propriétaire de l'espace de travail de connecter l'application, ou de vous faire Admin. Voir Invitez votre équipe.

« La demande de connexion a expiré. Recommencez la connexion depuis votre application d'IA. » La page d'approbation est restée ouverte trop longtemps. Recommencez depuis l'application d'IA.

L'application dit qu'elle n'est pas autorisée, ou vous demande de vous reconnecter. L'application a été déconnectée, la clé a été révoquée, ou vous n'êtes plus membre de l'espace de travail. Reconnectez-la.

L'application ne peut pas effectuer de modifications. Elle a été connectée avec un accès en lecture seule, ou sa clé API n'a pas la portée write.

L'application consulte le mauvais espace de travail. Demandez-lui d'appeler who_am_i pour vérifier. Chaque connexion utilise un espace de travail. Déconnectez-la et reconnectez-la pour en choisir un autre.