Passer au contenu principal

Connecter le MCP Spyne à Claude, ChatGPT, Gemini et Copilot

Cette note explique comment ajouter manuellement le serveur MCP Spyne à Claude, ChatGPT, Gemini et Microsoft Copilot dans le cas où il n’est pas encore listé dans les connecteurs prédéfinis.


Claude (Claude.ai et Claude Desktop)

Claude prend en charge nativement l’ajout d’un MCP distant via la fonctionnalité Custom Connectors. Disponible sur les plans Free (1 connecteur), Pro, Max, Team et Enterprise.

Pré-requis

  • Plan Claude actif (Free suffit pour 1 connecteur).

  • Pour un plan Team/Enterprise : seul un Owner peut ajouter un connecteur personnalisé au niveau de l’organisation. Les membres ne peuvent pas ajouter de connecteur custom seuls.

Étapes (compte individuel : Free, Pro, Max)

  1. Ouvrir Claude.ai → cliquer sur votre profil → Settings (Paramètres).

  2. Aller dans Connectors dans le menu latéral.

  3. Cliquer sur le lien Customize (Personnaliser) dans la page.

  4. Cliquer sur l’icon + dans le menu Connecteurs et selectionner Ajouter un connecteur personnalisé

  5. Remplir :

  6. Cliquer sur Add.

  7. Effectuer le flux d’authentification (OAuth) si demandé.

Étapes (plan Team / Enterprise)

  1. Un Owner se rend dans Organization Settings → Connectors → Add → Custom.

  2. Saisir le nom et l’URL https://mcp.spyne.app/mcp, puis publier le connecteur.

  3. Chaque membre va ensuite dans Customize → Connectors, trouve « MCP Spyne », clique sur Connect et complète l’OAuth.

Activation dans une conversation

  • Dans une discussion, cliquer sur le bouton « + » (en bas à gauche) → Connectors → activer le toggle « MCP Spyne ».

  • Le connecteur s’active conversation par conversation.

Points d’attention

  • Le serveur MCP doit être accessible publiquement sur Internet : Claude se connecte depuis l’infrastructure cloud d’Anthropic, pas depuis votre poste. Pas de connexion possible derrière un VPN ou un pare-feu privé sans whitelister les IP Anthropic.

  • Pour modifier la configuration, il faut supprimer le connecteur et le rajouter.


ChatGPT

ChatGPT permet d’ajouter un serveur MCP distant via les Custom Connectors en activant le Developer Mode.

Pré-requis

  • Compte Plus, Pro, Business, Enterprise ou Edu.

  • Limitation importante (depuis déc. 2025) : Plus et Pro sont limités aux connecteurs en lecture seule (fetch/read-only). Les connecteurs avec actions d’écriture sont réservés aux espaces Business / Enterprise / Edu.

Étape 1 — Activer le Developer Mode

  1. Ouvrir ChatGPT → Settings.

  2. Aller dans Apps → Advanced settings.

  3. Activer le toggle Developer Mode et confirmer l’avertissement.

Pour les espaces Business / Enterprise / Edu, un administrateur doit publier le connecteur depuis Workspace Settings → Connectors → Create, puis les membres se connectent individuellement.

Étape 2 — Ajouter le connecteur Spyne

  1. Settings → Apps → Create app.

  2. Renseigner :

    • Name : Spyne

    • Description (facultatif): (libre, ex. « MCP Spyne — accès aux données et intégrations Spyne »)

    • MCP Server URL : https://mcp.spyne.app/mcp

    • Authentication : OAuth

  3. Cocher « I understand and want to continue » puis Create.

  4. Compléter le flux OAuth.

Étape 3 — Utiliser le connecteur dans une conversation

  1. Démarrer un nouveau chat.

  2. Cliquer sur « + » dans la zone de saisie → More → Developer mode.

  3. Sélectionner Spyne comme source pour la conversation.

  4. Pour chaque tool call, ChatGPT affichera l’appel proposé : cliquer Confirm pour autoriser.

Points d’attention

  • Le Developer Mode est en beta. À activer côté admin pour les workspaces.

  • Les actions d’écriture nécessitent une confirmation manuelle à chaque appel (sauf si vous mémorisez l’approbation pour la conversation).


Gemini

⚠️ Important : à ce jour, l’application web Gemini grand public (gemini.google.com) ne supporte pas nativement l’ajout d’un MCP custom. Les MCP distants se connectent via Gemini CLI ou Gemini Enterprise (Google Cloud).

Option A — Gemini CLI (recommandé pour usage individuel)

Pré-requis

Étapes

1. Ouvrir (ou créer) le fichier ~/.gemini/settings.json.

2. Ajouter le bloc mcpServers avec une seule URL (httpUrl) — pas besoin de séparer “URL OAuth” et “URL streamable HTTP”. Gemini CLI dérive automatiquement le endpoint de métadonnées OAuth (RFC 9728 §3.1) à partir de cette URL :

json 

{
"mcpServers": {
"spyne": {
"httpUrl": "https://mcp.spyne.app/mcp"
}
}
}

