Voipstudio MCP

IA - Intelligence Artificielle - Serveur MCP VoIPstudio

Le serveur MCP (Model Context Protocol) VoIPstudio donne à Claude AI un accès direct et sécurisé aux données de votre compte VoIPstudio, y compris les enregistrements, les CDR, les appels en direct et les messageries vocales. Une fois connecté, Claude peut interroger les appels, analyser les tendances, mettre en évidence les problèmes de performance des agents et générer des rapports QA en langage naturel, sans développement personnalisé requis.

Ajoutez le CX Addon et chaque enregistrement arrive pré-enrichi avec une transcription, un résumé, un sentiment, des éléments d'action et un score CX. Cela réduit considérablement le travail d'IA que Claude doit effectuer, ce qui maintient votre utilisation de jetons à un niveau bas et rend les coûts plus prévisibles.

Obtenir une clé API

Le serveur MCP s'authentifie à l'aide d'un jeton API VoIPstudio. Chaque clé est limitée à un utilisateur spécifique, donc Claude ne pourra accéder qu'aux données auxquelles cet utilisateur peut accéder.

Pour générer une clé :

1. Dans le tableau de bord d'administration, ouvrez l'utilisateur pour lequel vous souhaitez générer un jeton.
2. Accédez à la section Clés API.
3. Saisissez un nom pour la clé — par exemple, Claude MCP.
4. Cliquez sur Ajouter.
5. Cliquez sur l'icône œil pour révéler la clé API / user_token. Copiez cette valeur.
6. Pour afficher plus de détails ou supprimer la clé, cliquez sur l'icône engrenage et sélectionnez Afficher les détails.

Remarque : La clé API reste valide tant qu'elle est utilisée au moins une fois tous les 7 jours (délai d'expiration par défaut). Définissez un délai plus long (ou illimité) si nécessaire avant de cliquer sur Ajouter.

Voir Documentation de l'API REST

Connexion à Claude

VoIPstudio n'est actuellement pas répertorié dans le répertoire de connecteurs Claude.ai. Vous l'ajoutez manuellement en tant que serveur MCP personnalisé.

URL du serveur MCP

[!info] URL du serveur MCP https://mcp.voipstudio.workers.dev/sse

Étapes (Claude.ai)

1. Dans Claude.ai, accédez à Paramètres → Intégrations (ou au panneau des connecteurs, selon votre forfait).
2. Choisissez Ajouter un serveur MCP personnalisé (ou équivalent).
3. Saisissez l'URL du serveur MCP ci-dessus.
4. Lorsque vous êtes invité à vous authentifier, fournissez votre clé API VoIPstudio.
5. Enregistrez et autorisez la connexion.

Claude peut désormais appeler les outils VoIPstudio dans n'importe quelle conversation. La première fois qu'un outil est appelé dans une session, Claude vous demandera de confirmer le partage de données. Cliquez sur Toujours autoriser pour ignorer cette invite lors des sessions futures.

API Anthropic (pour les développeurs)

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

Connexion à d'autres plateformes d'IA

La plupart des plateformes d'IA qui prennent en charge les MCP externes peuvent se connecter au serveur MCP VoIPstudio en utilisant la même URL et la même clé API. Les étapes de configuration exactes varient selon la plateforme. Recherchez une option intitulée serveur MCP externe, MCP personnalisé ou MCP distant dans les intégrations ou les paramètres de votre plateforme.

CX Addon

Sans le CX Addon, les enregistrements arrivent sous forme de métadonnées brutes. Claude doit transcrire et analyser chaque appel lui-même, consommant des jetons importants par enregistrement.

Avec le CX Addon, VoIPstudio gère la transcription, la synthèse, l'analyse des sentiments, l'extraction des actions et le score CX sur sa propre infrastructure à un coût mensuel fixe sans frais par appel et sans limites de transcription. Claude reçoit des informations finalisées — prêtes à être analysées immédiatement.

	Sans CX Addon	Avec CX Addon
Transcription	Claude doit récupérer l'audio et transcrire/traduire	✓ Incluse, avec diarisation des locuteurs
Résumé	Claude doit générer	✓ Inclus
Sentiment	Claude doit déduire	✓ Inclus
Éléments d'action	Claude doit extraire	✓ Inclus
Score CX	Non disponible	✓ 1–10 sur chaque appel
Env. jetons/appel	10 000–15 000	300–500
Modèle de coût	Dépenses IA variables	Abonnement mensuel fixe

Champs débloqués par le CX Addon

Champ	Type	Description
transcript	chaîne	Transcription complète mot pour mot
transcript_speakers	objet	Segments de transcription avec diarisation des locuteurs
summary	chaîne	Résumé concis du résultat de l'appel
sentiment	chaîne	Sentiment du client : positive, neutral, negative
cx_score	nombre (1–10)	Score d'expérience client
metadata.timeline	tableau	Moments clés et éléments d'action extraits de l'appel

Référence des outils

La simplicité de l'intégration MCP signifie que les API complexes n'ont pas besoin d'être comprises et, à la place, des invites simples peuvent aider la plateforme d'IA à donner un sens aux données fournies par VoIPstudio et à répondre avec une réponse appropriée.

Cependant, certains utilisateurs plus techniques peuvent souhaiter savoir ce qui se passe « sous le capot », voici donc un guide de référence pour certaines des fonctions du serveur MCP.

get_recordings

Renvoie les enregistrements d'appels. Avec le CX Addon actif, chaque enregistrement inclut la transcription, le résumé, le sentiment, le score CX et la chronologie. Sans l'addon, ces champs renvoient null.

