Calypso Multimodal RAG MCP Server

Der einfachste gehostete multimodale RAG-MCP-Server für Claude Desktop, Cursor und Agent-Workflows.

Ein einziger npx-Befehl – unterstützt von Gemini File Search. Verarbeitet PDFs, Screenshots, Schaubilder, Diagramme und Bilder nativ mit überprüfbaren Quellenangaben.

Der einfachste Weg, gehostetes multimodales RAG zu Claude, Cursor, Windsurf und benutzerdefinierten Agenten hinzuzufügen.

• Super einfache Einrichtung: npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-your-key-here

• Echtes multimodales RAG: verarbeitet Text und visuelle Inhalte nativ über Gemini File Search

• Hochladen und Abfragen: spezielle Tools für dauerhafte Wissensdaten und Stapel-Uploads

• Mehrrunden-Gespräche: kontextbezogene Antworten mit /new-Reset

• Auffindbare Workflows: Ressourcen und Prompts für sichere RAG-, Upload- und Aufnahme-Workflows

GitHub | Dokumentation | Smithery | Offizielles MCP-Registry

Tags: multimodal-rag, easiest-mcp-rag, gemini-rag, hosted-rag-mcp, mcp-server

Statt jeden Agenten oder Workflow an einen einmaligen Dokument-Such-Stack anzubinden, nutzen Sie diesen MCP als agentenorientierten Einstiegspunkt in eine wiederverwendbare Antwortebene: Laden Sie Quellmaterial einmal hoch, rufen Sie es über Text- und visuelle Inhalte hinweg ab und liefern Sie Antworten mit Belegen, die Nutzer verifizieren können.

Schnellstart (Am einfachsten)

# One-liner with npx
npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-your-key-here"

Oder mit Umgebungsvariablen:

CALYPSO_API_KEY="sk-..." npx -y @calypsohq/multimodal-rag-mcp-server

Fügen Sie dieselben Befehl mit den Konfigurationsbeispielen unten zu Claude Desktop, Cursor oder Smithery hinzu.

Related MCP server: RAG-Anything MCP Server

Warum Calypso wählen

Calypso wurde für Teams entwickelt, die den einfachsten gehosteten multimodalen RAG-MCP-Server möchten: kein lokaler Vektor-Stack, kein Docker Compose und keine eigene OCR- oder Bildverarbeitungspipeline, bevor Agenten quellenbasierte Fragen stellen können.

Beginnen Sie hier, wenn Sie den einfachstenen, gehosteten, multimodalen RAG-MCP-Server möchten.

Was Sie außerdem davon haben

• Produktionsreifer multimodaler RAG-Agent mit Mehrrunden-Speicher

• Integrierte Upload-Tools für Einzeldateien und Stapel-Wissens-Uploads

• Automatische Identifizierung der RAG-Varianten und Wissensbuckets Ihres Teams

• Überprüfbare Zitate mit Quellenverweisen und Retrieval-Metadaten

• Schreibgeschützte Ressourcen und wiederverwendbare Prompts für sichere Workflows

Warum Multimodal-First-RAG

Das meiste Unternehmenswissen besteht nicht nur aus Text. Die Antwort liegt oft in einem Setup-Screenshot, einer PDF-Tabelle, einem Produktdiagramm, einer Help-Center-Seite oder einem Diagramm in einem Bericht. Calypso bündelt all dieses Wissen in einer einzigen Retrieval-Ebene, damit Agents Fragen beantworten können, ohne sich auf generelles Modellwissen verlassen zu müssen.

• Durchsuchen Sie die Formate, auf die Nutzer sich verlassen: Dokumentation, PDFs, Screenshots, Diagramme, Tabellen, Produktbilder, Support-Artikel, Handbücher, Richtlinien, FAQs und Berichte.

• Belegte Antworten, bevor das Modell schreibt: Gemini File Search ruft zuerst relevanten Text und visuellen Kontext ab, dann antwortet der RAG-Agent auf der Grundlage dieses Quellenmaterials.

