MCP Server

Serveur MCP

Connectez un outil d’IA de développement externe — Claude Code, Codex ou Antigravity — directement à votre compte AiTalk. Ensuite, vous décrivez ce que vous voulez en langage courant et l’IA le construit : agents, workflows, base de connaissances.

De quoi il s’agit

MCP (Model Context Protocol) est une norme qui permet à un outil d’IA d’utiliser un service externe. AiTalk joue le rôle de serveur MCP ; votre outil d’IA est le client.

Votre outil d’IA (Claude Code / Codex / Antigravity)
        │
        │  Authorization: Bearer aitk_...
        ▼
Serveur MCP AiTalk  ──→  vos agents, workflows, base de connaissances, conversations

Ce que l’IA connectée peut faire :

Domaine	Actions possibles
Agents et workflows	Les lister, les consulter, en créer (à partir de modèles ou de zéro), les modifier, les valider
Mise en production	Mettre un workflow en production, ou repasser un workflow en production à l’état de brouillon
Base de connaissances (RAG)	Lister, lire, ajouter et supprimer des fichiers sources
Historique des conversations	Lire les conversations écrites, les appels vocaux et les tentatives de quiz passés

Ce qu’elle ne peut pas faire :

Supprimer des workflows ou des agents — utilisez le tableau de bord
Lancer un test — utilisez le tableau de bord
Modifier votre abonnement, votre facturation ou vos crédits
Accéder aux données d’un autre client. Chaque requête est limitée au compte propriétaire du jeton

Pourquoi un jeton d’accès est nécessaire

Le jeton d’accès est ce qui permet à votre outil d’IA de prouver qu’il agit en votre nom. Il n’y a pas d’autre moyen — sans jeton, toute requête vers le serveur MCP est refusée. Rien ne peut se connecter avant que vous ayez créé le premier.

À savoir :

Le jeton n’est affiché qu’une seule fois, juste après sa création. Copiez-le immédiatement. Si vous le perdez, révoquez-le et créez-en un nouveau.
L’accès en écriture est activé par défaut, afin que l’IA puisse créer et modifier. Décochez-le pour un jeton en lecture seule (utile si vous voulez que l’IA regarde sans rien changer).
Vous pouvez avoir jusqu’à 5 jetons. Un jeton par machine ou par outil est une bonne habitude — cela permet de les révoquer individuellement.
Traitez un jeton comme un mot de passe. Quiconque le détient peut agir sur votre compte en votre nom.

Configuration

Étape 1 : créer un jeton

Dans AiTalk, allez dans Paramètres → Serveur MCP
Saisissez un nom — la machine ou l’outil sur lequel vous l’utiliserez, par ex. Claude Code - MacBook
Laissez Autoriser les outils d’écriture coché (décochez pour un jeton en lecture seule)
Cliquez sur Créer un jeton
Copiez le jeton maintenant — il n’est affiché qu’une seule fois

Étape 2 : ajouter AiTalk à votre outil d’IA

Dans la section Connecter votre outil d’IA, choisissez l’onglet de votre outil. La commande affichée contient déjà votre nouveau jeton — copiez-la et utilisez-la comme indiqué ci-dessous.

Claude Code — exécutez la commande dans votre terminal :

claude mcp add --transport http aitalk https://www.aitalk.ch/api/mcp-server \
  --header "Authorization: Bearer aitk_VOTRE_JETON"

Claude Desktop — Paramètres → Développeur → Modifier la configuration, collez l’extrait, puis redémarrez l’application. Node.js (npx) requis. Emplacement du fichier de configuration :

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

Codex — ajoutez l’extrait à ~/.codex/config.toml. Dans l’application Codex : New MCP → Type = Streamable HTTP, puis saisissez l’URL et un en-tête Authorization: Bearer.

Antigravity — ajoutez l’extrait à ~/.gemini/config/mcp_config.json (Settings → Customizations → Open MCP Config), puis actualisez.

Étape 3 : demander à votre IA

Parlez-lui simplement. Par exemple :

« Liste mes agents et workflows AiTalk »
« Explique-moi ce que fait le workflow du service client »
« Crée un workflow à partir du modèle FAQ et définis le message d’accueil sur ... »
« Ajoute ce texte à ma base de connaissances »
« Mets le workflow de réservation en production »

L’IA lit d’elle-même les guides intégrés d’AiTalk : vous n’avez pas à lui expliquer comment les workflows sont structurés.

Surveiller les accès

Deux endroits vous montrent comment vos jetons sont utilisés :

Paramètres → Serveur MCP — chaque jeton, avec la date de dernière utilisation ainsi que l’adresse IP et le pays d’où il a été utilisé
Tableau de bord — la synthèse : combien de jetons vous avez, et quand et depuis où le dernier accès a eu lieu

Si vous voyez un accès que vous ne reconnaissez pas, révoquez ce jeton immédiatement (icône corbeille à côté). Les outils connectés perdent l’accès aussitôt.

Le pays est déduit de l’adresse IP de la connexion. Avec un VPN ou un outil d’IA hébergé dans le cloud, c’est le pays de ce serveur qui s’affiche, pas le vôtre.

Garde-fous

Quelques limites existent pour qu’une erreur — ou une IA qui interprète mal une consigne — ne puisse pas causer de dégâts silencieux :

La mise en production est visible. Mettre un workflow en production est une action délibérée. Si vous préférez vérifier avant, demandez plutôt à votre IA de soumettre une demande de mise en production : elle renvoie un lien que vous ouvrez vous-même et sur lequel vous cliquez Deploy.
Modifier un workflow en production touche vos clients immédiatement. L’IA a pour consigne de vous demander confirmation au préalable.
Les secrets ne sont jamais transmis. Les clés d’API, mots de passe et jetons contenus dans vos workflows sont masqués avant que quoi que ce soit ne quitte le serveur : une IA connectée ne peut pas les lire.
Des limites de débit s’appliquent par jeton (lectures et écritures comptées séparément).
Chaque appel est journalisé — quel outil a été exécuté, s’il a réussi et combien de temps il a pris.

Dépannage

Problème	Cause / solution
`401 Unauthorized`	Le jeton est incorrect, a été révoqué, ou le préfixe `Authorization: Bearer` manque. Créez un nouveau jeton et ajoutez-le à nouveau.
L’outil se connecte mais n’affiche aucun agent	Le compte associé au jeton n’a pas encore d’agent. Créez-en un dans le tableau de bord.
Les actions d’écriture sont refusées	Le jeton a été créé en lecture seule. Créez un nouveau jeton avec Autoriser les outils d’écriture coché.
« Rate limit exceeded »	Trop d’appels en une minute. Patientez un instant puis continuez.
Un nouveau fichier source est introuvable	L’indexation s’exécute en arrière-plan. Attendez quelques secondes et redemandez.
Impossible d’envoyer un fichier PDF / Word / Excel	Les fichiers binaires ne peuvent pas passer par MCP. Demandez à votre IA de convertir d’abord le contenu en texte, ou téléversez le fichier depuis la page Stockage du tableau de bord.

Des questions ?

Écrivez-nous à support@aitalk.ch.