1. Qu'est‑ce qu'un MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet de connecter une intelligence artificielle à des outils, API et services externes. Il fournit une structure unifiée pour déclarer des ressources, exécuter des actions et permettre à un modèle IA d’interagir avec des services de façon sécurisée, cohérente et contrôlée.

Grâce au MCP, une IA peut :

• accéder à des données en temps réel,
• effectuer des opérations complexes via des outils dédiés,
• rester dans un cadre strict défini par le serveur MCP (sécurité, permissions, formats, etc.).

Whaller expose un serveur MCP officiel permettant à n’importe quel agent IA compatible (ChatGPT, Claude, n8n, Cursor, etc.) d’interagir avec vos sphères Whaller, vos messages, etc.

Pour mieux comprendre les MCP, nous vous invitons à regarder cette vidéo de Micode :

2. Outils disponibles sur le MCP Whaller

Le serveur MCP Whaller expose plusieurs outils permettant à une IA d’interagir avec vos organisations, messages et tâches. Voici les outils disponibles :

🔹 list-networks : Liste les organisations et sphères de l’utilisateur.

🔹 write-message : Écrit un message dans une sphère.

🔹 post-reaction : Ajoute une réaction (emoji) à un message.

🔹 get-how-many-news : Récupère le nombre de messages non lus par sphère.

🔹 get-sphere-flux : Récupère le flux de messages d’une sphère.

🔹 list-my-tasks : Liste les tâches à effectuer de l’utilisateur.

🔹 list-my-events : Liste les événements de l'utilisateurs.

etc.

Le MCP Whaller permet à une IA de se connecter à votre compte Whaller via un serveur MCP dédié. Vous pouvez ensuite effectuer des actions comme :

• récupérer vos messages non lus,
• accéder aux sphères auxquelles vous appartenez,
• publier des messages,
• ajouter des réactions,
• récupérer vos tâches,
• parcourir le flux d’une sphère,
• exécuter d’autres outils spécifiques selon vos permissions.
• etc.

3. Comment configurer et utiliser le MCP Whaller ?

3.1 Générer des "credentials" (identifiants) pour le MCP

Pour configurer un MCP, il vous faut disposer de credentials (ou identifiants) : d'un "client ID" et d'un "client Secret".

Pour cela, votre compte doit être gestionnaire pour accéder à la page de gestion "Configuration".

Allez dans la section "Whaller IAssistant", et sous "🔑 Client OAuth2 pour l'utilisation du serveur MCP", cliquez sur le bouton "Générer les identifiants" :

