So verbindest du einen Claude-Chat per Custom Connector mit deinen osFoundry-Projekten

Am Ende kann eine ganz normale Claude-Unterhaltung auf claude.ai die Notes, Wissensdatenbanken und Records in einem deiner osFoundry-Projekte öffnen, daraus antworten und im Diskussionskanal dieses Projekts posten. Mit deiner Freigabe kann sie sie auch bearbeiten. Bei Claude bleibst du wie gewohnt angemeldet. osFoundry entscheidet bei jedem Tool-Aufruf, worauf dieser Chat zugreifen darf, und jeder Aufruf wird in osFoundry unter Recent activity der Verbindung aufgelistet. ChatGPT verbindet sich genauso, mit derselben Serveradresse.

Wer macht was

	Claude-Seite	osFoundry-Seite
Anmeldung	Dein Claude-Konto, unverändert	Dein osFoundry-Konto genehmigt die Verbindung einmal, für einen Workspace
Was das Modell ausführt	Claude, im Chat, den du schon nutzt	Nichts. Auf diesem Weg gibt es kein Modell und keinen Provider-Key
Wo die Tools laufen	Claude sendet den Tool-Aufruf	api.osfoundry.io führt ihn aus und prüft vorher den Zugriff
Was erreichbar ist	Das, was der Server zurückgibt	Projekte, denen du die Verbindung hinzugefügt hast, plus Kanäle, in die du sie eingeladen hast
Freigaben	Claudes eigene Abfrage für Tool-Berechtigungen	Änderungen an GitNest und Room warten unter "Needs your approval"
Wo die Daten bleiben	Die Antwort liegt in deinem Claude-Chat	Notes, Records und Artikel bleiben in osFoundry. Rein lokale Inhalte verlassen das Gerät nie

Einrichtung

1. Die Verbindung in osFoundry anlegen

Klicke in osFoundry auf das Schlüsselsymbol im Header und öffne den Tab Connected. Das Panel heißt "Connected agents" und zeigt, in welchem Workspace du bist. Unter "Connect in three steps":

• Assistant: Claude wählen
• Display name: irgendein Name, den du später wiedererkennst, z. B. Claude research
• Auf Add assistant (Assistent hinzufügen) klicken

Die neue Verbindung zeigt "Setup pending. This assistant cannot read or change anything yet." Kopiere die Server address mit dem Copy-Button daneben:

https://api.osfoundry.io/api/v1/external-mcp

Beispiel: Der Tab Connected nach Add assistant, mit der Serveradresse und einer ausstehenden Verbindung

2. Als Custom Connector zu Claude hinzufügen

Öffne in Claude Customize → Connectors und füge mit dieser URL einen Custom Connector hinzu. In einem Team- oder Enterprise-Plan fügt ihn zuerst ein Organisations-Owner unter Organization settings → Connectors hinzu, danach verbindet sich jedes Mitglied. Die Schritte von Anthropic für Remote-MCP-Connectoren stehen in der Anleitung zu Custom Connectors von Claude.

Wenn du auf Connect klickst, findet Claude die Anmeldung von osFoundry selbst. Du fügst weder eine Client-ID noch einen Key ein.

3. Einen Workspace genehmigen

Dein Browser landet auf https://osfoundry.io/external-assistant-authorize, einer Seite mit dem Titel "Connect an agent". Sie zeigt den Assistant-Client und den Host, zu dem er zurückkehrt, und fragt dann nach:

• Workspace to connect: ein Workspace. Ein zweiter Workspace braucht eine eigene Verbindung.
• Requested capabilities, in Klartext: "Read supported resources in projects you add", "Change supported resources where you have edit access", "Run sessions where you grant a runner role".
• Connection: Wähle "Use pending: Claude research", damit sie an die Verbindung aus Schritt 1 angehängt wird, oder lass "Create a new connection" stehen.
• Setze den Haken bei "I approve connecting this assistant to " und klicke auf Connect.

Du wirst zu Claude zurückgeschickt. Die Verbindung ist aktiv, sieht aber noch nichts. Eine neue Verbindung startet mit null Projekten.

4. Zu einem Projekt hinzufügen

Zurück unter Schlüsselsymbol → Connected wählst du die Verbindung aus. Dort steht jetzt "Connected." Wähle unter Projects ein Projekt und klicke auf Add to project.

Beispiel: Die Verbindung, einem Projekt hinzugefügt, darunter der verknüpfte Chat

Damit erhält sie Zugriff auf die unterstützten synchronisierten Inhalte in diesem Projekt: Notes, Wissensdatenbanken, Record-Kanäle, Cloud-Rooms, die dem Projekt zugewiesenen GitNest-Repositorys und den Diskussionskanal des Projekts. Inhalte, die du später zum Projekt hinzufügst, sind ebenfalls dabei. Normale Message-Kanäle sind davon getrennt. Nutze Message channels → Choose a Message channel → Invite für jeden Kanal, in dem der Chat lesen und antworten soll.

Im Bereich Tools steht "All supported tools are on by default." Entferne den Haken bei allen Tools, die diese Verbindung nicht haben soll, und klicke auf Save tools.

Beispiel: Die Tools-Checkliste einer Claude-Verbindung, standardmäßig alle aktiviert

5. Im Chat einschalten

Öffne in einer Claude-Unterhaltung das Menü + → Connectors und aktiviere den osFoundry-Connector. Danach fragst du einfach in normaler Sprache.

Ein echter Durchlauf