• Die Belegkette zeigen: Antworten können Quellenverweise, seitenbezogenes Grounding und Retrieval-Metadaten enthalten, damit Nutzer prüfen können, bevor sie vertrauen.

• Retrieval mit Metadaten eingrenzen: Mithilfe von Workspace, Team, Kunde, Sprache, Dateityp, Status oder anderer Metadaten bleiben Antworten relevant, ohne dass Wissensdatenbanken dupliziert werden müssen.

• Dieselbe Wissensebene überall wiederverwenden: Cursor, Claude Desktop, KI-Agenten, n8n-Workflows, Produkt-UI, Support-Abläufe und Website-Erlebnisse mit derselben quellenbasierten Ebene verbinden.

In der Praxis kann Ihr Agent Fragen wie die folgenden beantworten:

• „Erklär mir diesen Setup-Screenshot und das beigefügte PDF mit der Richtlinie. Was soll der Supportmitarbeiter als Nächstes tun?“

• „Was sagt dieses Onboarding-PDF über Genehmigungsregeln?“

• „Warum schlägt dieser Einrichtungsbildschirm fehl?“

• „Vergleiche das Preisschaubild mit unserer Tarifdokumentation und empfehle das richtige Paket.“

• „Fasse die Richtlinie zusammen, die auf dieses Unterstützungsticket zutrifft.“

• „Welches Produktpaket passt zu diesem Kunden, baseline auf unserer Grenzdokumentation?“

• „Vergleichen Sie den dargestellten Aufnahm-Workflow mit dem Retrieval-Workflow.“

Was dieser MCP tut

Mit calypso-rag-agent können Sie Folgendes tun:

• Stellen Sie grundlegende Fragen gegen die konfigurierte Calypso-Wissensbase.

• Wählen Sie mit dem optionalen Argument model eine beliebige erkannte Team-RAG-Variante aus.

• Mehrrunden-Gespräche fortsetzen über das native, erreichbare auf /v1/responses aufbauende Konversationsmodell.

• Setzen Sie den Gesprächskontext mit /new zurück.

• Verwenden Sie denselben OpenAI-kompatiblen Responses-Endpunkt, der calypso-rag-agent ressourcen.

• Entdecken Sie eingebaute Ressourcen und Prompt-Vorlagen für die unterstützten Calypso-Workflows.

Voraussetzungen

• Node.js 18+

• Der Server verwendet für API-Auft Graben: fetch, Headers, Request, Response, FormData, Blob und File – Primitiven der Web-Fetch-API und SDK-Kompatibilität. Das Paket erstellt beim Start fehlende Globals für MCP-Runtimes, die nur einen Teil der Node-18+-Web-API-Oberfläche bereitstellen.

• Ein Calypso-API-Endpunkt, der folgende Endpunkte bereitstellt:

  • POST /v1/responses

  • GET /v1/rag-agent/models

  • GET /v1/knowledge/buckets

  • POST /v1/knowledge/files/upload-session

  • POST /v1/knowledge/files/upload-session/{session_id}/finalize

  • POST /v1/knowledge/files:batch/upload-session

  • POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize

  • GET /v1/knowledge/batches/{batch_id}

• Ein Calypso-API-Schlüssel (sk-...)

Konfiguration

Umgebungsvariablen:

• CALYPSO_API_KEY (erforderlich)

