À la fin de ce tutoriel, Claude (un chat claude.ai avec le connecteur, ou Claude Code dans votre terminal) répond aux questions de support et de produit à partir de l'une de vos bases de connaissances osFoundry. Chaque affirmation de sa réponse renvoie à un ID d'article et à l'heure de la dernière mise à jour de cet article. Le lendemain, Claude peut demander à osFoundry ce qui a changé depuis et vous dire lesquelles des réponses de la veille reposent sur un article que quelqu'un a réécrit entre-temps. Quand un article est lui-même faux, Claude peut le corriger, mais uniquement à partir de la version exacte qu'il a lue, et seulement après que vous avez autorisé l'appel.
Qui fait quoi
| Côté Claude | Côté osFoundry | |
|---|---|---|
| Connexion | Votre compte Claude ou votre installation de Claude Code, sans changement | Une connexion approuvée vers un seul workspace |
| Ce qu'il peut chercher | Ce que le serveur renvoie | Les articles publiés dans les bases de connaissances des projets auxquels la connexion a été ajoutée |
| La citation | Claude la garde à côté de chaque affirmation | Chaque lecture renvoie l'ID de l'article et l'heure de sa dernière mise à jour |
| Fraîcheur | Claude demande les changements depuis un numéro de séquence |
poll_resource_events tient un journal ordonné par base de connaissances |
| Modification | La demande d'autorisation de Claude avant chaque écriture |
expected_version doit correspondre, et vos droits de modification sont vérifiés à chaque appel |
| Historique | La transcription de Claude | Chaque appel est listé dans Recent activity de la connexion |
Mise en place
1. Connecter Claude
Créez d'abord la connexion dans osFoundry : icône de clé → Connected → Assistant: Claude → Add assistant. Copiez l'adresse du serveur affichée :
https://api.osfoundry.io/api/v1/external-mcp
Dans claude.ai, ajoutez cette URL comme connecteur personnalisé. Dans Claude Code, ajoutez-la depuis le shell, puis authentifiez-vous depuis une session :
claude mcp add --transport http osfoundry https://api.osfoundry.io/api/v1/external-mcp
# then, in Claude Code:
/mcp # pick osfoundry → Authenticate
Dans les deux cas, le navigateur ouvre la page "Connect an agent" d'osFoundry. Choisissez le workspace, cochez la case d'approbation et connectez-vous. Dans Claude Code, les outils apparaissent alors sous la forme mcp__osfoundry__search_knowledge_base, etc.
2. Ajouter la connexion au projet de la base de connaissances
Une nouvelle connexion ne voit rien. Dans icône de clé → Connected, sélectionnez-la, choisissez le projet sous Projects et cliquez sur Add to project.
Exemple : La section Projects d'une connexion, avec un projet ajouté
Si la base de connaissances n'est pas encore dans ce projet, ouvrez-la, allez dans le panneau de droite → Settings et choisissez le projet dans le champ Project. Le champ s'enregistre dès la sélection.
Exemple : L'onglet Settings de la base de connaissances avec le champ Project renseigné
3. Publier les articles sur lesquels Claude doit s'appuyer
Sélectionnez un article et ouvrez l'onglet Publishing dans le panneau de droite. Le statut indique Published ou Draft. Cliquez sur Publish Article pour chaque article que Claude doit voir. La note du panneau explique ce que cela implique : "Published articles are used by this workspace's AI assistant and search. They are not visible outside the workspace." Autrement dit, les articles publiés servent à l'assistant IA et à la recherche de ce workspace, mais restent invisibles en dehors. Les brouillons restent volontairement hors de portée de Claude, pour qu'un article à moitié rédigé ne soit jamais cité.
Exemple : L'onglet Publishing d'un article avec Status: Published et la note indiquant qu'il n'est visible que dans le workspace
4. Laisser les outils de la base de connaissances activés
Dans Tools de la connexion, ces outils sont activés par défaut, comme tous les autres :
read search_knowledge_base read_knowledge_article poll_resource_events
write edit_knowledge_article
Exemple : La liste Tools d'une connexion Claude, avec les outils de la base de connaissances cochés
Pour une configuration en lecture seule, décochez edit knowledge article et cliquez sur Save tools. La recherche, la lecture et le polling continuent de fonctionner.
5. Demander des citations dans le prompt
Claude cite de manière plus fiable quand vous lui dites à quoi ressemble une citation :
Answer from the "Support" knowledge base in osFoundry only.
After each claim, add [article_id · updated_at] from read_knowledge_article.
If no published article covers it, say so instead of guessing.
Une exécution réelle
Les articles, ID et dates ci-dessous sont un contenu d'exemple. Les noms des outils et leurs arguments sont ceux que le serveur réel liste dans tools/list, tels que Claude Code les affiche.
Example
You: A customer on a monthly plan asks how long they have to request a
refund, and whether SSO users get the same window.
● mcp__osfoundry__list_project_resources
{"project_id": "…", "resource_type": "knowledge_base"}
← "Support" (knowledge base)
● mcp__osfoundry__search_knowledge_base
{"knowledge_base_id": "…", "query": "refund window monthly plan", "limit": 5}
← 5 results, each with article_id and updated time
"Refund policy" updated 2026-11-03 09:41
"SSO and billing owners" updated 2026-10-28 16:02
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "9c1e…"}
← "Refund policy", citation 9c1e… · 2026-11-03T09:41:12.408211Z
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "4b70…"}
← "SSO and billing owners", citation 4b70… · 2026-10-28T16:02:55.019874Z
Claude: Monthly plans can be refunded within 14 days of the charge
[9c1e… · 2026-11-03T09:41:12Z]. SSO doesn't change that: refund
requests go through the billing owner, not the SSO account
[4b70… · 2026-10-28T16:02:55Z].
Le lendemain matin, dans la même conversation :
You: Are any of the answers you gave yesterday out of date?
● mcp__osfoundry__poll_resource_events
{"resource_type": "knowledge_base", "resource_id": "…", "after_sequence": 1182}
← 3 events; one touches 9c1e…
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "9c1e…"}
← "Refund policy", citation 9c1e… · 2026-11-04T08:15:30.112054Z
now says 30 days for monthly plans
Claude: One answer changed. "Refund policy" was updated this morning and
now gives 30 days, not 14 [9c1e… · 2026-11-04T08:15:30Z]. The SSO
part still stands; that article hasn't changed.
You: The FAQ article still says 14 days. Fix it to match.
● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "e27a…"}
← "Refund FAQ", version 2026-11-01T10:03:44.250911Z
● mcp__osfoundry__edit_knowledge_article
{"knowledge_base_id": "…", "article_id": "e27a…", "content": "…30 days…",
"expected_version": "2026-11-01T10:03:44.250911Z",
"idempotency_key": "faq-refund-30d"}
[Claude Code asks: allow this tool? → Yes]
← saved, version 2026-11-04T08:22:09.871530Z
Trois choses se passent ici qui n'arrivent pas dans un chat ordinaire.
La citation porte l'heure, pas seulement l'ID. Un ID seul vous dit quel article Claude a utilisé. L'heure de mise à jour vous dit dans quel état. C'est ce qui permet à Claude de répondre à « est-ce toujours vrai ? » sans relire chaque article qu'il a déjà cité.
Le polling coûte peu parce que c'est un journal. Claude n'avait à retenir qu'un seul nombre de la veille : la dernière séquence d'événements qu'il avait vue. Un seul appel à poll_resource_events a renvoyé ce qui avait changé depuis, et Claude n'a relu que l'article qui avait bougé.
La modification précise une version. edit_knowledge_article remplace le contenu de l'article (et son titre, si vous en passez un) uniquement si l'article est toujours à expected_version. Claude a lu la FAQ quelques secondes avant d'écrire, donc la version correspondait. Si quelqu'un avait enregistré la FAQ entre-temps, osFoundry aurait rejeté l'écriture et Claude l'aurait relue. Réutiliser la version d'une citation de la veille est la façon classique de se faire rejeter, donc un bon prompt dit « relis avant de modifier ».
Où se trouve la limite
Seuls les articles actuels et publiés sont consultables. La recherche et la lecture portent toutes deux sur l'article tel qu'il est maintenant. Dépublier un article le retire des résultats de Claude dès l'appel suivant, et une réponse qui le citait ne trouvera plus rien au moment de vérifier. C'est tout l'intérêt de faire de la publication une étape : c'est le workspace qui décide de ce qui compte comme réponse, pas le modèle.
Uniquement les bases de connaissances d'un projet connecté. Claude ne peut pas chercher dans une base de connaissances qui n'a pas été confiée à la connexion. Déplacer la base de connaissances vers un autre projet, retirer le projet de la connexion ou cliquer sur Revoke connection bloque l'appel suivant. Un token obtenu plus tôt ne garde pas l'accès ouvert.
Une modification est un remplacement complet, protégé deux fois. L'outil prend le contenu entier, donc osFoundry ne fusionne pas une copie périmée avec une plus récente. Il la refuse et laisse Claude refaire la modification à partir de l'état actuel. Côté Claude, l'outil est marqué comme une écriture qui modifie du contenu partagé (readOnlyHint: false, destructiveHint: true), c'est pourquoi Claude Code s'arrête pour demander. Côté osFoundry, l'appel s'exécute avec les droits de modification de la personne qui a approuvé la connexion. Si un chat Claude lié modifie depuis l'écran Knowledge Base d'osFoundry lui-même, osFoundry demande une approbation à chaque appel edit_knowledge_article, et cette approbation ne peut pas être étendue au reste de la session.
Chaque appel est visible. Recent activity de la connexion liste chaque nom d'outil, la décision et l'heure, vous voyez donc quels articles Claude a lus avant de répondre.
Exemple : Recent activity d'une connexion Claude avec les appels aux outils de la base de connaissances
Et ensuite
Prenez dix vraies questions auxquelles votre équipe a répondu la semaine dernière, demandez à Claude d'y répondre depuis la base de connaissances avec des citations, et gardez la conversation. Demain, demandez-lui quelles réponses sont obsolètes. Les articles qu'il signale sont ceux que votre équipe a modifiés, et les citations montrent exactement de quelle version vient chaque réponse. Ce que contient une base de connaissances et comment ses articles sont versionnés est expliqué sur la page Knowledge Base.
Top comments (0)