Zwei Fähigkeiten geben deinen Anwendungen und Agents Kontext. Das Brain ist, was deine Organisation weiß: Dokumente und Seiten, die man zitieren kann. Memory ist, woran sich die Plattform aus der Arbeit mit jemandem erinnert: kurze Notizen über eine Person, einen Agent oder eine Arbeit. Beide antworten auf dem Inference-Host deiner Region, unter /brain/v1/ und /memory/v1/, mit dem Key, den du schon für die Inferenz verwendest, und als MCP-Tools unter /mcp/.
Was du wann verwendest
| Brain | Memory | |
|---|---|---|
| Antwortet auf | Was weiß die Organisation? | Woran soll sich der Assistent bei dieser Person, diesem Agent oder dieser Arbeit erinnern? |
| Verbindlichkeit | Offiziell: eine Quelle der Wahrheit, die man zitiert. | Eine Erinnerung: nützlich, möglicherweise falsch oder veraltet, nie offiziell. |
| Geschrieben von | Quellen, die synchronisiert werden, und Personen, die Seiten besitzen. | Der Person oder dem Agent, während sie arbeiten. |
| Wer es sieht | Die Spaces ihrer Zielgruppe: die ganze Organisation oder ein Team. | Der Inhaber: eine Person, ein Agent, ein Team oder die Organisation. |
| Lebensdauer | Solange ihre Quelle besteht. | Aufbewahrung und Ablauf; ersetzt, wenn eine neuere Erinnerung sie ablöst; auf Wunsch gelöscht. |
| Abruf | Suche mit Zitaten und der Standardkontext eines Projekts. | Recall: ein kleines Profil und die für eine Anfrage relevantesten Erinnerungen. |
Keys und Berechtigungen
Verwende eine der beiden Arten von Keys aus Authentifizierung: einen Service-Account-Key für eine Anwendung oder einen Agent, oder den persönlichen Key einer Person. So nutzt ein Personal-Plan, der keine Service-Accounts hat, Memory und das Brain. Sende ihn wie bei der Inferenz. Der Key handelt mit den Rollen seines Inhabers, und die Berechtigung, die eine Operation braucht, entscheidet, was er darf.
| Berechtigung | Erlaubt |
|---|---|
brain.read | Die Spaces deiner Zielgruppe durchsuchen, lesen und durchblättern. Jedes Mitglied hat sie. |
brain.manage | Spaces und Quellen anlegen und löschen. Ein Team-Admin verwaltet auch die Spaces seines Teams. |
memory.use | Eigene Erinnerungen speichern, abrufen, bearbeiten und löschen, dazu die eigenen Einstellungen. Jedes Mitglied hat sie. |
memory.review | Über die Vorschläge der Teams entscheiden, die du prüfst. |
memory.manage | Über die Vorschläge der Organisation entscheiden, die Erinnerungen eines Mitglieds und eines Endnutzers löschen und die Memory-Richtlinie festlegen. |
memory.read | Die Memory-Richtlinie und die Nutzung lesen. |
Memory und das Brain antworten mit denselben Regeln auch auf dem Console-Host. Anwendungen und Agents verwenden den Inference-Host. Beide gehören zu deinem Plan: Eine Organisation ohne Brain-Kapazität antwortet mit 403 brain-disabled, und eine mit ausgeschaltetem Memory antwortet mit 403 memory-disabled.
Memory
Eine Erinnerung ist ein kurzer Text von 1 bis 8000 Zeichen mit einem Typ (preference, fact, decision, event, task-state oder lesson), einem Inhaber und optional einem project-Label. Jede Erinnerung ist eine Erinnerung im Wortsinn: nützlich, nie offiziell.
Eine Erinnerung speichern
Ohne owner gehört die Erinnerung dem Aufrufer. Gib {"kind": "team", "team": "<team>"} oder {"kind": "org"} an, um für ein Team oder die Organisation zu speichern, oder lass einen Service-Account seine eigene agent-Erinnerung führen. pinned nimmt sie in das Profil ihres Inhabers auf, das der Recall immer liefert; importance reicht von 1 bis 5; ttl_days verkürzt ihre Lebensdauer; supersedes ersetzt eine ältere Erinnerung desselben Inhabers und Projekts.
curl "https://api.eu.ccsio.ai/memory/v1/memories" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Answers in Spanish, short and direct.",
"type": "preference",
"pinned": true
}'{
"id": "m-01k9x4q2c8e6g0j3m5p7r9t1v2",
"owner": { "kind": "user", "id": "u-01k7yp2c9w4x5e8h3j6m0n1q2r", "team": null },
"project": null,
"session": null,
"type": "preference",
"content": "Answers in Spanish, short and direct.",
"importance": 3,
"pinned": true,
"provenance": { "source": "user", "trust": "user-confirmed" },
"state": "active",
"valid_from": "2026-11-12T10:15:00Z",
"superseded_by": null,
"superseded_at": null,
"expires_at": "2027-11-12T10:15:00Z",
"revision": 1,
"created_at": "2026-11-12T10:15:00Z",
"updated_at": "2026-11-12T10:15:00Z"
}Die schreibende Oberfläche bestimmt die Herkunft, nicht der Body: Eine Person schreibt, mit Session oder persönlichem Key, user-Erinnerungen, die sie bestätigt hat; ein Service-Account schreibt agent-Erinnerungen. Was ein Agent in den eigenen Bereich einer Person schreibt, ist nur aktiv, solange die Richtlinie der Organisation und die Einstellung dieser Person es beide erlauben; sonst wird es als Vorschlag gespeichert, und die Antwort ist trotzdem 201.
Abrufen (Recall)
Der Recall durchsucht alle Erinnerungen, die der Aufrufer lesen darf, nach Bedeutung und nach Wörtern zugleich, und liefert das Profil des Inhabers (die angehefteten Erinnerungen) und die besten Treffer, innerhalb von budget_tokens. Jeder Treffer sagt, ob die Vektorsuche, die Textsuche oder beide ihn gefunden haben. Es werden nur aktive Erinnerungen geliefert.
curl "https://api.eu.ccsio.ai/memory/v1/recall" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "How should I answer this user?", "limit": 5, "budget_tokens": 800}'{
"profile": [
{
"id": "m-01k9x4q2c8e6g0j3m5p7r9t1v2",
"owner": { "kind": "user", "id": "u-01k7yp2c9w4x5e8h3j6m0n1q2r", "team": null },
"project": null,
"session": null,
"type": "preference",
"content": "Answers in Spanish, short and direct.",
"importance": 3,
"pinned": true,
"provenance": { "source": "user", "trust": "user-confirmed" },
"state": "active",
"valid_from": "2026-11-12T10:15:00Z",
"superseded_by": null,
"superseded_at": null,
"expires_at": "2027-11-12T10:15:00Z",
"revision": 1,
"created_at": "2026-11-12T10:15:00Z",
"updated_at": "2026-11-12T10:15:00Z"
}
],
"profile_overflow": 0,
"memories": [
{
"memory": {
"id": "m-01k9x6d4f0h2k4n6q8s0v2x4z6",
"owner": { "kind": "user", "id": "u-01k7yp2c9w4x5e8h3j6m0n1q2r", "team": null },
"project": "billing",
"session": null,
"type": "decision",
"content": "We chose pgvector on 2026-11-09 because the data stays in one database.",
"importance": 4,
"pinned": false,
"provenance": { "source": "user", "trust": "user-confirmed" },
"state": "active",
"valid_from": "2026-11-10T08:00:00Z",
"superseded_by": null,
"superseded_at": null,
"expires_at": "2027-11-10T08:00:00Z",
"revision": 1,
"created_at": "2026-11-10T08:00:00Z",
"updated_at": "2026-11-10T08:00:00Z"
},
"score": 0.82,
"matched": "both"
}
],
"budget_used_tokens": 41,
"truncated": false
}Auflisten, bearbeiten und löschen
Eine Liste liefert Zusammenfassungen mit einem Ausschnitt von höchstens 200 Zeichen, die neuesten zuerst; den vollständigen Text bekommst du beim Lesen einer Erinnerung. Filtere nach owner, team, project, type, state und pinned. Um eine Erinnerung zu bearbeiten, die dir gehört, sende die expected_revision, die du gelesen hast: Hat sie zwischendurch jemand bearbeitet, ändert sich nichts und die Antwort ist 409 memory-revision-conflict. Nur eine aktive Erinnerung lässt sich bearbeiten, und jede Bearbeitung fügt eine Revision hinzu, die du auflisten kannst.
# Read the memory: the answer carries its revision.
curl "https://api.eu.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Edit it, naming the revision you read. Another edit in between refuses yours with 409 memory-revision-conflict.
curl -X PATCH "https://api.eu.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Answers in Spanish, short and direct, with an example.", "expected_revision": 1}'
# The revisions of a memory you own, newest first.
curl "https://api.eu.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2/revisions" \
-H "Authorization: Bearer $CCSIO_API_KEY"Die Erinnerung löscht ihr Inhaber, und für ein Mitglied tut es auch ein Admin mit memory.manage, ohne sie zu lesen. Das Löschen entfernt den Text und seinen Vektor in einer Transaktion und wird protokolliert; die Antwort ist eine Quittung und nie der Text. Das Löschen funktioniert auch, solange Memory pausiert ist, seine Kapazität überschritten oder es ausgeschaltet ist. Eine Person kann ihre Erinnerungen auch pausieren und exportieren, unter /memory/v1/me/settings und /memory/v1/exports.
# The text and its vector go in one transaction; the answer is a receipt and never the text.
curl -X POST "https://api.eu.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2/erase" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"id": "m-01k9x4q2c8e6g0j3m5p7r9t1v2", "state": "erased", "event_id": "...", "journal_head": {...}}Vorschläge und wer sie prüft
Eine Erinnerung wartet als Vorschlag, und der Recall liefert sie nie, wenn ein Agent in den Bereich einer Person schreibt, der das nicht erlaubt, oder wenn jemand in einen Team- oder Organisationsbereich schreibt, den die Richtlinie unter Prüfung stellt (beides ist standardmäßig so). Wer entscheidet:
- Ein persönlicher Vorschlag: nur sein Inhaber.
- Der Vorschlag eines Teams: die Prüfer des Teams, mit
memory.review. - Der Vorschlag der Organisation: Admins mit
memory.manage.
Annehmen macht die Erinnerung aktiv, optional mit einem korrigierten content. Ablehnen löscht sie und protokolliert das Löschen.
# The proposals you may decide on: yours, your teams' (memory.review) or the organization's (memory.manage).
curl "https://api.eu.ccsio.ai/memory/v1/proposals" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Accept one, as proposed or with a corrected text. It is served by recall from then on.
curl -X POST "https://api.eu.ccsio.ai/memory/v1/proposals/m-01k9x7f6h2k4n6q8s0v2x4z6b8/accept" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Releases go out on Thursdays, after the freeze."}'
# Reject one: its text and vector are erased and the erasure is journaled.
curl -X POST "https://api.eu.ccsio.ai/memory/v1/proposals/m-01k9x7f6h2k4n6q8s0v2x4z6b8/reject" \
-H "Authorization: Bearer $CCSIO_API_KEY"Die Endnutzer deiner Anwendung
Eine Anwendung, die eigene Kunden bedient, legt das, was ein Agent über jeden Einzelnen lernt, unter einem subject ab: einer undurchsichtigen ID von 1 bis 128 Zeichen, die du wählst, etwa deine Kunden-ID. Nur ein Service-Account kann es verwenden, für seine eigene agent-Erinnerung. Recall und Liste ohne subject liefern nie eine Erinnerung, die eines trägt, sodass eine Anwendung nie zwei ihrer Kunden vermischt. Der Key einer Person, der ein subject sendet, wird mit 400 invalid-request abgelehnt.
# With the key of a service account, in the name of one of your application's end users.
curl "https://api.eu.ccsio.ai/memory/v1/memories" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Asked about a refund for order 4411.", "type": "event", "subject": "customer-4711"}'
# Recall only what the agent remembers about that end user.
curl "https://api.eu.ccsio.ai/memory/v1/recall" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "open questions", "subject": "customer-4711"}'
# A privacy request: erase everything remembered about the end user (permission memory.manage).
curl -X POST "https://api.eu.ccsio.ai/memory/v1/subjects/customer-4711/erase" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"erased": 3, "event_id": "...", "journal_head": {...}}Ein Subject zu löschen ist die Antwort auf eine Datenschutzanfrage eines Endnutzers. Es braucht memory.manage, löscht alle Erinnerungen, die das Subject tragen, in einer Transaktion, ohne eine zu lesen, und antwortet mit erased und der Anzahl der Erinnerungen. Ein Subject ohne Erinnerungen ergibt ebenfalls 200 mit erased 0, sodass die Route nicht verrät, ob der Endnutzer je existierte. Das Subject wird nie in ein Log oder ein Sicherheitsereignis geschrieben.
Das Brain
Deine Organisation hat ein Brain, aufgeteilt in Spaces. Eine Quelle bringt Dokumente in einen Space, und eine Quelle mit Seiten bringt Seiten: Markdown-Wissen, das Personen verifiziert haben. Suche, Kontext und Durchblättern lesen beides.
Spaces
Ein Space ist die Einheit des Zugriffs: Alle in seiner Zielgruppe lesen alles darin. Ein organization-Space ist für jedes Mitglied; ein team-Space ist für die Mitglieder dieses Teams. Du siehst nur die Spaces deiner Zielgruppe, und ein Space, den du nicht sehen kannst, fällt bei einer Suche weg, nie als Fehler. Ein Space löscht beim Löschen seine Quellen, Dokumente und Seiten, deren Suchdaten und die gespeicherten Originale und gibt die Kapazität sofort frei.
# An organization space is readable by every member (permission brain.manage to create it).
curl "https://api.eu.ccsio.ai/brain/v1/spaces" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Support", "kind": "organization"}'
# A team space is readable by that team's members; a team admin may create it too.
curl "https://api.eu.ccsio.ai/brain/v1/spaces" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Platform runbooks", "kind": "team", "team": "platform"}'
# The spaces you can reach.
curl "https://api.eu.ccsio.ai/brain/v1/spaces" \
-H "Authorization: Bearer $CCSIO_API_KEY"Quellen
| Quelle | Was sie bringt | Aktualität |
|---|---|---|
| Eine Datei | Ein Dokument: Text, Markdown, CSV, JSON oder PDF, bis zu 50 MiB. Bilder werden nicht angenommen. | Sie ändert sich nicht. |
| Ein Link | Eine öffentliche Webseite, bis zu 20 MiB. | Wird alle sync_interval_minutes (5 bis 1440) oder über die Sync-Route erneut abgerufen. |
| Ein Repository | Ein Ordner eines Repositorys auf gitlab.com oder github.com. Gelesen werden die Dateien .md, .markdown, .txt, .csv, .json und .pdf, je bis zu 5 MiB, höchstens 5.000 Dateien. | Wird auf Änderungen geprüft und über die Sync-Route. |
Ein Repository hat zwei Modi. Im Modus documents werden seine Dateien als rohe Dokumente indexiert. Im Modus pages werden sie zu Brain-Seiten, und das Repository bleibt ihre Quelle der Wahrheit: Seiten ändern sich per Merge Request, und die API liest sie nur. Der Zugriffstoken eines privaten Repositorys wird verschlüsselt gespeichert und ist nur schreibbar: Die API gibt ihn nie zurück, nur ob einer gesetzt ist. Selbst betriebenes GitLab und GitHub Enterprise werden nicht unterstützt.
# A file: text, Markdown, CSV, JSON or PDF, up to 50 MiB. The space is a query parameter.
curl "https://api.eu.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-F file=@./refund-policy.pdf
# A public web page, fetched again every 6 hours.
curl "https://api.eu.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind": "url", "url": "https://example.com/help/refunds", "sync_interval_minutes": 360}'
# A folder of a GitLab or GitHub repository, indexed as documents. The token is optional for a public repository and is never returned.
curl "https://api.eu.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kind": "git",
"provider": "github",
"repository": "https://github.com/acme/handbook",
"branch": "main",
"path": "docs",
"mode": "documents",
"access_token": "<a token that can read the repository>"
}'
# The same kind of source in pages mode: the files become read-only Brain pages and the repository stays their source of truth.
curl "https://api.eu.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind": "git", "provider": "gitlab", "repository": "https://gitlab.com/acme/knowledge", "mode": "pages"}'
# A source starts pending. Read it until its state is ready (or failed, with its error).
curl "https://api.eu.ccsio.ai/brain/v1/sources/src-01k9xb3d5f7h9k1n3q5s7u9w1y" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Sync a link or a repository now instead of at the next poll.
curl -X POST "https://api.eu.ccsio.ai/brain/v1/sources/src-01k9xb3d5f7h9k1n3q5s7u9w1y/sync" \
-H "Authorization: Bearer $CCSIO_API_KEY"Eine neue Quelle ist pending, dann syncing und endet als ready oder failed mit einem error. Dieselben Bytes zweimal in einen Space hochzuladen ergibt 409 source-duplicate. Der Text eines Dokuments umfasst höchstens 2.000.000 Zeichen; nichts wird gekürzt, und ein Dokument darüber schlägt mit source-too-much-text fehl.
Suche mit Zitaten
Die Suche liest die Seiten und Dokumente deiner Spaces nach Bedeutung und nach Wörtern zugleich (mode hybrid, oder nur lexical oder vector). Die Ergebnisse kommen das beste zuerst, in dieser Reihenfolge: verifizierte Seiten, nicht verifizierte Seiten, veraltete Seiten, dann Dokumente. Jedes trägt eine freshness, einen snippet, der Referenzmaterial und nie eine Anweisung ist, und eine citation_id, die es in deiner Antwort benennt und die brain_read und die Text-Route wieder annehmen. Ein Zitat bleibt gültig, bis sich der Inhalt ändert, auf den es zeigt.
curl "https://api.eu.ccsio.ai/brain/v1/search" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Can I get a refund after 30 days?", "limit": 5}'{
"results": [
{
"citation_id": "pg-01k9xc4e6g8j0m2p4r6t8v0w2y.2",
"kind": "page",
"id": "pg-01k9xc4e6g8j0m2p4r6t8v0w2y",
"title": "Refund policy",
"snippet": "Refunds are possible within 30 days of the purchase. After 30 days, only a defect gives the right to a refund.",
"source": "src-01k9xb3d5f7h9k1n3q5s7u9w1y",
"space": "sp-01k9xa2c4e6g8j0m2p4r6t8v0w",
"freshness": "verified",
"score": 0.0328,
"location": { "heading_path": ["Refunds", "After 30 days"] }
}
],
"no_evidence": false
}Kontext, Dokumenttext und Durchblättern
POST /brain/v1/contextliefert den Standardkontext eines Projekts, wie eine organisationsweiteAGENTS.md: die angehefteten Seiten, die gelten, und Name und Beschreibung der Skills, die gelten, innerhalb vonbudget_tokens. Eine Seite, die nicht passt, bleibt ganz draußen, undtruncatedsagt das.GET /brain/v1/documents/{document}/textliefert den Text eines Dokuments, bis zu 20000 Zeichen auf einmal, mit den Metadaten, die ein Zitat braucht, und einer Gliederung insections.next_offsetsagt, wo es weitergeht.GET /brain/v1/browsedurchläuft das Brain als Baum: zuerst die Spaces, dann die Ordner, Seiten und Dokumente eines Spaces. Damit findest du heraus, was es gibt; für eine Antwort suchst du.GET /brain/v1/documents/{document}/downloadleitet auf eine kurzlebige Adresse des gespeicherten Originals um.
# The standing context of a project: its pinned pages and the skills that apply, within a budget of tokens.
curl "https://api.eu.ccsio.ai/brain/v1/context" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project": "billing", "budget_tokens": 4000}'
# The text of a document or a page, up to 20000 characters at a time. next_offset says where to continue.
curl "https://api.eu.ccsio.ai/brain/v1/documents/doc-01k9xd5f7h9k1n3q5s7u9w1y3a/text?offset=0" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Start at one section of the outline that an earlier answer returned.
curl -G "https://api.eu.ccsio.ai/brain/v1/documents/doc-01k9xd5f7h9k1n3q5s7u9w1y3a/text" \
--data-urlencode "section=Refunds > After 30 days" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Walk the Brain as a tree: the spaces, then a space's folders, pages and documents.
curl "https://api.eu.ccsio.ai/brain/v1/browse" \
-H "Authorization: Bearer $CCSIO_API_KEY"
curl -G "https://api.eu.ccsio.ai/brain/v1/browse" \
--data-urlencode "space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
--data-urlencode "path=policies" \
-H "Authorization: Bearer $CCSIO_API_KEY"MCP-Tools
Agents erreichen beides über den Endpoint aus der MCP-Anleitung, mit demselben Key und ohne Installation: Das Plattform-Element ccsio erscheint in jeder Organisation, die Memory oder das Brain hat, zählt nicht zu den MCP-Verbindungen des Plans und lässt sich weder bearbeiten noch auf Teams beschränken. Ein Client sieht jedes Tool als Alias, einen Bindestrich und den Tool-Namen:
| Tool | Was es tut |
|---|---|
ccsio-context_build | Hier beginnen: die angehefteten Seiten und Skills des Brains, das Memory-Profil und die relevanten Erinnerungen eines Projekts, in einem Paket innerhalb eines Budgets. |
ccsio-brain_context | Der Standardkontext eines Projekts. |
ccsio-brain_search | Zitierte Ausschnitte oder no_evidence. |
ccsio-brain_read | Der Text einer Seite, eines Dokuments oder eines Zitats. |
ccsio-brain_browse | Das Brain als Baum. |
ccsio-memory_save | Eine Erinnerung speichern. |
ccsio-memory_recall | Abrufen per Anfrage. |
ccsio-memory_get | Eine Erinnerung vollständig lesen. |
ccsio-memory_forget | Eine eigene Erinnerung löschen oder durch eine neue ersetzen. |
# After "initialize" (see the MCP guide), call a tool of the item ccsio by its name as a client sees it.
curl "https://api.eu.ccsio.ai/mcp/" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Mcp-Session-Id: <the id from initialize>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call",
"params": {"name": "ccsio-brain_search",
"arguments": {"query": "Can I get a refund after 30 days?"}}}'
curl "https://api.eu.ccsio.ai/mcp/" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Mcp-Session-Id: <the id from initialize>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc": "2.0", "id": 4, "method": "tools/call",
"params": {"name": "ccsio-memory_save",
"arguments": {"content": "In this repository we chose pgvector.", "type": "decision", "project": "billing"}}}'Die Tools nehmen dieselben Argumente wie die Routen und haben dieselben Berechtigungen: memory.use für Memory, brain.read für das Brain. Die Tool-Liste ist für jeden Aufrufer gleich; was ein Aufrufer darf, wird beim Aufruf des Tools entschieden, und eine Ablehnung ist ein Tool-Fehler, der den Code der Route trägt, etwa memory-scope-forbidden oder brain-disabled. Eine Erinnerung, die ein Tool speichert, schreibt ein Agent; sie folgt also den oben beschriebenen Regeln für Agent-Erinnerungen.
Limits des Plans
| Plan | Brain | Memory |
|---|---|---|
| Personal | 2 GB | 1 GB |
| Starter | 10 GB | 5 GB |
| Business | 20 GB | 10 GB |
| Advanced | 50 GB | 25 GB |
| Enterprise und Datacenter | Vertraglich | Vertraglich |
- Was zählt, ist das, was du hineingibst. Beim Brain die Bytes der gespeicherten Originale plus der Text der Seiten; bei Memory der Text der nicht gelöschten Erinnerungen. Vektoren, Indizes, extrahierter Text, Revisionen und das Lösch-Protokoll zählen nicht.
- Embeddings sind inklusive. Aufnahme, Suche und Recall erzeugen die Embeddings für dich, außerhalb deiner Anfragelimits und deines Guthabens.
- Bei 100 % wird die Aufnahme mit
409 brain-capacity-exceededund das Speichern neuer Erinnerungen mit409 memory-capacity-exceededabgelehnt. Lesen, Suchen, Abrufen und Löschen funktionieren weiter, und nichts wird gelöscht, um Platz zu schaffen. - Eine zusätzliche Brain-Kapazität wird zum Brain deines Plans addiert. Für Memory gibt es kein Add-on.
# What Memory holds against your plan (permission memory.read), and the same for the Brain (brain.read).
curl "https://api.eu.ccsio.ai/memory/v1/usage" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"used_bytes": 183204, "limit_bytes": 1073741824, "percent": 0.02, "memory_count": 412}
curl "https://api.eu.ccsio.ai/brain/v1/usage" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"used_bytes": 52428800, "limit_bytes": 2147483648, "percent": 2.44, "documents": 37,
# "sources": {"pending": 0, "syncing": 0, "ready": 5, "failed": 1}}Fehler, die du kennen solltest
Sie verwenden den Fehler-Umschlag der Plattform; verzweige nach code, wie in Fehler.
| Status und Code | Bedeutung | Was zu tun ist |
|---|---|---|
404 memory-not-enabled, 404 brain-not-enabled | Diese Region stellt die Fähigkeit nicht bereit. | Verwende eine Region, die sie bereitstellt, oder frag uns über ccsio.ai/contact. |
403 brain-disabled | Deine Organisation hat keine Brain-Kapazität. | Wähle einen Plan, der das Brain enthält. |
403 memory-disabled | Memory ist für deine Organisation ausgeschaltet. | Ein Admin schaltet es in der Memory-Richtlinie ein. |
403 memory-scope-forbidden | Du darfst in diesem Inhaberbereich nicht handeln, oder die Erinnerung gehört dir nicht. | Schreibe in deinen eigenen Bereich oder in ein Team, dem du angehörst. |
409 memory-paused | Die Person hat ihre Erinnerungen pausiert. | Überspringe den Aufruf; Lesen und Löschen funktionieren weiter. |
409 memory-revision-conflict | Die Erinnerung hat sich geändert, seit du sie gelesen hast. | Lies sie erneut und wiederhole die Bearbeitung. |
409 memory-capacity-exceeded, 409 brain-capacity-exceeded | Die Kapazität des Plans ist aufgebraucht. | Lösche Erinnerungen oder Quellen, oder füge Kapazität hinzu. Für dich wird nichts gelöscht. |
409 source-duplicate | Dieselben Bytes liegen schon in diesem Space. | Verwende das vorhandene Dokument. |
413 source-too-large, 415 source-type-not-supported | Die Datei ist größer als 50 MiB oder weder Text, Markdown, CSV, JSON noch PDF. | Teile die Datei oder konvertiere sie. |
422 source-repository-auth | Der Anbieter hat den Zugriffstoken abgelehnt, oder das Repository ist privat und es wurde keiner angegeben. | Sende einen Token, der das Repository lesen kann. |
{
"error": {
"code": "memory-revision-conflict",
"category": "client",
"message": "the memory changed since the revision you read",
"request_id": "01K7YQ4D8M2P6S9V3X5Z7B1C4F"
}
}Referenz
Jede Operation mit ihren Feldern, Berechtigungen und Fehlercodes steht in der API-Referenz: Memories, Memory recall, Memory proposals, Brain spaces, Brain sources, Brain documents, Brain pages und Brain search.