Paramètres

Paramètre	Type	Défaut	Description
filters	tableau	—	Objets de filtre — voir Filtrage
limit	nombre	10	Enregistrements par page (max 1000)
page	nombre	1	Numéro de page

Champs de réponse

Champ	Type	Description
id	nombre	Identifiant unique de l'enregistrement
call_id	nombre	Liens vers le CDR call_id
timestamp	chaîne	Début de l'enregistrement (UTC, YYYY-MM-DD HH:mm:ss)
caller	chaîne	Numéro de la partie appelante
called	chaîne	Numéro de la partie appelée
src_name	chaîne	Nom de l'agent (source)
dst_name	chaîne	Nom de la destination
duration	nombre	Durée en secondes
type	chaîne	I \= entrant, O \= sortant
context	chaîne	Contexte de l'appel (par ex. LOCAL_USER, QUEUE)
transcript	chaîne	null
transcript_speakers	objet	null
summary	chaîne	null
sentiment	chaîne	null
cx_score	nombre	null
metadata.timeline	tableau	null

Exemple – Scores CX faibles cette semaine

Demandez à Claude : « Affichez-moi tous les enregistrements de cette semaine où le score CX était inférieur à 6, groupés par agent, avec un résumé de ce qui n'a pas fonctionné sur chaque appel. »

Claude appelle l'outil avec :

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs

Enregistrements détaillés des appels – le journal brut de chaque segment d'appel. Utilisez-les pour les statistiques de volume, l'analyse des coûts, les distributions de durée et les résumés d'activité des agents. Disponibles sans le CX Addon.

Paramètres : identiques à get_recordings (filters, limit, page)

Champs de réponse clés

Champ	Type	Description
call_id	nombre	Identifiant unique de l'appel
calldate	chaîne	Horodatage de début d'appel (UTC)
src_name	chaîne	Nom de l'agent / de l'appelant
dst_name	chaîne	Nom de la destination
billsec	nombre	Secondes facturables
duration	nombre	Secondes totales incluant la sonnerie
disposition	chaîne	CONNECTED, NO ANSWER, BUSY, FAILED
charge	nombre	Coût de l'appel
type	chaîne	I \= entrant, O \= sortant
src_ua	chaîne	Appareil source / agent utilisateur softphone
labels	tableau	Balises personnalisées appliquées dans VoIPstudio

get_live_calls

Renvoie un instantané en temps réel de tous les appels actifs sur votre compte. Aucun paramètre requis.

Exemple : « Combien d'appels sont en cours en ce moment, et quels agents y sont engagés ? »

get_voicemails

Récupère les messages de messagerie vocale. Même interface filters, limit et page que les autres outils.

Champs filtrables clés : src, dst, calldate, duration, listened

get_recording_audio

Renvoie une URL de téléchargement direct pour l'audio MP3 d'un enregistrement spécifique.

Paramètre : id (nombre) — le champ id d'une réponse get_recordings.

[!info] Info Les URL audio sont limitées dans le temps. Utilisez-les rapidement ; ne les mettez pas en cache pendant de longues périodes.

Filtrage et pagination

Tous les outils de liste acceptent un tableau filters optionnel. Chaque objet de filtre possède trois propriétés :

Propriété	Description
property	Nom du champ à filtrer (par ex. calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	Chaîne, nombre ou tableau (pour l'opérateur in)

Exemples courants

Plage de dates

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

Seuil de score CX

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

Agent spécifique

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

Appels connectés uniquement

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

Appels entrants de plus de 5 minutes

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

Cas d'utilisation

Rapport QA

« Donnez-moi un résumé QA pour chaque agent ce mois-ci — moyennes des scores CX, thèmes de réclamation courants et leurs trois appels les moins bien notés avec résumés. »

Statistiques de volume du centre d'appels

« Quel était notre volume d'appels par jour cette semaine ? Quel était notre temps moyen de traitement, et combien d'appels sont restés sans réponse ? »

Analyse des tendances de sentiment

« Le sentiment client s'améliore-t-il ou se dégrade-t-il par rapport au mois dernier ? Quels sujets d'appels sont corrélés à un sentiment négatif ? »

Liste de rappel des appels manqués

« Listez tous les appels entrants manqués des dernières 24 heures avec les identifiants des appelants, afin que je puisse prioriser les rappels. »

Revue des coûts et de la facturation

« Quelles extensions ont effectué les appels sortants les plus coûteux ce trimestre ? »

Vérification des opérations en direct

« Combien d'agents sont actuellement en appel, et y a-t-il des appels qui durent depuis plus de 20 minutes ? »

Efficacité des jetons

Chaque appel que Claude analyse sans le CX Addon nécessite que Claude traite le contenu audio et génère sa propre transcription et analyse. Le CX Addon décharge entièrement cela sur VoIPstudio :

Ce que VoIPstudio gère (coût mensuel fixe, appels illimités) :

• Transcription audio
• Diarisation des locuteurs
• Résumé des appels
• Classification des sentiments
• Extraction des éléments d'action
• Score CX

Ce que Claude reçoit : Des champs de texte propres et structurés prêts pour le raisonnement, la comparaison et le reporting.

Cela signifie que vous pouvez demander à Claude d'analyser des centaines d'appels en une seule session à une fraction du coût en jetons, rendant les rapports QA à grande échelle, l'analyse des tendances et les rapports de coaching des agents pratiques sans dépenses IA imprévisibles.