Guide développeur

Serveur MCP ou clé API : comment votre IA doit se connecter à FoxEra Calls.

Les deux méthodes donnent à votre assistant IA ou à votre code les mêmes outils et les mêmes règles de sécurité. Le bon choix dépend de si une personne discute ou si du code s'exécute.

Deux façons de se connecter, un seul ensemble de règles

FoxEra Calls propose deux méthodes de connexion pour les assistants IA et les intégrations développeur :

  • Serveur MCP — un point de terminaison MCP distant utilisant Streamable HTTP et OAuth 2.1. Votre assistant s'y connecte comme à tout autre serveur MCP.
  • API REST avec clé à jeton — une API HTTP standard décrite en OpenAPI 3.1. Votre code envoie des requêtes avec un jeton fxk_....

Les deux méthodes exposent les mêmes capacités : gestion des prospects, création et approbation de campagnes, transcriptions, enregistrements, rapports, horaires d'appel, choix de l'agent et modification de l'argumentaire. Les deux imposent les mêmes règles de sécurité — effectif confirmé, approbation séparée, accès limité et journal complet. La différence est la manière dont la connexion s'établit et qui est aux commandes.

Quand utiliser le serveur MCP

Utilisez le serveur MCP lorsqu'une personne interagit avec un assistant IA dans une fenêtre de discussion et veut que l'assistant gère son compte FoxEra en son nom. Cela convient à :

  • ChatGPT, Claude, Cursor — ajoutez le serveur MCP distant à https://app.foxera.co.uk/mcp, connectez-vous et cliquez sur Autoriser. L'assistant peut alors ajouter des prospects, prévisualiser des campagnes et lancer des appels après votre approbation, tout depuis le chat.
  • Tout assistant compatible MCP distant — la connexion utilise le Streamable HTTP standard avec OAuth 2.1, donc tout client conforme peut l'utiliser.

La voie MCP est idéale pour les fondateurs et petites équipes qui utilisent déjà un assistant IA au quotidien et veulent gérer les appels à froid depuis le même chat qu'ils utilisent pour tout le reste. Aucun code à écrire, rien à installer.

Quand utiliser une clé API

Utilisez une clé API à jeton lorsque votre propre code, un script ou une plateforme d'automatisation doit appeler FoxEra par programmation. Cela convient à :

  • Intégrations CRM — poussez de nouveaux prospects depuis votre CRM vers FoxEra et récupérez automatiquement les résultats.
  • Plateformes d'automatisation — déclenchez une campagne depuis n8n, Make ou un webhook Zapier quand un nouveau prospect entre dans votre pipeline.
  • GPT Actions — importez la spécification OpenAPI 3.1 dans un GPT personnalisé. L'URL de la spécification est la seule configuration nécessaire.
  • Agents personnalisés — construisez un agent qui fonctionne sans surveillance, recherche des prospects, les ajoute et prépare une campagne pour votre approbation du matin.

Générez une clé dans vos paramètres développeur. Chaque clé est limitée à un espace de travail et peut être révoquée instantanément.

Comment fonctionne le modèle de sécurité pour chacune

Les deux méthodes de connexion imposent les mêmes règles de sécurité côté serveur :

  • Effectif confirmé — l'aperçu de la campagne doit être reconnu avant l'approbation, que l'aperçu provienne d'un appel d'outil MCP ou d'une requête API.
  • Approbation séparée — créer et approuver une campagne sont deux étapes distinctes. Aucune méthode ne permet de les combiner.
  • Horaires d'appel — les appels ne sont passés que pendant les horaires que vous avez configurés, quelle que soit l'heure d'envoi de l'approbation.
  • Accès limité — une session MCP est liée à votre autorisation OAuth ; une clé API est liée à votre espace de travail. Aucune ne peut atteindre les données d'un autre client.
  • Révocation — changer votre mot de passe déconnecte toute session MCP. Révoquer une clé API arrête instantanément tout accès depuis cette clé.

Lisez le détail complet des garde-fous de l'agent IA pour les appels sortants.

Peut-on utiliser les deux à la fois ?

Oui. De nombreuses configurations utilisent les deux méthodes pour différentes parties du flux de travail :

  • Votre assistant IA utilise le serveur MCP pour le travail interactif — ajouter quelques prospects depuis une conversation, prévisualiser une campagne, lire les résultats.
  • Votre back-end utilise une clé API pour les opérations en masse — synchroniser des centaines de prospects depuis un CRM pendant la nuit, récupérer les rapports quotidiens dans un tableau de bord.

Les deux méthodes partagent les mêmes données de compte. Un prospect ajouté via l'API apparaît dans la prochaine liste de votre assistant, et une campagne approuvée via le serveur MCP apparaît dans un rapport API. Il n'y a ni conflit ni duplication.

Si vous ne savez pas par où commencer, le serveur MCP est plus rapide à configurer (trois étapes, sans code). Vous pourrez ajouter une clé API plus tard si vous avez besoin d'un accès programmatique. Voir paiement à l'usage pour les appels IA pour savoir comment la tarification fonctionne avec chaque méthode.

Coûts

Les deux méthodes de connexion sont gratuites à utiliser. Vous ne payez que les appels qui se connectent, à partir de 21p la minute connectée, sans abonnement et sans frais de plateforme. Les nouveaux comptes démarrent avec £7 de crédit d'appel gratuit.

Il n'y a aucune différence de tarif entre le serveur MCP et l'API. Que votre assistant approuve une campagne via MCP ou que votre code l'approuve via l'API, le tarif à la minute est le même. Utilisez le calculateur de coût pour estimer une campagne avant de commencer.

Questions fréquentes

Le serveur MCP est-il plus difficile à configurer qu'une clé API ?

Non, c'est plus simple. Collez l'URL dans votre assistant, connectez-vous et cliquez sur Autoriser. Une clé API nécessite de générer la clé, de la stocker en sécurité et d'écrire vous-même les requêtes HTTP, ou d'importer la spécification OpenAPI.

Les connexions MCP et par clé API ont-elles des règles de sécurité différentes ?

Non. Les deux imposent la confirmation de l'effectif, une approbation séparée, des horaires d'appel, un accès limité et un journal complet. Ces règles s'appliquent côté serveur, pour toutes les méthodes de connexion.

Puis-je passer de MCP à une clé API plus tard ?

Oui. Vous pouvez ajouter ou retirer chaque méthode de connexion à tout moment. Les deux partagent les mêmes données de compte, donc rien n'est perdu si vous changez ou utilisez les deux.

Combien cela coûte-t-il ?

Les deux méthodes sont gratuites à connecter. Vous ne payez que les minutes d'appel connectées, à partir de 21p la minute connectée. Les nouveaux comptes reçoivent £7 de crédit d'appel gratuit.

Démarrez gratuitement avec £7 de crédit d'appel