• CALYPSO_API_BASE_URL (optional, Standard: https://api.calypso.so/v1)

CLI-Flags:

• --api-key

• --api-base-url

Konfigurationspriorität:

1. CLI-Flags / von Smithery bereitgestellte Befehlsargumente

2. Umgebungsvariablen

3. Standard-Basis-URL (https://api.calypso.so/v1)

Mit npx ausführen

npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-..."

Mit Umgebungsvariablen ausführen

env CALYPSO_API_KEY="sk-..." CALYPSO_API_BASE_URL="https://api.calypso.so/v1" npx -y @calypsohq/multimodal-rag-mcp-server

In Cursor konfigurieren

Fügen Sie einen neuen MCP-Server (Befehlstyp) wie folgt hinzu:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

In Claude Desktop konfigurieren

1. Claude-Desktop-MCP-Konfiguration öffnen

In Claude Desktop:

Claude -> Settings -> Developer -> Edit Config

Unter macOS befindet sich die Datei normalerweise unter:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop verwendet claude_desktop_config.json für Desktop MCP-Server. Claude Code verwendet separate Konfigurationsdateien wie ~/.claude.json oder Projekt .mcp.json.

2. Den Calypso-MCP-Server hinzufügen

Fügen Sie Folgendes in claude_desktop_config.json ein:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    }
  }
}

Ersetzen Sie:

• sk-your-calypso-api-key

mit Ihrem echten Calypso-API-Schlüssel.

3. Claude Desktop vollständig neu starten

Beenden Sie Claude Desktop vollständig und öffnen Sie es dann erneut.

Schließen Sie nicht einfach das Fenster. Auf macOS:

Cmd + Q

Nach dem Neustart sollte der MCP in Claude mit folgenden verfügbaren Tools erscheinen:

• calypso-rag-agent

• calypso-list-buckets

• calypso-upload-file

• calypso-upload-files-batch

Optional: Claude-Artefakte auf Ihrem Mac speichern

Calypso stellt gehostete multimodale RAG-Tools bereit. Es schreibt keine zworganizationgenerierten Berichte, Zusammenfassungen, CSV-, JSON-Dateien oder Websuchartefakte direkt auf Ihren lokalen Computer.

Damit Claude Desktop generierte Dateien lokal speichern kann, fügen Sie den Standard-Filesystem-MCP-Server zusätzlich zu Calypso und beschränken Sie ihn auf einen bestimmten sicheren Ordner.

Erstellen Sie den Ordner zuerst:

mkdir -p ~/Claude

Fügen Sie dazu beide Server zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Claude"
      ]
    }
  }
}

Nachdem Sie die Konfiguration geändert haben, beenden Sie Claude Desktop vollständig und öffnen Sie es erneut.

Beispiel-Prompt:

Use Calypso for the grounded RAG answer, then save the final report as /Users/yourname/Claude/report.md using the filesystem tool.

Aus Sicherheitsgrunden gewähren Sie Filesystem-Zugriff nur auf einen bestimmten Ordner wie ~/Claude, nicht auf Ihr gesamtes Home-Verzeichnis.

Smithery

Der Server ist über Smithery verfügbar und startet über denselben von Desktop-Clients verwendeten npx-Paketpfad.

Smithery-Benutzerkonfiguration:

• calypsoApiKey (erforderlich)

