Documentation

Serveur MCP

Droits d'accès requis sur le compte

L’accès MCP est disponible uniquement s’il est déjà inclus dans les droits actuels du compte Savebase connecté.

Savebase expose Model Context Protocol (MCP) serveur pour permettre à vos assistants IA de rechercher et lire vos favoris enregistrés. Demandez par exemple à Claude, ChatGPT ou Cursor « Qu’ai-je enregistré sur l’entraînement avec des kettlebells ? » et il interrogera directement votre bibliothèque Savebase.

Vue d’ensemble

MCP est un standard ouvert permettant aux applications IA de se connecter à des sources externes. Savebase fournit un point d’accès HTTP compatible MCP qui donne à votre assistant un accès en lecture seule à vos favoris, dossiers et étiquettes.

Pour ChatGPT, installez le composant publié Plugin Savebase. Pour Claude, Cursor, VS Code et les autres clients MCP, utilisez cette adresse de serveur :

text
https://mcp.savebase.space/mcp

Connectez-vous avec votre compte Savebase comme dans toute autre application, sans clé API ni jeton à copier. L’accès est en lecture seule : rien de ce qui est connecté par MCP ne peut ajouter, modifier ou supprimer des éléments de votre bibliothèque.

Conditions requises

  • Un compte Savebase dont les droits actuels incluent l'accès MCP
  • Le plugin Savebase publié pour ChatGPT ou un client compatible MCP comme Claude, Cursor ou VS Code

Claude (web, ordinateur, mobile)

1

Ouvrir les connecteurs Claude

Dans claude.ai ou l’application de bureau, allez dans Paramètres → Connecteurs.
2

Ajouter un connecteur personnalisé

Cliquez sur Ajouter un connecteur personnalisé, nommez-le Savebase, puis collez https://mcp.savebase.space/mcp.
3

Connecter et se connecter au compte

Cliquez sur Ajouter → Connecter, connectez-vous avec votre compte Savebase, puis autorisez l'accès. Les outils Savebase sont désormais disponibles dans vos conversations.

Fonctionne aussi sur mobile

Un connecteur distant ajouté sur claude.ai peut être utilisé dans Claude pour iOS et Android, même si de nouveaux serveurs ne peuvent pas être ajoutés directement depuis Claude Mobile. Consultez la documentation d'Anthropic : notes actuelles de compatibilité MCP distant.

Claude Code

1

Ajouter le serveur

Exécutez la commande suivante dans votre terminal. Omettez --scope user si vous souhaitez le garder uniquement dans le projet actuel.
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

Authentifier

Démarrez Claude Code et exécutez /mcp. Une fenêtre de navigateur s'ouvre : connectez-vous et autorisez l'accès.
3

Vérifier

Exécuter claude mcp list. Savebase devrait apparaître comme connecté.

Cursor

1

Ouvrir votre configuration MCP

Accéder à Paramètres → MCP → Ajouter un serveur, ou modifiez ~/.cursor/mcp.json directement.
2

Ajouter le serveur Savebase

Ajoutez l'entrée ci-dessous. Notez l'absence de headers bloc : l’authentification a lieu dans le navigateur.
json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Recharger et autoriser

Rechargez Cursor. Le serveur indique qu’une connexion est nécessaire : cliquez dessus, connectez-vous et donnez votre accord.

Important pour les utilisateurs de Cursor

Sélectionnez toujours HTTP comme type de serveur, pas SSE. Si vous aviez une entrée SSE pour Savebase, supprimez-la, ajoutez-la à nouveau en HTTP, puis redémarrez Cursor.

ChatGPT

1

Ouvrir le plugin Savebase

Visitez le site officiel Fiche du plugin Savebase dans ChatGPT.
2

Installer et se connecter

Sélectionnez le bouton plus pour installer Savebase. À l’invite, connectez-vous à votre compte Savebase et autorisez l’accès en lecture seule à votre bibliothèque.
3

Utiliser Savebase dans une conversation

Commencez une nouvelle conversation ChatGPT Work et invoquez Savebase avec @Savebase, ou sélectionnez-le dans la zone de saisie lorsque vous voulez que ChatGPT effectue une recherche dans votre bibliothèque.

Aucune configuration technique nécessaire

Le plugin public remplace l’ancien mode Développeur et la configuration MCP personnalisée de ChatGPT. L’URL du serveur MCP ci-dessus reste utilisée pour les autres clients compatibles.

VS Code

1

Ajouter le serveur

Ouvrez la palette de commandes et exécutez MCP : ajouter un serveur, choisissez HTTP, puis collez https://mcp.savebase.space/mcp.
2

Ou modifier directement la configuration

Ajouter ceci à .vscode/mcp.json dans votre espace de travail :
json
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Se connecter

Démarrez le serveur depuis la vue MCP. Une fenêtre de navigateur s’ouvre pour vous connecter : donnez votre accord et les outils apparaissent dans le mode agent de Copilot Chat.

Gestion des applications connectées

Chaque application à laquelle vous vous connectez figure sous Paramètres → Serveur MCP → Applications connectées, avec la date de connexion et la dernière fois qu'il a lu votre bibliothèque. Cliquez sur Déconnecter pour révoquer immédiatement l’accès.

Ce qu’une application peut voir

Les applications connectées disposent d'un accès en lecture seule à vos favoris, notes, transcriptions, noms de dossiers et tags. Elles ne voient jamais votre mot de passe et ne peuvent pas modifier votre bibliothèque.

