Serveur MCP

Pilotez Aethex depuis Claude Code, Codex et d'autres clients MCP. Le serveur MCP Aethex transforme les voix, la transcription, les agents, les appels et la consommation en outils que tout assistant compatible peut appeler en votre nom.

Vue d'ensemble

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux assistants IA d'appeler des outils externes via une interface unique. Le serveur MCP Aethex est un programme autonome qui parle MCP d'un côté et l'API Aethex de l'autre, de sorte qu'un assistant comme Claude peut synthétiser de la parole, transcrire de l'audio, construire des agents vocaux, passer des appels et lire votre consommation sans quitter la conversation.Il est publié sous le paquet aethexai-mcp et s'exécute en local. Votre client MCP le lance à la demande avec uvx aethexai-mcp, il n'y a donc rien à héberger ni aucun service supplémentaire à maintenir en marche. Chaque action qu'il effectue est un appel à la même API publique Aethex que vous utilisez déjà, limitée à la clé d'API que vous lui fournissez.Il fonctionne avec tout client compatible MCP. Claude Code et Codex sont présentés ci-dessous ; Claude Desktop, Cursor et Windsurf sont traités sous Autres clients.

DÉMARRAGE RAPIDE

Connecter Claude Code ou Codex

Commencez par créer une clé d'API dans le portail développeur. Vous avez aussi besoin de uv, le gestionnaire de paquets Python qui fournit le lanceur uvx ; installez-le avec curl -LsSf https://astral.sh/uv/install.sh | sh.Claude Code enregistre le serveur avec une seule commande. Codex le lit depuis ~/.codex/config.toml. Choisissez votre client ci-dessous, puis demandez-lui de lister vos voix Aethex pour confirmer la connexion.

Astuce

Si le client signale qu'il ne trouve pas uvx, indiquez son chemin absolu dans command, que vous pouvez obtenir avec which uvx. Pour cibler un environnement hors production, ajoutez AETHEX_BASE_URL à env.

bash

claude mcp add aethex --env AETHEX_API_KEY=your-api-key -- uvx aethexai-mcp
claude mcp list

Autres clients

Tout client MCP exécute la même commande uvx aethexai-mcp ; seul le format de configuration change.Claude Desktop. Ouvrez Réglages, Développeur, Modifier la configuration et ajoutez le bloc JSON ci-dessous à claude_desktop_config.json, puis redémarrez. Sous Windows, activez d'abord le mode développeur depuis le menu Aide.Cursor et Windsurf. Collez le même bloc mcpServers dans les réglages MCP du client.Pour générer un bloc prêt à coller pour n'importe quel client, installez le paquet avec pip install aethexai-mcp et exécutez python -m aethexai_mcp --api-key=your-api-key --print.

claude_desktop_config.json

json

{
  "mcpServers": {
    "Aethex": {
      "command": "uvx",
      "args": ["aethexai-mcp"],
      "env": {
        "AETHEX_API_KEY": "your-api-key"
      }
    }
  }
}

Authentification et portées

Le serveur n'a besoin que d'un seul identifiant : votre AETHEX_API_KEY. Il n'y a aucune connexion, région ni environnement distinct à configurer. Chaque outil s'exécute pour le compte du locataire propriétaire de la clé, et chaque outil exige la portée correspondante sur cette clé : une clé sans calls:write ne peut donc pas passer d'appels. Consultez les portées des clés d'API pour savoir ce que chaque action requiert, et créez une clé dédiée à votre assistant afin de pouvoir la renouveler ou la révoquer indépendamment.Par défaut, le serveur communique avec la production sur https://api.aethexai.com. Pour le diriger vers un autre environnement, définissez AETHEX_BASE_URL dans le même bloc env.

Remarque

Traitez la clé comme un mot de passe. Elle est stockée dans la configuration de votre client et accorde à l'assistant toutes les actions que ses portées autorisent. Donnez à l'assistant une clé limitée à ce dont il a besoin.

Ce que vous pouvez faire

Le serveur regroupe Aethex en sept domaines d'outils. L'assistant choisit le bon outil pour chaque demande et vous renvoie les identifiants, les chemins de fichiers et les statuts qu'il obtient.Voix et synthèse vocale. Listez les voix disponibles pour votre locataire, auditionnez-en une avec un court aperçu, et synthétisez du texte en parole avec une voix choisie.Transcription. Transcrivez de l'audio court de façon synchrone, ou soumettez un fichier plus long en tant que tâche et interrogez le résultat.Agents vocaux. Créez, consultez, mettez à jour, listez, dupliquez et supprimez des agents vocaux.Bases de connaissances. Joignez des documents à un agent, listez-les, lancez une recherche hybride pour vérifier ce que l'agent peut trouver, et retirez des documents.Appels. Passez un appel sortant unique ou un lot, puis suivez le statut de chaque appel et récupérez le dossier complet.Conversations. Listez et recherchez les conversations passées, lisez leurs transcriptions et ajoutez des retours.Consommation et modèles. Établissez un rapport de consommation pour le locataire ou une seule clé, ventilé par jour ou par mois, et listez les modèles disponibles.

Modes de sortie audio

Les outils qui produisent de l'audio, comme la synthèse vocale et les aperçus de voix, peuvent renvoyer leur résultat de trois manières. Définissez AETHEX_MCP_OUTPUT_MODE dans le bloc env pour choisir.`files` est la valeur par défaut. Ce mode enregistre l'audio sur le disque et renvoie le chemin du fichier. L'emplacement par défaut est votre bureau et peut être modifié avec AETHEX_MCP_BASE_PATH.`resources` renvoie l'audio en ligne sous forme de ressource MCP sans aucune écriture sur le disque, ce qui convient aux clients en bac à sable ou conteneurisés.`both` enregistre sur le disque et renvoie la ressource.

Renvoyer l'audio en ligne au lieu d'écrire des fichiers

json

"env": {
  "AETHEX_API_KEY": "your-api-key",
  "AETHEX_MCP_OUTPUT_MODE": "resources"
}

Coût et utilisation sûre

Certains outils dépensent des crédits et entraînent des actions réelles. La synthèse vocale, les aperçus de voix, la transcription et les appels sortants consomment tous des crédits Aethex, et un appel compose un vrai numéro de téléphone. Demandez à l'assistant de vérifier votre consommation avant un lot important, et confirmez le destinataire avant qu'il ne passe un appel.Le serveur est conçu pour que l'assistant recherche les identifiants réels avant d'agir et confirme les suppressions, les annulations et les appels sortants. Gardez cette habitude : examinez ce que l'assistant propose avant d'approuver toute action qui dépense des crédits ou modifie vos données.

Attention

Les appels sortants et les suppressions sont difficiles à annuler. Utilisez une clé limitée aux seules actions que vous voulez confier à l'assistant, et examinez toute étape qui passe un appel ou supprime des données avant de l'approuver.

Étapes suivantes

Créez une clé limitée dans Clés d'API, choisissez une voix dans la Bibliothèque de voix, et lisez Agents pour concevoir l'agent que votre assistant construira et avec lequel il appellera. Pour un accès programmatique sans assistant, consultez le SDK Python.