Une fois les identifiants générés, vous pouvez les "copier" dans votre presse papier en cliquant simplement dessus. Vous pouvez aussi à tout instant les régénérer ou les supprimer : mais attention, cela invaliderait toute authentification liée (par exemple par l'un de vos membres) :

3.2. Informations nécessaires pour connecter le MCP Whaller à un service tiers

Après ces étapes de génération d'identifiants, voici en synthèse les informations dont vous aurez besoin pour configurer le MCP Whaller dans votre service tiers (LLM, n8n, etc) :

• URL : https://mcp.whaller.com/mcp
• Mode d'authentification : OAuth
• Client ID : le client ID issu des credentials
• Client Secret : le client Secret issu des credentials

3.3 Qui peut utiliser ces credentials ?

Tous les membres et visiteurs de votre organisation / fédération d'organisations.

Aussi, vous pourrez transmettre ces identifiants aux membres de votre organisation qui le demandent.

Si un de vos membres quitte l'organisation, vous n'aurez pas besoin de régénérer des identifiants, en effet une vérification dynamique s'opère lorsqu'un utilisateur utilise les identifiants transmis et vérifie s'il est bien membre ou visiteur de l'organisation en question.

4. Exemples concrets de configuration MCP pour : ChatGPT, Claude, Cursor et n8n

4.1 Configurer Whaller MCP sur ChatGPT

Voici comment utiliser le MCP Whaller avec ChatGPT :

1. Ouvrez ChatGPT (version Desktop ou Web compatible MCP).
2. Allez dans Paramètres → Applis & connecteurs :

3. Cliquez sur "Paramètres avancés" et activez le mode développeur :

4. Faites "Retour" puis cliquez sur le bouton "Créer" en haut de la fenêtre :

5. Renseignez :

• Nom : Whaller
• URL : https://mcp.whaller.com/mcp
• Authentification : OAuth
• ID Client OAuth : le client ID issu des credentials
• Secret Client OAuth : le client Secret issu des credentials

Puis cochez la case et cliquez sur le bouton "Créer" :

6. ChatGPT vous demandera d’autoriser la connexion via OAuth2 sur Whaller, cliquez sur "Se connecter" :

7. Le MCP Whaller est désormais connecté :

8. Pour l'utiliser, restez en mode développeur, et sélectionnez bien "Whaller" dans les outils à utiliser pour votre discussion avec ChatGPT :

4.2 Configurer Whaller MCP sur Claude

Claude propose aussi une intégration MCP très simple.

1. Ouvrez Claude.ai.
2. Allez dans Paramètres → Connecteurs : et cliquez sur "Ajouter un connecteur personnalisé" :

3. Entrez :

• Nom : Whaller
• URL : https://mcp.whaller.com/mcp
• Authentification : OAuth
• ID Client OAuth : le client ID issu des credentials
• Secret Client OAuth : le client Secret issu des credentials

4. Cliquez ensuite sur "Se Connecter" et vous pouvez maintenant directement utiliser le MCP dans vos discussions Claude !

Nous vous recommandons aussi de cliquer sur "configurer" et de "Toujours autoriser" les "Outils en lecture seule" :

4.3 Configurer Whaller MCP sur Cursor

Allez dans les "Cursor settings" et dans la section "Tools & MCP", cliquez sur "Add custom MCP" :

et décrivez votre configuration de la façon suivante en remplaçant mcp_xxxxxxxxxx par le client ID **et secret_xxxxxxxxxx par le **client Secret :

{
    "mcpServers": {
        "whaller": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote@latest",
                "https://mcp.whaller.com/mcp",
                "--static-oauth-client-info",
                "{ \"client_id\": \"mcp_xxxxxxxxxx\", \"client_secret\": \"secret_xxxxxxxxxx\", \"scope\": \"*\" }"
            ]
        }
    }
}

Authentifiez-vous, et le MCP est actif dans Cursor :

4.4 Configurer Whaller MCP sur n8n

Sur n8n, il vous faut utiliser l'outil "MCP Client Tool" branché à un "AI Agent" :

Avec les paramètres suivants :

Voici à quoi peut ressembler un workflow très simple :

Credentials

Vous devez alors définir des "credentials" pour vous connecter au MCP Client, voici un exemple de configuration :

Use Dynamic Client Registration : décocher cette case

Grant Type : Authorization code

Authorization URL : https://my.whaller.com/oauth2/authorize

Access Token URL : https://my.whaller.com/oauth2/token

Client ID : le client ID issu des credentials

Client Secret : le client Secret issu des credentials

Scope : *

Authentication : Body

Allowed HTTP Request Domains : : All

5. Cas d'usage : un envoi de newsletter hebdo à l'ensemble des membres de votre réseau

A vous la main Vous pouvez facilement créer un workflow n8n qui d'abord récupère l'ensemble des adresses e-mail de votre organisation Whaller, ou en partie, et puis ensuite qui vient regarder les meilleures publications de la semaine d'une sphère en particulier (exemple : sphère consacrée à la veille), puis qui formate ces top publications sous la forme d'une newsletter (vous pouvez fournir un template html en prompt), et enfin l'envoi par e-mail (avec l'outil que vous voulez) !

Exemple en image du workflow :

Exemple de rendu réel :

pas mal non

Mis à jour le : 09/12/2025