KI-Agenten anbinden
Ein KI-Agent wie Claude Code kann Ihre Wissensdatenbank direkt benutzen: Er sucht darin, lässt sich Fragen beantworten, listet Dokumente auf und lädt auf Wunsch neue hoch. Dafür braucht er zwei Dinge: einen API-Schlüssel und die Adresse des MCP-Servers.
Schritt 1: Schlüssel anlegen
Im Portal unter Integrationen → API-Keys legen Sie einen Schlüssel an. Geben Sie ihm einen Namen wie „Claude Code", wählen Sie die Rechte und die Zugriffsebene, und setzen Sie bei Bedarf ein Tageslimit. Der Schlüssel wird nach dem Anlegen genau einmal vollständig angezeigt. Kopieren Sie ihn sofort.
Wenn Sie den Menüpunkt Integrationen nicht sehen, fehlt Ihnen das Recht dazu. Ein Administrator vergibt es unter Team → Benutzer mit dem Kontrollkästchen „Darf API-Keys erstellen".
Ein Schlüssel gehört Ihnen. Er sieht höchstens, was Sie sehen, und wird gesperrt, sobald Ihr Konto deaktiviert wird.
Schritt 2: Schlüssel sicher ablegen
Der Schlüssel ist ein Passwort. Er gehört nie in den Chat mit dem Agenten und nie in eine Datei, die Sie mit anderen teilen oder in eine Versionsverwaltung wie Git legen. Claude Code hat dafür eine eigene Einstellungsdatei je Benutzer, ähnlich einer .env-Datei. Sie liegt in Ihrem Benutzerordner und wird nicht mit Projekten weitergegeben:
- Mac und Linux:
~/.claude/settings.json - Windows:
C:\Users\<Name>\.claude\settings.json
Tragen Sie dort den Block env ein. Gibt es die Datei schon, ergänzen Sie den Block zu den vorhandenen Einträgen:
{
"env": {
"AIMORPHA_API_KEY": "rag_live_…"
}
}Claude Code liest die Datei bei jedem Start. Wer lieber mit der Shell arbeitet, kann stattdessen export AIMORPHA_API_KEY="rag_live_…" in ~/.zshrc oder ~/.bashrc eintragen. Beide Wege führen zum selben Ergebnis. Eine .env-Datei im Projektordner liest Claude Code dagegen nicht von allein.
Schritt 3: Claude Code verbinden
Die Adresse des MCP-Servers lautet:
https://memory.aimorpha.ai/mcpLegen Sie im Projektordner, in dem Claude Code den Zugriff haben soll, die Datei .mcp.json an. Sie enthält nur den Platzhalter, nicht den Schlüssel, und darf deshalb auch in Git liegen:
{
"mcpServers": {
"aimorpha-memory": {
"type": "http",
"url": "https://memory.aimorpha.ai/mcp",
"headers": { "Authorization": "Bearer ${AIMORPHA_API_KEY}" }
}
}
}Claude Code setzt beim Start den Wert aus Schritt 2 ein. Der Agent selbst bekommt den Schlüssel nie zu sehen.
Dasselbe geht mit einem Befehl im Terminal. Die einfachen Anführungszeichen sind wichtig, damit die Shell den Platzhalter nicht schon beim Eintippen ersetzt:
claude mcp add --transport http aimorpha-memory https://memory.aimorpha.ai/mcp --header 'Authorization: Bearer ${AIMORPHA_API_KEY}'Prüfen Sie die Verbindung mit /mcp in Claude Code. Das ist die eingebaute Übersicht aller MCP-Server. Dort erscheint „aimorpha-memory" als verbunden, und Sie sehen die Werkzeuge der Wissensdatenbank.
Andere Programme
Jeder MCP-fähige Client funktioniert genauso: Adresse https://memory.aimorpha.ai/mcp, Verbindungsart „HTTP" oder „Streamable HTTP", Kopfzeile Authorization: Bearer … mit dem Schlüssel. In n8n ist das der Knoten „MCP Client", der Schlüssel gehört dort in eine Zugangsdaten-Vorlage vom Typ „Header Auth", nicht in den Knoten selbst.
Programme ohne MCP sprechen die Schnittstelle direkt an. Eine Suche sieht so aus:
curl -X POST https://memory.aimorpha.ai/api/v1/search \
-H "Authorization: Bearer $AIMORPHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question": "Wie lange gilt die Garantie?", "top_k": 5}'Weitere Wege: POST /api/v1/ask für eine fertig formulierte Antwort mit Quellen, GET /api/v1/documents für die Dokumentenliste, POST /api/v1/documents zum Hochladen einer Datei.
Die Antwort von /api/v1/ask (und von ask_knowledge) enthält unter sources alle Quellen, die dem Sprachmodell vorlagen, in derselben Reihenfolge wie die Verweise [1], [2] usw. im Antworttext. Das Feld cited steht bei jeder Quelle: true heißt, die Antwort stützt sich auf diese Quelle. Für eine Quellenangabe nehmen Sie am besten nur diese. Enthält die Antwort keine Verweise, steht cited bei allen Quellen auf true.
Was der Agent kann
| Werkzeug | Was es tut | Nötiges Recht |
|---|---|---|
search_knowledge | Fundstellen im Bestand nachschlagen, ohne formulierte Antwort | Suchen |
ask_knowledge | Eine Frage stellen und eine belegte Antwort erhalten | Fragen beantworten |
list_documents | Die sichtbaren Dokumente auflisten | Suchen |
upload_document | Ein Dokument in den Bestand hochladen | Dokumente hochladen |
Der Agent sieht nur Dokumente bis zur Zugriffsebene des Schlüssels und nur die Gruppen, die dem Schlüssel zugeteilt sind. Antworten kommen ausschließlich aus Ihren Dokumenten. Findet der Agent nichts, sagt er das.
Zugriff: Firmenwissen und Persönlicher Space
Im Schlüsseldialog legen Sie unter Zugriff fest, was der Agent nutzen darf:
- Firmenwissen: an oder aus. Eingeschaltet gelten die Rechte, die Zugriffsebene und die Gruppen des Schlüssels wie oben beschrieben.
- Persönlicher Space: aus, lesen oder lesen und schreiben. Der persönliche Space ist das Gedächtnis Ihrer Agenten: Fakten, Vorlieben und Entscheidungen, die sich ein Agent merkt und in der nächsten Sitzung wieder abruft. Mit „lesen" ruft der Agent Einträge nur ab, mit „lesen und schreiben" legt er auch neue an, ändert und löscht sie. „lesen und schreiben" steht zur Wahl, wenn Sie Schlüssel mit vollen Rechten anlegen dürfen.
Ein Schlüssel kann auch nur für das Gedächtnis gelten: Schalten Sie Firmenwissen aus und wählen Sie beim persönlichen Space „lesen" oder „lesen und schreiben". Ein solcher Agent sieht keine Dokumente. Mit Gedächtnis-Zugriff bekommt der Agent die Werkzeuge memory_briefing, memory_recall und memory_list_spaces, mit Schreibrecht zusätzlich memory_remember, memory_update und memory_forget.
Was Ihre Agenten sich gemerkt haben, sehen Sie im Portal auf der Seite Spaces. Dort prüfen, ändern und löschen Sie Einträge und exportieren den Space. Ihren persönlichen Space sehen nur Sie und die Schlüssel, denen Sie ihn freigeben.
Limits und Sicherheit
- Tageslimit: Haben Sie eines gesetzt, weist Memory nach dem Erreichen weitere Aufrufe bis Mitternacht ab. Bei 80 Prozent bekommen Sie und die Administratoren eine E-Mail.
- Drossel: Mehr als 60 Aufrufe pro Minute mit demselben Schlüssel werden abgewiesen. Der Agent bekommt dann eine Wartezeit mitgeteilt. Details zu allen technischen Grenzen finden Sie im Artikel Missbrauchsschutz.
- Schlüssel verloren oder weitergegeben? Sperren Sie ihn im Portal sofort. Das wirkt in derselben Sekunde. Legen Sie danach einen neuen an.
- Benutzername und Passwort gehören nicht in den Agenten. Der Schlüssel ist die Anmeldung, und er lässt sich einzeln sperren, ohne dass Ihr Konto betroffen ist.
- Nie in den Chat. Fragt ein Agent nach dem Schlüssel, geben Sie ihn nicht ein. Er gehört in die Einstellungsdatei aus Schritt 2, der Agent braucht ihn nicht zu kennen.