Comment fonctionne la découverte OAuth ? Gemini CLI requête https://mcp.spyne.app/.well-known/oauth-protected-resource/mcp (forme path-suffixée RFC 9728). Le serveur Spyne expose cette route ainsi que la forme racine /.well-known/oauth-protected-resource pour les clients qui n’implémentent pas la forme path-suffixée. Aucun champ de settings n’existe pour pointer manuellement vers un autre endpoint de découverte — seul httpUrl est utilisé.

3. Pour personnaliser scopes ou timeout :

json 

{
"mcpServers": {
"spyne": {
"httpUrl": "https://mcp.spyne.app/mcp",
"oauth": {
"scopes": ["read", "write"]
},
"timeout": 30000
}
}
}

4. Relancer Gemini CLI : taper /mcp dans le chat pour vérifier que le MCP Spyne est bien découvert dans les settings (statut disconnected).

5. Lancer la connexion OAuth via le chat :

/mcp auth spyne

6. Retaper /mcp pour vérifier que les outils Spyne sont bien découverts (statut

connected).

Bonnes pratiques

  • Éviter les underscores dans le nom du serveur (spyne, pas spyne_mcp) — Gemini CLI les utilise comme séparateurs internes.

  • Ne pas mettre de slash final sur httpUrl (/mcp, pas /mcp/) — certains probes RFC 9728 reconstruisent l’URL et un double slash peut casser la découverte.


Option B — Gemini Enterprise (via Google Cloud).

Pour intégrer Spyne dans Gemini Enterprise (édition Standard, Plus ou Frontline) :

  1. Dans la Google Cloud Console → page Gemini Enterprise.

  2. Data stores → Create data store.

  3. Rechercher Custom MCP Server dans la liste des sources et cliquer Add MCP server.

  4. Renseigner :

    • Client ID / Client Secret : à obtenir depuis votre IdP (Okta, Azure AD, Google, etc.) après avoir enregistré Gemini Enterprise comme application OAuth.

    • MCP Server Description : décrire à quoi sert Spyne pour aider Gemini à choisir quand l’utiliser.

  5. Compléter la configuration (region, nom du connector) puis Create.

  6. Attendre que le statut du data store passe à Active.

  7. Activer les outils : Actions → Reload custom actions puis activer manuellement les tools souhaités (désactivés par défaut).

Limitations

  • Seul le transport Streamable HTTP est supporté (pas le SSE legacy).

  • Pas de support de Private Service Connect pour l’instant.

  • Nécessite le rôle IAM Discovery Engine Editor pour créer le data store.


Option C — Application web Gemini

Pas de support natif aujourd’hui. Plusieurs threads de la Gemini Apps Community confirment qu’il faut passer par Gemini CLI ou Gemini Enterprise. Surveiller les annonces Google pour une future ouverture côté web.


Dust

Dust prend en charge nativement l'ajout d'un serveur MCP distant au niveau de l'espace de travail. La découverte de la configuration et le flux OAuth sont automatiques à partir de la seule URL du serveur.

Pré-requis

  • Être administrateur de l'espace de travail Dust (l'ajout d'un outil MCP se fait dans Spaces → Tools, réservé aux admins).

  • ou être sur un espace de travail personnel.

Etapes

  1. Ouvrir Dust → aller dans Spaces (Espaces) → Tools (Outils).

  2. Cliquer sur Add Tool (Ajouter un outil) → choisir Add MCP Server (Ajouter un serveur MCP).

  3. Renseigner : MCP Server URL: https://mcp.spyne.app/mcp

  4. Choisir le mode d'authentification Automatic (Recommended) : Dust découvre automatiquement la configuration OAuth (RFC 9728) à partir de l'URL et lance le flux de connexion.

  5. Une fenêtre « Configure MCP Server — How do you want to connect? » s'affiche. Choisir le mode de connexion :

    • Personal accounts (recommandé) : chaque membre se connecte avec ses propres identifiants Spyne lorsqu'il utilise l'outil. C'est le mode adapté au MCP Spyne — il préserve une session OAuth par utilisateur (et donc les droits/workspaces propres à chacun).

    • Shared account : tous les membres utilisent les identifiants que vous fournissez ici (un seul compte Spyne partagé).

    • Laisser le toggle « Use custom headers » désactivé : l'auto-découverte OAuth ne nécessite aucun en-tête personnalisé.

    • Cliquer sur Setup connection.

  6. Compléter le flux OAuth lorsque demandé.

  7. Après une courte synchronisation, l'outil « Spyne » est créé et ses tools sont disponibles.

Utiliser le MCP dans un agent

Ajouter l'outil « Spyne » aux outils d'un agent (Agent → Tools / Actions), puis interroger l'agent en langage naturel (ex. « Liste les intégrations actives sur mon workspace Spyne »).


Microsoft Copilot (Microsoft 365 Copilot & Copilot Studio)

