Documentation
Le point de départ est le même pour tous. La suite dépend de vos besoins.
Conditions des clients vérifiées le 8 septembre 2026
01Pour tous
Commencez ici
Connectez Basin aux outils que vous utilisez déjà, donnez une instruction et partagez un espace. C’est ainsi que fonctionne Basin, et cela suffit à la plupart des usages.
Commencez iciSe connecter en deux minutes environ, depuis un navigateur
Une phrase à donner au début d’une conversation
Partager un espace avec quelqu’un en le nommant
02Une fois la connexion établie
Ajoutez vos propres agents
Tout ce qui précède reste valable. Voici ce qui devient possible avec des agents exécutés dans un dépôt ou selon un calendrier, sans votre présence.
ContinuerUne commande pour se connecter depuis un terminal
Un CLAUDE.md pour commencer chaque session de la même façon
Des exécutions sans interface qui alimentent un journal partagé
Également dans cette documentation
Le point de départ pour tous
Commencez ici
Connectez Basin aux outils d’IA que vous utilisez déjà, puis demandez à l’un d’eux de noter quelque chose. C’est tout le principe.
Connectez-le une fois
Basin est un endroit auquel vos outils d’IA accèdent. La première étape se déroule donc dans l’outil que vous utilisez le plus.
01Ouvrez le guide d’installation de l’outil d’IA que vous utilisez.
02Suivez son parcours de réglages actuel, puis collez l’adresse de Basin.
https://mcp.getbasin.co/mcp
03Validez la connexion. Utilisez l’adresse avec laquelle vous vous êtes inscrit : une autre adresse donne accès à d’autres espaces.
04Ouvrez une nouvelle conversation. Dans ChatGPT ou Gemini, sélectionnez Basin lorsqu’un message en a besoin.
La prise en charge varie selon les clients. Les connecteurs distants de Claude fonctionnent sur le web, Desktop, Cowork et mobile. Les applications MCP de ChatGPT fonctionnent uniquement sur le web. Les applications personnalisées Gemini se connectent sur le web, puis fonctionnent dans Spark sur le web et mobile. Consultez la configuration de
Claude,
ChatGPT ou
Gemini.
À quoi vous vous connectez, exactement
Basin est un serveur MCP. Les assistants compatibles utilisent la même adresse : Claude, ChatGPT, Gemini, Cursor et Claude Code. Vous autorisez chaque connexion dans l’outil avec votre propre compte.
L’adresse reste la même et ne porte pas de numéro de version. Les évolutions du protocole sont servies à cette adresse tout en maintenant les anciennes connexions.
Adresse de connexionhttps://mcp.getbasin.co/mcp
AuthentificationOAuth, RFC 9728 — la connexion se fait sur getbasin.co
context:readles espaces que vous possédez ou sur lesquels vous avez un accès
context:writecréer et modifier des fichiers en plus
Deux permissions volontairement larges. Des permissions plus fines imposeraient une nouvelle autorisation à chaque fonctionnalité.
Les conditions varient. Dans ChatGPT, un utilisateur personnel ajoute Basin lui-même ; un administrateur le publie d’abord pour Business, Enterprise et Edu. Gemini exige Spark, un compte Google personnel aux États-Unis, l’anglais, un âge d’au moins 18 ans et l’activité activée.
Donnez une instruction
Aucune commande à apprendre. L’agent lit les instructions fournies par Basin ; une phrase au début de la conversation lui indique de le consulter.
« Consulte Basin au début de chaque conversation. »
À dire une fois en début de conversation. Certains le placent dans les instructions personnalisées de leur outil et n’y repensent plus.
Il peut ensuite lire ce dont il a besoin avant de répondre et noter ce qu’il apprend.
Votre première session
Donnez-lui une information qu’il pourra réutiliser demain.
01Demandez un espace : « Crée-moi un espace appelé contexte. »
02Parlez-lui de vous : « Note comment j’aime les réponses : brèves, sans préambule, sans résumé à la fin. »
03Fermez la conversation. Ouvrez un autre outil et connectez-le de la même façon.
04Demandez au nouvel outil : « Comment est-ce que j’aime les réponses ? » Il lit le fichier et vous répond.
Le second outil ne vous connaissait pas et vous n’avez pas eu à tout lui expliquer.
Partager avec quelqu’un
Une autorisation couvre un espace entier, pas un fichier isolé, et inclut les fichiers ajoutés par la suite. Indiquez avec qui partager ; Basin fait le reste.
« Partage l’espace acme avec ravi@acme.co, en lecture seule. »
La personne reçoit un e-mail avec un lien consultable dans un navigateur et peut y connecter son propre assistant. Vous voyez ses lectures ; elle ne peut pas partager l’accès à son tour.
L’autorisation est liée à l’adresse indiquée. Une connexion avec une autre adresse ne donne aucun accès.
Quelques demandes utiles
« Que savez-vous de moi ? »Lit votre espace de contexte et vous le restitue, pour que vous puissiez le corriger.
« Qu’est-ce que Ravi a partagé avec moi ? »Lit un espace qu’on vous a accordé, sans que vous ayez à coller quoi que ce soit.
« Mets à jour mon profil. J’ai déménagé à Lisbonne. »Modifie le fichier et conserve l’ancienne version.
Une fois Basin configuré
Ajoutez vos propres agents
Le même compte, les mêmes espaces et les mêmes 14 outils, depuis un terminal plutôt qu’une conversation.
Se connecter en ligne de commande
01Ajoutez le serveur dans l’outil où vous travaillez.
claude mcp add --transport http basin https://mcp.getbasin.co/mcp
02Lancez /mcp et validez la connexion dans la fenêtre de navigateur qui s’ouvre.
03 Vérifiez la connexion : demandez-lui combien d’outils Basin il possède. La bonne réponse est 14.
Les connexions sont propres à chaque machine. Un ordinateur portable et un serveur ont chacun la leur ; en révoquer une ne coupe pas l’autre.
Un même point de départ pour chaque session
Un agent sans contexte peut lire les mauvaises informations ou ne rien lire. Définissez ses deux premières actions dans CLAUDE.md.
# CLAUDE.md
On startup, read the Basin guide resource,
then read _overview.md in the space you are working on.
Append what you learn to worklog.md before the session ends.
Exécuter des agents sans votre présence
Une session sans interface utilise la même connexion, sans intervention humaine.
01Donnez à l’agent un fichier de spécification comme point de départ, et un fichier de rapport où écrire en retour.
02Faites-lui ajouter une ligne à un journal de travail partagé à la fin de chaque exécution, qu’elle ait abouti ou non.
03Planifiez-le. Une exécution qui lit l’état, fait une seule chose et consigne ce qu’elle a fait vaut mieux qu’une exécution qui tente tout.
Deux agents qui écrivent dans le même fichier ne le corrompent pas : les modifications créent des versions et les conflits sont refusés plutôt que fusionnés.
Ce que couvrent les outils
14 au total, en six familles. Votre client les affichera ; la ressource guide décrit chacun d’eux en détail.
lecturelister un espace, lire un fichier, chercher dans tout ce que vous pouvez atteindre
écriturecréer, remplacer et modifier ; chaque écriture crée une version
historiqueconsulter les versions antérieures et en restaurer une
espacescréer et lister les espaces que vous possédez
partageaccorder, lister et révoquer ; toujours un espace entier
veillece qui a changé depuis votre dernière consultation, et le guide lui-même
Comment Basin se comporte
Conventions
Les règles données à vos agents, expliquées pour vous. Cette page présente les mêmes principes que les outils, en langage courant.
Des fichiers Markdown qui vous appartiennent
Un espace est un dossier. Tout ce qu’il contient est un fichier Markdown précédé d’un petit bloc de métadonnées. Il s’ouvre dans n’importe quel éditeur, et l’export contient ces mêmes fichiers dans un zip. Aucun format propriétaire dans lequel rester enfermé.
Chaque modification est attribuée
Une modification enregistre son propriétaire, sa date, la version produite et la famille du client utilisé. L’identité est vérifiée à la connexion. La famille du client est déclarée par l’outil lui-même.
written_byle compte vérifié, affiché par son nom lorsqu’il est connu. Basin l’atteste, et il ne peut pas être falsifié.
lele moment où l’écriture a été enregistrée.
versionincrémentée à chaque écriture ; les versions antérieures sont conservées.
viala famille de client, déclarée par l’outil lui-même. Affichage uniquement.
nom de l’agentfacultatif, choisi par l’agent lui-même. Toujours affiché à côté du compte vérifié, jamais seul.
Deux champs sont déclaratifs : la famille du client et le nom de l’agent. Basin les distingue visuellement des informations vérifiées.
L’historique n’est pas écrasé
Chaque modification crée une version. Une révocation bloque les lectures futures sans effacer les précédentes. Supprimer un espace efface ses fichiers, mais conserve ses événements dans votre journal, associés à un espace qui n’existe plus.
Modifier sur le web
Vous pouvez lire, télécharger et modifier vos fichiers sur le web. Chaque modification crée une version qui vous est attribuée, comme celle d’un assistant : l’historique n’est pas écrasé et les versions précédentes restent consultables.
Si un assistant a modifié le fichier pendant que vous le consultiez, Basin vous montre les deux versions. Les métadonnées ne sont pas modifiables sur le web : leurs étiquettes peuvent déterminer les accès, et un tel changement doit passer par le parcours de partage.
Les lectures sont visibles par le propriétaire
Vous voyez les lectures des espaces qui vous appartiennent, y compris celles des personnes autorisées. Celles-ci ne voient que leur propre activité, pas la vôtre ni celle des autres.
Quand cela ne fonctionne pas
Dépannage
La plupart des problèmes ont l’une de ces cinq causes. Vérifiez d’abord la connexion.
Vérifiez d’abord la connexion
Posez une question à laquelle l’outil ne peut répondre qu’en consultant réellement Basin.
« Combien d’outils Basin avez-vous ? »
14 signifie que la connexion fonctionne. Zéro signifie qu’elle n’est pas active dans cette conversation. Moins signifie que le client garde une ancienne liste d’outils et doit se reconnecter. Plus n’est pas une anomalie : un client connecté avant le retrait d’un outil le conserve, et il fonctionne toujours.
La page Connexions montre la situation du côté de Basin.
Les cinq causes
Connexion non sélectionnéeOuvrez une nouvelle conversation après vous être connecté. Dans ChatGPT ou Gemini, sélectionnez Basin pour le message qui en a besoin.
Mauvaise surface de clientLes applications MCP de ChatGPT fonctionnent uniquement sur le web. Les connecteurs distants de Claude fonctionnent sur le web, Desktop, Cowork et mobile. Les applications personnalisées de Gemini se connectent sur le web, puis fonctionnent dans Spark sur le web et sur mobile.
Mauvaise adresseLes accès sont liés à une adresse e-mail. Un second compte sur la même machine n’en voit aucun.
Liste d’outils périméeUn client connecté il y a plusieurs semaines peut conserver une ancienne liste. Retirez le connecteur et ajoutez-le de nouveau.
Il répond de mémoireCertains clients résument le contexte précédent au lieu d’aller chercher l’information. Demandez-lui de lire le fichier ; votre journal d’activité indique s’il l’a fait.
Projets et instructions personnalisées
Ajouter l’instruction dans un projet ou dans les instructions personnalisées évite de la répéter. Cela ne change pas le chargement des outils : une conversation ouverte avant l’ajout du connecteur ne le voit toujours pas.
Toujours bloqué ?
Le journal d’activité permet de trancher. Si une lecture a eu lieu, elle y figure avec sa date. Si le journal est vide, l’outil n’a pas appelé Basin : le problème vient de la connexion, pas du contenu.