Passer au contenu principal

Connecter le MCP Spyne à Claude, ChatGPT et Gemini

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

URL du MCP : https://mcp.spyne.app/mcp

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 :

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

    • 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 »).

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

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 ?