Microsoft propose deux façons de connecter un serveur MCP distant à l'écosystème Copilot, selon l'usage visé : un accès conversationnel dans Microsoft 365 Copilot Chat (comme pour Claude, ChatGPT ou Gemini), ou l'intégration des outils Spyne dans un agent personnalisé construit avec Copilot Studio.

Option A — Microsoft 365 Copilot (connecteur fédéré personnalisé)

Permet aux utilisateurs d'interroger le MCP Spyne directement depuis Microsoft 365 Copilot Chat, en langage naturel.

Pré-requis

  • Rôle Global Administrator ou AI Administrator dans le Microsoft 365 admin center.

  • Informations éditeur : nom du développeur, URL de documentation, politique de confidentialité, conditions d'utilisation.

Étapes

  1. Configurer l'authentification au préalable, dans le Teams Developer Portal :

    • Microsoft Entra SSO (recommandé si les utilisateurs Spyne sont déjà dans le tenant Microsoft) : enregistrer un client SSO, qui génère un Registration ID.

    • OAuth 2.0 (identifiant tiers) : Tools → OAuth Client Registration → + New OAuth connection, renseigner Client ID, Client secret, Authorization endpoint, Token endpoint, Refresh endpoint et Scopes, ainsi que l'URI de redirection https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect. Copier le Registration ID généré.

  2. Se connecter au Microsoft 365 admin center → Copilot → Connectors.

  3. Onglet Gallery → section « Created by your org » → Create a new connector → Add.

  4. Sur la page Custom connector, sous « Connect to MCP server », cliquer Add.

  5. Remplir :

  6. Cliquer sur Save.

  7. (Recommandé) Faire un Staged rollout vers un groupe pilote avant de sélectionner Deploy to all users.

Points d'attention

  • Un connecteur fédéré n'expose que des outils en lecture seule (pas d'actions d'écriture).

  • Les modifications de configuration peuvent prendre jusqu'à 15 minutes à se propager.

  • Le serveur MCP doit être accessible en HTTPS.


Option B — Microsoft Copilot Studio (agent personnalisé)

Pour intégrer les outils Spyne dans un agent Copilot Studio dédié plutôt que dans le Copilot Chat général.

Pré-requis

  • Accès à Copilot Studio avec une licence couvrant le standard harness.

Étapes

  1. Dans l'agent concerné, aller dans Tools → Add a tool → New tool → Model Context Protocol.

  2. Renseigner :

    • Server name : Spyne

    • Server description : description libre de l'usage (aide l'orchestrateur à choisir quand appeler l'outil).

  3. Choisir l'authentification :

    • OAuth 2.0 → Dynamic discovery (le plus simple : découverte automatique des endpoints via RFC 9728), ou

    • Manual si la découverte automatique échoue : renseigner Client ID, Client secret, Authorization URL, Token URL, Refresh URL et Scopes, puis enregistrer l'URL de callback générée auprès de l'IdP.

  4. Cliquer sur Create, puis Create a new connection (ou réutiliser une connexion existante) → Add to agent.

Points d'attention

  • Seul le transport Streamable HTTP est supporté (le SSE legacy est déprécié depuis août 2025).

  • L'accès est soumis aux politiques de perte de données (DLP) du Power Platform.


Récapitulatif

Plateforme

Support natif d'un MCP custom

Où configurer ?

Authentification

Claude.ai / Desktop

✅ Oui (tous plans)

Settings → Connectors → Add custom connector

OAuth (recommandé)

ChatGPT

✅ Oui (Plus+, en beta)

Settings → Apps & Connectors (Developer Mode requis)

OAuth uniquement

Gemini CLI

✅ Oui

~/.gemini/settings.json

OAuth auto-discovery

Gemini Enterprise

✅ Oui

Google Cloud Console → Gemini Enterprise → Data stores

OAuth via IdP (client_id/secret)

Gemini Web (gemini.google.com)

❌ Non

—

—

Dust

✅ Oui

Spaces → Tools → Add MCP Server

OAuth auto-discovery

Microsoft 365 Copilot

✅ Oui (connecteur fédéré)

Microsoft 365 admin center → Copilot → Connectors

Entra SSO / OAuth 2.0

Copilot Studio (agent)

✅ Oui

Agent → Tools → Add a tool → MCP

OAuth 2.0 (dynamic discovery) / clé API / aucune


Vérifications utiles avant de débuguer

  1. L’URL est-elle correcte ? Tester en HTTPS : curl -I <https://mcp.spyne.app/mcp>.

  2. Le serveur est-il accessible publiquement ? Pas de VPN, pas de pare-feu bloquant les IP Anthropic / OpenAI / Google.

  3. HTTPS obligatoire sur toutes les plateformes (HTTP non accepté).

  4. OAuth bien configuré côté serveur Spyne : endpoints /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server accessibles, et https://claude.ai/api/mcp/auth_callback dans les redirect URIs autorisés si applicable.

  5. Tester d’abord avec un prompt simple une fois connecté (ex. « Liste les intégrations actives sur mon workspace Spyne ») pour valider que les tools sont bien découverts.

Avez-vous trouvé la réponse à votre question ?