Claude MCP

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux assistants IA comme Claude d'accéder de façon sécurisée à des outils et sources de données externes. Finn expose un serveur MCP : vous pouvez donc connecter Finn à Claude (ou à tout client compatible MCP) et laisser votre assistant IA interroger, configurer et piloter la plateforme par conversation.

À qui cela s'adresse. Aux utilisateurs avancés — développeurs, ingénieurs en automatisation et opérateurs à l'aise avec l'IA — qui souhaitent piloter Finn depuis Claude Desktop, Claude Code ou tout autre client MCP. Si vous ne connaissez pas Claude ou MCP, cela ne vous est pas nécessaire : le tableau de bord fait tout ce qu'expose le MCP.

Statut : le serveur MCP Finn est en bêta publique. Les API sont stables, mais de nouveaux outils sont ajoutés régulièrement.

Ce que vous pouvez faire avec le MCP

Une fois connecté, votre Claude (ou toute autre IA compatible MCP) peut effectuer les actions suivantes en votre nom :

Opérations de lecture

• Consulter l'état de n'importe quel déploiement.
• Lister vos Finns, audiences et numéros de téléphone.
• Récupérer les transcriptions d'appels et les analyses sur n'importe quelle période.
• Rechercher des motifs précis dans l'historique des appels (« montre-moi les appels où l'appelant a mentionné “remboursement” »).
• Consulter les coûts de déploiement, l'utilisation du forfait et les récapitulatifs de facturation.

Opérations d'écriture

• Lancer un nouveau déploiement.
• Mettre en pause ou arrêter un déploiement actif.
• Ajouter des contacts à une audience.
• Mettre à jour les champs d'analyse post-appel d'un Finn.
• Bloquer des numéros (ajout à la liste rouge).

Coordination

• Générer automatiquement des rapports hebdomadaires ou mensuels.
• Recouper les résultats d'appels avec votre CRM pour détecter les écarts d'attribution.
• Créer automatiquement un déploiement lorsqu'une liste CRM atteint une taille seuil.
• Résumer un déploiement en langage clair, adapté au partage avec une partie prenante non technique.

Configuration du serveur MCP

Étape 1 — Générer un jeton MCP

Paramètres → Intégrations → MCP → Générer un jeton.

Copiez le jeton immédiatement : il ne s'affiche qu'une seule fois. Conservez-le dans votre gestionnaire de mots de passe ou votre coffre à secrets.

Les portées du jeton sont configurables :

• Lecture seule — interroger les données sans les modifier
• Lecture + écriture — accès opérationnel complet (à manier avec prudence)
• Limité à certains Finns/audiences — restreindre l'accès à un sous-ensemble

Pour la plupart des utilisateurs, commencez en Lecture seule pour vous familiariser, puis élargissez ensuite.

Étape 2 — Configurer votre client MCP

Claude Desktop (Mac, Windows) :

Modifiez le fichier de configuration de Claude Desktop :

• Mac : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez le serveur Finn :

{
  "mcpServers": {
    "finnai": {
      "command": "npx",
      "args": ["-y", "@finnai/mcp-server"],
      "env": {
        "FINNAI_API_TOKEN": "your_token_here"
      }
    }
  }
}

Redémarrez Claude Desktop. Les outils Finn deviennent disponibles dans toutes les conversations.

Claude Code (CLI) :

claude mcp add finnai \
  --command "npx -y @finnai/mcp-server" \
  --env FINNAI_API_TOKEN=your_token_here

Puis claude depuis n'importe quel répertoire — les outils Finn sont disponibles.

Autres clients MCP (Continue, Cursor, personnalisés) :

Utilisez la même commande npx dans la configuration du serveur MCP de votre client. Le serveur communique en MCP standard via stdio.

Étape 3 — Tester la connexion

Dans Claude (quel que soit le client), demandez :

« Quels Finns ai-je configurés ? »

Si la connexion fonctionne, Claude appelle l'outil list_finns et répond concrètement.