• calypsoApiBaseUrl (optional, Standard: https://api.calypso.so/v1)

Der Smithery-Startpfad entspricht:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Verwenden Sie calypsoApiBaseUrl nur, wenn Sie eine selbst gehostete, Calypso-kompatible Bereitstellung ansprechen. Der Cloud-Standardwert muss nicht geändert werden.

Fehlerbehebung

• Fehlender API-Schlüssel: --api-key oder CALYPSO_API_KEY angeben

• Falscher API-Host: sicherstellen, dass --api-base-url / CALYPSO_API_BASE_URL auf /v1 endet

• Self-hosted-Bereitstellung: Die Basis-URL nur überschreiben, wenn Sie nicht https://api.calypso.so/v1 verwenden

• Smithery-Startkonflikt: Verwenden Sie den gepackten Pfad npx -y @calypsohq/multimodal-rag-mcp-server statt node dist/index.js aus einem frischen Klon auszuführen

• FormData is not defined oder Headers is not defined: Aktualisieren Sie auf das neueste Paket. Der MCP-Server bootstrappt fehlende Web-Fetch-API-Globals, bevor Upload-Tools ausgeführt werden.

• ENOENT für /mnt/user-data/uploads/...: Dieser Pfad gehört zu einer gehosteten Agenten- oder Anhang-Sandbox, nicht unbedingt zum MCP-Server. Wiederholen Sie den Vorgang mit contentBase64 statt filePath.

• Lokales Speichern von Artefakten: Calypso-Antworten können mit dem Dateisystem-MCP-Server von Claude Desktop verwendet werden, aber Claude muss explizit aufgefordert werden, die endgültige Ausgabe in einem erlaubten lokalen Pfad zu speichern.

Auswahl von filePath vs. contentBase64

Verwenden Sie filePath für lokale MCP-Installationen, einschließlich Claude-Desktop- und Cursor-Konfigurationen, die dieses Paket mit einem lokalen Befehl starten, wie zum Beispiel:

npx -y @calypsohq/multimodal-rag-mcp-server

In diesem Setup läuft der MCP-Serverprozess auf Ihrem Rechner und kann Pfade lesen, die für dasselbe Benutzerkonto verfügbar sind. Übergeben Sie den lokalen Pfad direkt; der Server liest die Rohbytes und lädt sie über die Calypso-Upload-Session-URL hoch. Sie müssen lokale Dateien nicht base64-kodieren.

Verwenden Sie contentBase64 für gehostete oder entfernte MCP-Clients, einschließlich Smithery-gehosteter Server, Browser-/Cloud-Laufzeiten, generierter In-Memory-Inhalte und Agentencontainer. In diesen Umgebungen ist ein Pfad auf Ihrem Mac oder Ihrer Workstation für den MCP-Serverprozess nicht lesbar.

Wenn ein Pfad mit /mnt/user-data/uploads, /mnt/data, /mnt/attachments oder einem anderen gehosteten Sandbox-Präfix beginnt, senden Sie ihn nicht als filePath, es sei denn, dieser MCP-Server läuft in derselben Sandbox. Verwenden Sie stattdessen contentBase64 oder eine andere Inline-Byte-Quelle.

Verfügbare Tools

calypso-rag-agent

Direkter Zugriff auf den Calypso-RAG-Agenten.

Hinweise:

• Es leitet nicht automatisch an andere Personas oder Agenten weiter.

• Es erkennt beim Start automatisch die verfügbaren calypso-rag-agent-Varianten des API-Schlüssels.

• Verwenden Sie das optionale model-Argument, um eine benannte Variante wie calypso-rag-agent:pricing auszuwählen.

• Jede Modellvariante führt ihre eigene MCP-Konversationskette, sodass ein Wechsel der Varianten nicht den falschen Thread fortsetzt.

• Es verwendet POST /v1/responses statt POST /v1/chat/completions.

• Erste Turns erstellen eine benannte Konversation, und Folgeturns verketten mit previous_response_id.

• Optionale fileIds werden für retrieval-bezogene Fragen unterstützt. Neue Uploads sollten die dauerhaften Wissens-Upload-Tools verwenden und auf die Indizierung warten, bevor sie fragen.

• Verwenden Sie /new als Prompt, um die MCP-Konversation zurückzusetzen.

calypso-list-buckets

Listet Buckets für das Team auf, das mit dem konfigurierten Calypso-API-Schlüssel verbunden ist.

Hinweise:

• Verwendet GET /v1/knowledge/buckets.

• Akzeptiert kein team_id; Calypso leitet den Team-Bereich aus dem API-Schlüssel ab.

• Gibt Bucket-IDs, Slugs, Namen, Status, Mitgliederanzahl, Quellenanzahl und Bucket-Store-Bereitschaft zurück.

• Standardmäßig nur aktive Buckets. Übergeben Sie includeArchived: true, wenn Sie archivierte Buckets für Audits oder Bereinigungen benötigen.

• Verwenden Sie dies vor calypso-upload-file oder calypso-upload-files-batch, wenn Sie einen Ziel-Bucket auswählen müssen.

• calypso://rag-agent-models beantwortet, welche Buckets an jede RAG-Variante gebunden sind. calypso-list-buckets beantwortet, welche Buckets für das Team des API-Schlüssels existieren.

Beispiel:

{
  "includeArchived": false
}

calypso-get-file

Ruft Metadaten und Indizierungsstatus einer Wissensdatei anhand der Datei-ID ab.

Hinweise:

• Verwendet GET /v1/knowledge/files/{file_id}.

• Löst die undurchsichtigen fileIds aus calypso-list-buckets in Dateiname, MIME-Typ, Größe, Indizierungsstatus und Synchronisierungsstatus pro Bucket auf.

• Übergeben Sie verify: true, um gegen den Anbieter zu prüfen (?verify=gemini) – langsamer, aber maßgeblich, wenn ein Status veraltet aussieht.

Beispiel:

{
  "fileId": "file_123",
  "verify": true
}

calypso-create-bucket

Erstellt einen leeren Bucket für den Workflow „Erstellen und dann füllen“.

Hinweise:

• Verwendet POST /v1/knowledge/buckets (erfordert ein Backend mit diesem Endpunkt und die Fähigkeit knowledge:bucket:create auf dem API-Schlüssel).

• Der Server normalisiert den Slug; Kollisionen geben einen typisierten bucket_slug_exists-Fehler zurück.

• idempotencyKey-Wiederholungen geben den vorhandenen Bucket zurück, anstatt einen Fehler zu erzeugen.

• Uploads können Buckets weiterhin implizit über bucketSlugs + createMissingBuckets erstellen; dieses Tool dient zum Erstellen des Ziels zuerst.

Beispiel:

{
  "name": "Product docs",
  "slug": "product-docs",
  "idempotencyKey": "create-product-docs-1"
}

calypso-create-agent

Erstellt eine RAG-Agentenvariante, die an einen oder mehrere Buckets gebunden ist.

Hinweise:

• Verwendet POST /v1/rag-agent/agents (erfordert ein Backend mit diesem Endpunkt und die Fähigkeit rag:agent:create auf dem API-Schlüssel).

• Die Erfolgsantwort beginnt mit model – übergeben Sie sie direkt an calypso-rag-agent.

• Bucket-Bindungen werden serverseitig validiert: unbekannte oder archivierte Buckets geben bucket_not_found zurück; Agenten-ID-Kollisionen geben agent_id_exists zurück; das Agentenlimit des Plans gibt agent_limit_reached zurück.

• Das Erstellen eines Agenten aktualisiert den Modellkatalog und sendet MCP-tools/list_changed- und resources/list_changed-Benachrichtigungen, sodass die neue Variante ohne erneutes Verbinden verwendbar ist.

Beispiel:

{
  "agentId": "support",
  "name": "Support agent",
  "bucketSlugs": ["product-docs"],
  "idempotencyKey": "create-support-agent-1"
}

calypso-upload-file

Lädt eine Datei in den dauerhaften, bucket-gestützten Wissensspeicher und die Indizierungspipeline hoch.

Hinweise:

• Verwendet POST /v1/knowledge/files/upload-session, lädt Bytes direkt in den Speicher hoch und schließt dann mit POST /v1/knowledge/files/upload-session/{session_id}/finalize ab.

• Uploads verwenden JSON-Session-Anfragen plus signierte binäre PUTs, keine Multipart-Formular-Uploads.

• Gibt Datei- und Aufgabenmetadaten zurück, keine Chat-Anhang-file_id.

• Erfordert ein Bucket-Ziel über bucketIds, bucketSlugs oder bucket.

• Verwenden Sie filePath für lokale Claude-Desktop-/Cursor-MCP-Installationen, bei denen der Server den Pfad lesen kann. Verwenden Sie contentBase64 für gehostete oder entfernte MCP-Clients, die keine lokalen Pfade lesen können.

• Wenn ein Agent einen Pfad wie /mnt/user-data/uploads/file.pdf sieht, sollte er diesen nicht als filePath senden; er sollte die Dateibytes als contentBase64 senden.

• Unterstützt optionale title, tags, metadata und idempotencyKey.

• Leiten Sie Uploads mit bucketIds oder bucketSlugs in vorhandene Buckets oder verwenden Sie bucket als Abkürzung für einen einzelnen Slug.

• Übergeben Sie createMissingBuckets: true mit Bucket-Slugs, wenn Calypso fehlende Ziele während des Uploads erstellen soll.

• Kann optional warten, bis die Indizierung einen bereiten Zustand erreicht, bevor es zurückkehrt.

Beispiel:

{
  "filename": "handbook.pdf",
  "mimeType": "application/pdf",
  "filePath": "/Users/me/Documents/handbook.pdf",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "waitForIndexing": true
}

calypso-upload-files-batch

Lädt 1 bis 100 Dateien in einer Anfrage in den dauerhaften Wissensspeicher hoch.

Hinweise:

• Verwendet POST /v1/knowledge/files:batch/upload-session, lädt jedes akzeptierte Element direkt in den Speicher hoch und schließt dann mit POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize ab.

• Uploads verwenden JSON-Session-Anfragen plus signierte binäre PUTs, keine Multipart-Formular-Uploads.

• Erfordert batchIdempotencyKey; Calypso verwendet es, um die dauerhafte Batch-ID für Wiederholungen abzuleiten.

• Erfordert ein gemeinsames Bucket-Ziel über bucketIds, bucketSlugs oder bucket, es sei denn, jedes Element stellt sein eigenes Bucket-Ziel bereit.

• Unterstützt gemeinsame bucketIds, bucketSlugs, bucket- und createMissingBuckets-Standardwerte sowie Überschreibungen pro Element.

• Verwenden Sie pro Element filePath für lokale Claude-Desktop-/Cursor-MCP-Installationen, bei denen der Server jeden Pfad lesen kann. Verwenden Sie pro Element contentBase64 für gehostete oder entfernte MCP-Clients, die keine lokalen Pfade lesen können.

• Generiert Firestore-sichere client_file_id-Werte, wenn clientFileId weggelassen wird.

• accepted oder queued bedeutet, dass der Upload dauerhaft ist, nicht unbedingt abfragebereit. Verwenden Sie waitForBatchReady: true, um GET /v1/knowledge/batches/{batch_id}?include_items=true abzufragen.

• Untersuchen Sie den Status pro Element, bucketSyncStatus und bucketSync, um indizierte Inhalte von bucket-bereitem Retrieval zu unterscheiden.

Beispiel:

{
  "batchIdempotencyKey": "kb-seed-2026-06-04",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "items": [
    {
      "filename": "faq.txt",
      "mimeType": "text/plain",
      "filePath": "/Users/me/Documents/faq.txt"
    }
  ],
  "waitForBatchReady": true
}

Verfügbare Ressourcen

calypso://server-info

Schreibgeschützte Servermetadaten, einschließlich Paketversion, API-Basis-URL, Transport, Authentifizierungsmodell und verfügbare Fähigkeiten.

calypso://rag-agent-models

Schreibgeschützter Laufzeitkatalog der teambezogenen calypso-rag-agent-Modellvarianten, die aus dem konfigurierten API-Schlüssel erkannt wurden, einschließlich der aktiven buckets, bucket_ids und missing_bucket_ids jeder Variante. Wenn die Erkennung nicht verfügbar ist, fällt diese Ressource auf den Basis-calypso-rag-agent zurück.

calypso://buckets

Schreibgeschützte Laufzeitliste der Wissens-Buckets für das Team, das mit dem konfigurierten API-Schlüssel verbunden ist. Verwenden Sie sie, um Bucket-IDs/Slugs und Bucket-Store-Bereitschaft vor Uploads zu prüfen.

calypso://workflows

Ein kompakter Leitfaden zu den unterstützten RAG- und Datei-Upload-Workflows.

calypso://security

Operative Sicherheitshinweise zu API-Schlüsseln, lokalen Dateilesevorgängen, Uploads und Protokollierung.

Verfügbare Prompts

• calypso-question: Entwurf einer fundierten Wissensdatenbank-Frage für calypso-rag-agent

• calypso-ingestion: Vorbereitung eines dauerhaften Wissensspeicher-Uploads und einer Folgefrage

• calypso-reset-conversation: Starten eines sauberen RAG-Threads mit /new

Häufige Workflows (Kopieren/Einfügen)

Wissensabruf

• Ein Thema zusammenfassen:

  • Fassen Sie die Leitlinien der Wissensdatenbank für Kampagnengenehmigungen zusammen

• Eine spezifische Antwort anfordern:

  • Was sagt unsere Dokumentation über Indizierungswiederholungen?

• Zwei Konzepte vergleichen:

  • Vergleichen Sie Dateiindizierung mit Abrufausführung in der aktuellen Architektur

• Einen neuen Thread starten:

  • /new

Mehrfach-Turn-Folgefrage

• Eine vorherige Antwort verfeinern:

  • Konzentrieren Sie sich nur auf den Aufnahmepfad und ignorieren Sie den Abruf

• Quellen oder Begründung anfordern:

  • Erklären Sie, welche dokumentierten Komponenten beteiligt sind und warum

Wissensspeicher-Dateiablauf

• Buckets entdecken:

  • Rufen Sie calypso-list-buckets auf oder lesen Sie calypso://buckets, bevor Sie ein Ziel auswählen

• Dauerhaftes Wissen hochladen:

  • Rufen Sie calypso-upload-file mit der Dateinutzlast und optionalen title, tags oder metadata auf

  • Bevorzugen Sie filePath für lokale Claude-Desktop-/Cursor-MCP-Installationen; verwenden Sie contentBase64 für gehostete oder entfernte MCP-Clients, die keine lokalen Pfade lesen können

• Wissen in Buckets leiten:

  • Verwenden Sie bucket: "support-handbook" für ein Ziel, bucketSlugs für mehrere Slug-basierte Ziele oder bucketIds, wenn Sie bereits stabile Bucket-IDs haben

• Bucket-Ziele bei Bedarf erstellen:

  • Fügen Sie createMissingBuckets: true hinzu, wenn Sie eine Slug-basierte Bucket-Zuweisung verwenden und das Ziel möglicherweise noch nicht existiert

• Auf Indizierung warten:

  • Übergeben Sie waitForIndexing: true, wenn das Tool blockieren soll, bis die Wissensdatei indiziert ist

Wissensspeicher-Batch-Ablauf

• Viele dauerhafte Dateien hochladen:

  • Rufen Sie calypso-upload-files-batch mit items, batchIdempotencyKey und filePath pro Element für lokale MCP-Installationen auf; verwenden Sie contentBase64 pro Element für gehostete oder entfernte MCP-Clients

• Den Batch in Buckets leiten:

  • Setzen Sie gemeinsame bucket, bucketSlugs, bucketIds oder createMissingBuckets auf den Tool-Aufruf und überschreiben Sie pro Element nur bei Bedarf

• Auf Abfragebereitschaft warten:

  • Verwenden Sie waitForBatchReady: true und prüfen Sie den zurückgegebenen Elementstatus sowie die Bucket-Synchronisierungsfelder, bevor Sie frische Inhalte abfragen

Tipps

• Neu starten: Verwenden Sie /new, um die MCP-Konversation zurückzusetzen (neue conversation_id + geleerte Antwortkette).