Prompt und Antwort unten sind Beispielinhalte aus einem Demo-Projekt. Die Tool-Namen und Argumentnamen sind genau die, die der Live-Server in tools/list anbietet. In claude.ai erscheinen die Aufrufe unter dem Namen des Connectors. Fügst du dieselbe URL in Claude Code als osfoundry hinzu, erscheinen dieselben Tools als mcp__osfoundry__list_project_resources und so weiter.

Beispiel

Du: Was ist laut osFoundry auf der Q3-Launch-Checkliste noch offen?
    Prüf die Support-KB auf Widersprüche dazu und setz dann
    den Record "pricing page" auf Ready.

Claude → list_granted_resources {}
       ← 1 verbundenes Projekt: "Launch Q3" (Workspace)
Claude → list_project_resources {"project_id": "…", "resource_type": "note", "search": "checklist"}
       ← Note "Q3 launch checklist"
Claude → list_note_tabs {"note_id": "…"}
       ← Tabs: Note (Text), Sheet "Owners"
Claude → read_note_tab {"note_id": "…", "tab_id": "…"}
       ← 9 Punkte, 3 nicht abgehakt
Claude → search_knowledge_base {"knowledge_base_id": "…", "query": "refund window"}
       ← Artikel "Refund policy" (vor 2 Tagen aktualisiert)
Claude → read_record_item {"record_channel_id": "…", "item_id": "…"}
       ← "pricing page", status Draft, version …
Claude → edit_record_item {"record_channel_id": "…", "item_id": "…",
                           "values": {"status": "Ready"},
                           "expected_version": "…", "idempotency_key": "…"}
       [Claude bittet dich, diesen Tool-Aufruf zu erlauben → Allow]
       ← gespeichert, neue version …

Claude: Drei Punkte sind offen: das Embargo-Datum für die Presse,
        die FAQ-Übersetzung und die Zeile zur Rückerstattung auf der
        pricing page. Die Checkliste nennt 14 Tage, der KB-Artikel
        "Refund policy" nennt 30. Den Record der pricing page habe
        ich auf Ready gesetzt.

Zwei Details in diesem Transkript sind Absicht. edit_record_item braucht die version, die read_record_item zurückgegeben hat. Ein Record, der sich zwischendurch geändert hat, wird also abgelehnt statt überschrieben. Ein wiederholter idempotency_key liefert das erste Ergebnis zurück, ein wiederholter Aufruf schreibt also nicht doppelt.

Wo die Grenze liegt

osFoundry kann deine Claude-Chats nicht öffnen. Die MCP-Verbindung erlaubt Claude, osFoundry-Tools aufzurufen, wenn Claude das für nötig hält. In die andere Richtung hat osFoundry keine API, um eine persönliche Unterhaltung aufzulisten, zu lesen oder zu starten. Das Tool, das einen Chat mit einem Projekt verknüpft (link_current_chat), übernimmt ein Label, das der Chat über sich selbst meldet, und osFoundry behandelt es als Routing-Hinweis, nicht als verifizierte Identität. Aus demselben Grund bekommt Claude von osFoundry keine Hintergrundbenachrichtigungen. Es handelt, wenn du die Unterhaltung öffnest und fragst.

Rein lokale Daten bleiben lokal. Der Server sagt das selbst in seiner Antwort auf initialize: "Local-only data is unavailable to cloud clients." Lokale Rooms, lokale Graph-Sessions und Inhalte, die nie synchronisiert wurden, sind für die Verbindung nicht sichtbar. Das Teilen von Desktop-Graph-Sessions ist ein separater Schalter im selben Tab, und die Desktop-App muss geöffnet und angemeldet sein.

Der Zugriff wird bei jedem Aufruf geprüft, nicht bei der Anmeldung. Jeder Aufruf wird abgeglichen mit dem Status der Verbindung, ihrem Workspace, der aktuellen Mitgliedschaft im Projekt, dem Projekt, in dem das Element gerade liegt, und deiner eigenen Rolle für dieses Element. Verschiebst du eine Note in ein anderes Projekt, entfernst das Projekt oder klickst auf Revoke connection, wird der nächste Aufruf abgelehnt. Bearbeitungen setzen außerdem voraus, dass du, die Person, die die Verbindung genehmigt hat, noch Bearbeitungsrechte hast.

Manche Schreibzugriffe werden zu Vorschlägen. GitNest-Aufgaben, Change Sets, Dateiimporte, Pull Requests und App-Installationen in Rooms laufen über propose_…-Tools. Sie warten im Tab Connected unter "Needs your approval", wo du das Ziel-Repository oder den Ziel-Room und die Dateien siehst, bevor du Approve oder Decline wählst. Claude bekommt nie deinen Token beim Git-Provider oder irgendeinen geheimen Wert.

Message-Kanäle brauchen eine Einladung. Die Mitgliedschaft in einem Projekt öffnet nur dessen Diskussionskanal. Jeder andere Kanal braucht ein ausdrückliches Invite, und bei einem privaten Kanal muss der Owner einladen.

Als Nächstes

Füge demselben Projekt eine Wissensdatenbank hinzu und stell Claude eine Frage, die du sonst daraus beantworten würdest, z. B. "Was sagt unsere KB zu Rückerstattungen, mit dem Namen des Artikels?". search_knowledge_base gibt die Artikel-ID und den Zeitpunkt der letzten Aktualisierung zurück, sodass du die Quelle prüfen kannst. Wie die Wissensdatenbanken in osFoundry aufgebaut sind, steht auf der Seite zu den Wissensdatenbanken.