Outils exposés par le MCP

Le serveur fournit une trentaine d'outils. Principaux :

Gestion des Finns

• list_finns — lister tous les Finns du compte.
• get_finn — récupérer la configuration complète d'un Finn.
• create_finn — créer un Finn (avancé).
• update_finn — modifier les paramètres d'un Finn.

Gestion des audiences

• list_audiences — lister toutes les audiences.
• get_audience_stats — effectifs, statut de validation, imports récents.
• add_contacts — ajouter des contacts en masse.
• remove_contact — supprimer un contact.

Cycle de vie des déploiements

• list_deployments — lister les déploiements passés et actifs.
• launch_deployment — en démarrer un nouveau.
• pause_deployment / resume_deployment / stop_deployment.
• get_deployment_status — statut en direct avec le nombre d'appels en cours.

Analytique

• get_deployment_analytics — métriques complètes d'un déploiement.
• search_calls — rechercher les appels correspondant à des motifs de contenu.
• get_call — récupérer la transcription et l'analyse d'un appel.
• aggregate_calls — agrégations personnalisées sur n'importe quel champ et n'importe quelle période.

Conformité

• add_to_suppression_list — bloquer un numéro globalement.
• remove_from_suppression_list — débloquer.
• check_suppression — un numéro figure-t-il sur la liste ?

Facturation

• get_usage_this_month — dépenses en cours.
• forecast_month_end — projection selon la trajectoire.
• set_spend_cap — ajuster les plafonds.

Schéma complet de chaque outil : api.hirefinn.ai/academy/mcp.

Ce que vous pouvez demander à Claude

Des prompts qui fonctionnent vraiment :

« Montre-moi les résultats des déploiements d'hier et dis-moi quel Finn a été le plus performant. »

« Trouve tous les appels de la semaine dernière où l'interlocuteur a dit "trop cher" et résume le contexte commun. »

« Lance le même déploiement que celui de lundi dernier, mais sur la nouvelle audience que j'ai importée ce matin. »

« Combien avons-nous dépensé la semaine dernière, et sommes-nous dans les clous par rapport au budget ? »

« Ajoute ces numéros de téléphone à la liste de suppression : [coller la liste] »

« Quelle est la différence de taux de réussite entre nos appels du matin et ceux de l'après-midi ? »

« Génère un résumé d'une page de la campagne de rappels de rendez-vous du mois dernier pour la responsable de la clinique. »

Le MCP rend Finn conversationnel. Des opérations qui demanderaient 5 à 10 clics dans le tableau de bord se réduisent à une simple demande en langage naturel.

Considérations de sécurité

Ce que le jeton permet de faire

Les portées du jeton déterminent ce qui est autorisé :

• Jeton en lecture seule → peut tout interroger, mais ne rien modifier.
• Lecture + écriture → accès opérationnel complet. À traiter comme le mot de passe de votre tableau de bord.
• Jetons à portée restreinte → limités par ID de Finn, ID d'audience ou type d'opération.

Bonnes pratiques

• Ne collez pas de jetons dans des messages de chat. Utilisez des variables d'environnement dans la configuration de votre client MCP.
• Renouvelez régulièrement les jetons. Paramètres → Intégrations → MCP → Renouveler.
• Utilisez des jetons à portée restreinte pour les membres de l'équipe. Ne donnez pas de jeton à accès complet à un prestataire.
• Journal d'audit. Chaque appel MCP est journalisé. Paramètres → Intégrations → MCP → Journal d'activité.
• Révoquez immédiatement tout jeton divulgué. Paramètres → Intégrations → MCP → Révoquer.

Ce que Claude ne peut pas faire

Le MCP n'expose pas :

• La création et la suppression de comptes
• La modification des moyens de paiement
• Les changements de forfait (supérieur ou inférieur)
• Les invitations de membres d'équipe
• La configuration SSO

Ces actions nécessitent un accès au tableau de bord. C'est volontaire : ce sont des décisions qui doivent revenir à un humain.

