Voipstudio MCP Server

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 messages vocaux. Une fois connecté, Claude peut interroger les appels, analyser les tendances, faire ressortir les problèmes de performance des agents et générer des rapports d'assurance qualité en langage clair, sans aucun développement personnalisé requis.

Ajoutez le CX Addon et chaque enregistrement arrive pré-enrichi avec une transcription, un résumé, un sentiment, des actions à mener et un score CX. Cela réduit considérablement le travail d'IA que Claude doit effectuer, maintenant ainsi votre consommation de jetons à un niveau bas et vos 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, de sorte que 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. Allez dans 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 en forme d'œ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 d'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 d'expiration plus long (ou illimité) si nécessaire avant de cliquer sur Ajouter.

Voir la documentation de l'API REST

Connexion à Claude¶

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

URL du serveur MCP¶

URL du serveur MCP

https://mcp.voipstudio.workers.dev/sse

Étapes (Claude.ai)¶

1. Dans Claude.ai, allez dans Paramètres → Intégrations (ou le 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 l'authentification vous est demandée, 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 un nombre important de jetons par enregistrement.

Avec le CX Addon, VoIPstudio gère la transcription, le résumé, l'analyse des sentiments, l'extraction d'actions et la notation CX sur sa propre infrastructure à un coût mensuel fixe, sans frais par appel et sans limites de transcription. Claude reçoit des renseignements finis — prêts à être exploités immédiatement.

Sans CX Addon	Avec CX Addon
Transcription	Claude doit récupérer l'audio et transcrire/traduire	✓ Inclus, avec diarisation
Résumé	Claude doit générer	✓ Inclus
Sentiment	Claude doit déduire	✓ Inclus
Actions à mener	Claude doit extraire	✓ Inclus
Score CX	Non disponible	✓ 1–10 sur chaque appel
Jetons/appel approx.	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	string	Transcription complète au niveau des mots
transcript_speakers	object	Segments de transcription avec diarisation des locuteurs
summary	string	Résumé concis du résultat de l'appel
sentiment	string	Sentiment du client : positif, neutre, négatif
cx_score	number (1–10)	Score d'expérience client
metadata.timeline	array	Moments clés et actions à mener 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 qu'à la place, de simples invites peuvent aider la plateforme d'IA à donner un sens aux données fournies par Voipstudio et à répondre de manière 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	array	—	Objets de filtre — voir Filtrage
limit	number	10	Enregistrements par page (max 1000)
page	number	1	Numéro de page

Champs de réponse

Champ	Type	Description
id	number	ID d'enregistrement unique
call_id	number	Lié au call_id du CDR
timestamp	string	Début de l'enregistrement (UTC, AAAA-MM-JJ HH:mm:ss)
caller	string	Numéro de l'appelant
called	string	Numéro de l'appelé
src_name	string	Nom de l'agent (source)
dst_name	string	Nom de la destination
duration	number	Durée en secondes
type	string	I \= entrant, O \= sortant
context	string	Contexte de l'appel (ex. LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

Exemple – Scores CX bas cette semaine

Demandez à Claude : "Montre-moi tous les enregistrements de cette semaine où le score CX était inférieur à 6, regroupé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 de Détails d'Appels (CDR) – le journal brut de chaque branche d'appel. À utiliser pour les statistiques de volume, l'analyse des coûts, les distributions de durée et les résumés d'activité des agents. Disponible sans le CX Addon.

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

Champs de réponse clés

Champ	Type	Description
call_id	number	Identifiant d'appel unique
calldate	string	Horodatage de début d'appel (UTC)
src_name	string	Nom de l'agent / appelant
dst_name	string	Nom de la destination
billsec	number	Secondes facturables
duration	number	Secondes totales, y compris la sonnerie
disposition	string	CONNECTÉ, PAS DE RÉPONSE, OCCUPÉ, ÉCHEC
charge	number	Coût de l'appel
type	string	I \= entrant, O \= sortant
src_ua	string	Appareil source / user-agent du softphone
labels	array	Étiquettes 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 sont dessus ?"

get_voicemails¶

Récupère les messages vocaux. 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 (number) — le champ id d'une réponse get_recordings.

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 filtre a trois propriétés :

Propriété	Description
property	Nom du champ sur lequel filtrer (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 d'AQ par agent¶

"Donne-moi un résumé AQ pour chaque agent ce mois-ci — moyennes des scores CX, thèmes de plaintes courants, et leurs trois appels les moins bien notés avec résumés."

Statistiques de volume du centre d'appels¶

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

Analyse des tendances de sentiment¶

"Le sentiment des clients s'améliore-t-il ou se dégrade-t-il par rapport au mois dernier ? Quels sujets d'appel sont corrélés à un sentiment négatif ?"

Liste de suivi des appels manqués¶

"Liste tous les appels entrants manqués des dernières 24 heures avec les ID d'appelant, afin que je puisse prioriser les rappels."

Examen des coûts et de la facturation¶

"Quels postes ont passé 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élègue entièrement cela à VoIPstudio :

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

• Transcription audio
• Diarisation des locuteurs
• Résumé d'appel
• Classification des sentiments
• Extraction des actions à mener
• Notation CX

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

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