Savebase ne transmet des données que lorsqu’une demande amène l’assistant connecté à interroger le serveur MCP. Il ne pousse pas votre bibliothèque en arrière-plan vers les applications connectées et ne l’utilise pas pour entraîner un modèle Savebase. Une fois les données reçues par un assistant, les conditions de confidentialité et d’utilisation des données de son fournisseur s’appliquent. Consultez Politique de confidentialité Savebase pour la liste complète des données qu’une application connectée peut recevoir.

Avancé : jeton d'accès manuel

Certains anciens clients MCP ne permettent pas la connexion dans le navigateur et nécessitent un jeton envoyé dans un en-tête. Dans ce cas, ouvrez Paramètres → Serveur MCP → Avancé, saisissez un libellé, puis cliquez sur Générer un jeton. Le jeton commence par sb- et reste valide jusqu’à sa révocation.

json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Sécurité des jetons

Savebase ne stocke jamais votre jeton brut, uniquement son empreinte SHA-256. Il n’est affiché qu’une fois à sa création : copiez-le immédiatement. Vous pouvez le révoquer à tout moment dans Paramètres → Serveur MCP.

Outils disponibles

Une fois la connexion établie, votre assistant IA peut utiliser ces neuf outils. Ils servent tous uniquement à consulter votre bibliothèque : aucun ne peut la modifier.

OutilDescription
search_bookmarksRecherchez par mot-clé dans les titres, contenus, notes, auteurs, URL et transcriptions vidéo. Limitez la recherche à des champs précis et filtrez par plateforme, dossier, étiquette, créateur, plage de dates ou présence d’une transcription.
list_bookmarksParcourez sans mot-clé, avec des filtres facultatifs de plateforme, dossier, tag et date
list_recent_bookmarksVos enregistrements du jour, de la semaine, du mois ou des 7 ou 30 derniers jours
get_bookmarkTous les détails d’un favori, avec ses étiquettes, ses dossiers et un aperçu de transcription
get_bookmark_transcriptLisez une longue transcription vidéo par sections sans devoir tout charger d’un coup
find_bookmark_by_urlVérifiez si un lien est déjà enregistré. Ignore les paramètres de suivi tels que utm_source.
list_foldersListez vos dossiers, y compris leur arborescence
list_tagsListez toutes vos étiquettes
get_library_statsTotaux, répartition par plateforme, dossiers et étiquettes les plus utilisés, activité récente d’enregistrement

Exemples de prompts

Posez à votre assistant IA des questions comme :

  • « Qu’ai-je enregistré sur l’entraînement avec des kettlebells ? »
  • « Montre-moi tout ce que j'ai enregistré depuis Reddit le mois dernier. »
  • « Trouve la vidéo enregistrée dans laquelle quelqu'un explique comment configurer un Cloudflare Worker. »
  • « Ai-je déjà enregistré ce lien ? » — coller une URL
  • « Trouve tous les favoris dans mon dossier “Inspirations design”. »
  • « Quels articles ai-je associés au tag “AI” ? »
  • « Donne-moi un bilan de ma bibliothèque : quantité, provenance, principaux tags. »
  • « Résume les publications que j'ai enregistrées la semaine dernière. »

Rechercher les propos tenus dans une vidéo

Si vous avez transcrit une vidéo enregistrée, son contenu oral est également consultable par recherche. Une question comme « comment faire X » peut retrouver une étape expliquée à l’oral dans un clip enregistré il y a des mois.

Dépannage

ProblèmeSolution
Savebase n’est pas disponible dans ChatGPTOuvrez plugin Savebase publié, installez-le, puis démarrez une nouvelle conversation ChatGPT Work. Vous n'avez plus besoin de créer une application personnalisée en mode développeur.
L’application ne vous demande jamais de vous connecterVérifiez que l'URL est exactement https://mcp.savebase.space/mcp — une faute de frappe empêche le client de trouver l’étape de connexion.
« Accès MCP indisponible » lors de la connexionConnectez-vous avec un compte disposant actuellement de l’accès MCP, ou contactez l’assistance Savebase si vous pensez que vos droits sont incorrects.
« Cette demande a expiré »Les demandes d'autorisation sont valides pendant 10 minutes. Relancez la connexion depuis votre application IA.
La connexion ne fonctionne plusVérifiez si l'application figure encore dans Paramètres → Serveur MCP → Applications connectées. Si elle a été déconnectée, reconnectez-la depuis l'application.
Le serveur affiche « errored » dans CursorSupprimez l’ancienne entrée Savebase dans Paramètres de Cursor → MCP. Ajoutez-la à nouveau sous le nom Type : HTTP (pas SSE), puis redémarrez complètement Cursor.
Les outils ne s’affichent pasRedémarrez votre client IA après avoir ajouté la configuration. Certains clients nécessitent un redémarrage complet pour détecter de nouveaux serveurs MCP.
Résultats videsVérifiez que votre bibliothèque Savebase contient des favoris. Le serveur MCP recherche uniquement vos propres données.
Jeton manuel perduLes jetons ne sont affichés qu’une seule fois. Révoquez l’ancien dans Paramètres → Serveur MCP → Avancé, puis générez-en un nouveau.

Étapes de rétablissement rapide

Si cela ne fonctionne pas : (1) déconnectez Savebase dans votre application d’IA, (2) retirez-le de Paramètres → Serveur MCP → Applications connectées, (3) ajoutez à nouveau le connecteur et connectez-vous, (4) redémarrez complètement le client d’IA.