Approuver les actions sensibles

Par défaut, le MCP exige une approbation humaine explicite (via le système de permissions de votre client MCP) pour toute opération d'écriture :

• Lancer des déploiements
• Ajouter ou supprimer des contacts
• Modifier la configuration d'un Finn
• Dépenser de l'argent

C'est appliqué au niveau du protocole : Claude ne peut pas exécuter d'écriture sans votre confirmation dans l'interface du client. Les opérations de lecture ne nécessitent pas d'approbation.

Vous pouvez désactiver cette option outil par outil dans Paramètres → Intégrations → MCP → Liste d'approbation automatique si vous souhaitez que certains outils s'exécutent sans confirmation. À utiliser avec parcimonie — approuver automatiquement « launch_deployment » est un excellent moyen de dépenser beaucoup d'argent très vite.

Cas d'usage courants

Point quotidien

Configurez Claude pour récupérer les métriques de la veille chaque matin :

« Chaque jour ouvré à 9 h, résume les résultats de déploiement de la veille, signale les anomalies et publie-les sur mon Slack. »

(Nécessite Claude Code avec tâches planifiées, ou votre propre cron avec un wrapper MCP.)

Détection d'anomalies

« Vérifie si un déploiement des dernières 24 heures a eu un taux de réussite inférieur à 50 % ou un coût supérieur à 2 fois sa moyenne sur 7 jours. Signale-les avec le détail. »

Audit en masse

« Liste tous les Finns qui n'ont pas de champs d'analyse post-appel définis. Propose des valeurs par défaut pertinentes pour chacun à partir de la description d'identité du Finn. »

Exports rapides

« Extrais tous les appels du déploiement X où qualified=true, exporte-les en CSV et envoie-les-moi par e-mail. »

Dépannage

« Claude ne trouve pas les outils Finn »

• Redémarrez Claude Desktop après avoir modifié la configuration.
• Vérifiez que le JSON de configuration est valide (virgules, guillemets).
• Exécutez npx -y @finnai/mcp-server --test dans le terminal pour vérifier que le serveur démarre.

« Échec de l'authentification »

• Jeton expiré ou révoqué. Générez-en un nouveau.
• Variable d'environnement du jeton non transmise (erreur de configuration).

« Délai d'attente dépassé pour l'appel d'outil »

• Les requêtes volumineuses (par ex. la recherche dans l'historique des appels) peuvent prendre plus de 30 secondes.
• Le délai d'attente par défaut de la plupart des clients est de 30 s. Augmentez-le si nécessaire.

« Autorisation refusée pour l'outil X »

• La portée de votre jeton n'inclut pas cet outil.
• Générez un nouveau jeton avec une portée plus large, ou effectuez cette opération depuis le tableau de bord.

À venir

La feuille de route MCP (à la date de rédaction) :

• Outils de workflow — créer et modifier des workflows visuels via Claude.
• Outil Test-on-Call — lancer des appels de test depuis Claude.
• Abonnements en streaming — flux d'événements en temps réel pour les déploiements actifs.
• Prise en charge multicompte — gérer plusieurs comptes Finn depuis une seule session Claude.
• Lecture des enregistrements — diffuser l'audio des appels vers Claude pour une écoute directe (Enterprise).

Proposez les outils que vous souhaitez à [email protected].

Au-delà de Claude

Bien que cette page se concentre sur Claude, le serveur MCP est indépendant du fournisseur. Il fonctionne avec :

• Continue.dev (extension IA pour VS Code)
• Cursor (IDE orienté IA)
• OpenAI ChatGPT Desktop (dès la prise en charge de MCP)
• Clients MCP personnalisés basés sur la spécification ouverte

Tout client compatible MCP peut utiliser Finn via le même serveur.

Suite

• Intégrations → API REST — l'API sous-jacente encapsulée par le MCP.
• Intégrations → Webhooks — notifications push pour les workflows événementiels.
• Capacité et montée en charge → — les limites de débit applicables aux appels MCP.