Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

StoryOS

✓ vom Dienst · storyos.dev

von StoryFunnelsVersion 0.1.2i★ 8 (Sterne des ganzen Repos)iComputer oder CloudOffizielle Website ↗
Name in der Registrydev.storyos/storyos

So installierst du es

What it does

Your StoryOS workspace (records, approvals and agents) for Claude, ChatGPT and any MCP client.

  • Connects Computer oder Cloud
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs STORYOS_TOKEN
  • Category Sonstiges

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-11-18

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte StoryOS. Folge https://mcp.popnx.com/i/storyos.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.storyos.dev) · ✓ Befehle geprüft am 19. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameStoryOS
    Remote MCP server URL · Adressehttps://mcp.storyos.dev/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsStoryOS

  4. Ausprobieren

    Nutze StoryOS und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es StoryOS nutzt, oder ein Werkzeug von StoryOS in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameStoryOS
    Connection · Adressehttps://mcp.storyos.dev/mcp
  3. StoryOS im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen StoryOS aus deinen Plugins wählen

  4. Ausprobieren

    Nutze StoryOS und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es StoryOS nutzt, oder ein Werkzeug von StoryOS in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user storyos https://mcp.storyos.dev/mcp
  3. /mcp in Claude Code eingeben

    StoryOS sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze StoryOS und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es StoryOS nutzt, oder ein Werkzeug von StoryOS in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze StoryOS und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es StoryOS nutzt, oder ein Werkzeug von StoryOS in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze StoryOS und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es StoryOS nutzt, oder ein Werkzeug von StoryOS in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.storyos.dev/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die StoryOS nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user storyos https://mcp.storyos.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "storyos": {
      "url": "https://mcp.storyos.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "storyos": {
      "type": "http",
      "url": "https://mcp.storyos.dev/mcp"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user storyos --env STORYOS_TOKEN=your-value -- npx -y @storyos/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "storyos": {
      "command": "npx",
      "args": [
        "-y",
        "@storyos/mcp"
      ],
      "env": {
        "STORYOS_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "storyos": {
      "command": "npx",
      "args": [
        "-y",
        "@storyos/mcp"
      ],
      "env": {
        "STORYOS_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "storyos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@storyos/mcp"
      ],
      "env": {
        "STORYOS_TOKEN": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • STORYOS_TOKEN geheim erforderlich env
    Persönliches API-Token von StoryOS (mn_pat_...), erstellt unter API tokens in StoryOS. Auf einen einzelnen Arbeitsbereich beschränkt.
    Englisches Original anzeigenStoryOS personal API token (mn_pat_...), created under API tokens in StoryOS. Scoped to one workspace.
  • STORYOS_URL env
    Basis-URL der StoryOS-API, zum Beispiel https://app.storyos.dev für die Cloud. Ist sie nicht gesetzt, verwendet der Server http://localhost:3001 (lokale Entwicklung).
    Englisches Original anzeigenBase URL of the StoryOS API, for example https://app.storyos.dev for the cloud. When unset the server uses http://localhost:3001 (local development).
  • STORYOS_MCP_PROFILE env
    Auf internal setzen, um zusätzlich das interne Tool-Profil bereitzustellen. Nicht setzen, um die Standard-Tools zu verwenden.
    Englisches Original anzeigenSet to internal to also expose the internal tool profile. Leave unset for the default tools.
  • WEB_URL env
    Basis-URL der StoryOS-Web-App, die zum Erstellen von Links in Tool-Ergebnissen verwendet wird. Ohne Angabe verwendet der Server http://localhost:3000
    Englisches Original anzeigenBase URL of the StoryOS web app, used to build links in tool results. When unset the server uses http://localhost:3000.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
8 (Sterne des ganzen Repos)
Dieses Repo enthält mehrere MCP-Einträge; die Sterne zählen in Ranglisten nur einmal
Downloads pro Wochei
8/Wo.
Bestätigte Domain
✓ storyos.dev
Lizenzi
Keine Lizenz angegeben
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.1.2
Kategoriei
Sonstiges
In der Registry veröffentlichti
19. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
19. Nov. 2026
Entwickler
StoryFunnels
Pakete
npm: @storyos/mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain storyos.dev bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ! Vorsicht

    Hat eine Lizenz

    GitHub konnte die Lizenzart nicht erkennen; öffne die Datei, um nachzusehen

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 547 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für @storyos/mcp@0.1.2

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 19. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/storyos.svg)](https://mcp.popnx.com/en/servers/storyos)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 91 % der anderen 20815 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 98 % der anderen 20815 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 60 % der anderen 20815 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist StoryOS sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: STORYOS_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.1.2) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

von koala73Weit verbreitet★ 90.934Aktualisiert vor 4 Tagen

Läuft in der Cloud✓ vom Dienst · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

von openstatusHQWeit verbreitet★ 9276Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

von JanDeDobbeleerWeit verbreitet★ 23.772 Sterne des ganzen ReposAktualisiert vor 31 Tagen

Läuft in der Cloud✓ vom Dienst · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

von Klavis-AIWachsend★ 5824Aktualisiert vor 14 Monaten

Läuft in der CloudRepo archiviert✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

von jitsucomWeit verbreitet★ 5136Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · jitsu.com
Im Vergleich mit ähnlichen
Dieser
StoryOS
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen4/54/44/44/41/44/4
LizenzNOASSERTIONAGPL-3.0AGPL-3.0MITApache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

@storyos/mcp

The StoryOS Model Context Protocol server — it exposes your StoryOS workspace to AI agents (Claude first; ChatGPT-compatible by design). It's a thin, stateless translator over the same /api/v1 the web app uses, so it can never drift from the product, and every response is scoped and validated server-side.

Design + roadmap: docs/product/mcp-plan.md. Ticket: MN-076.

Tools

Read

ToolWhat it does
get_startedOrientation + a workspace map; with section it returns one reference section (the filter cheat-sheet, icons, working notes, a tool's full notes).
list_workspacesWorkspaces the token can access.
list_databasesDatabases in a workspace.
describe_databaseA database's schema — exact api_names, types, options, relation targets: what a write is keyed by.
searchFull-text record search — turn a name into a real id.
query_recordsFilter / sort / paginate records (structured filter AST).
get_recordOne record in full, by uuid or public number.
get_linksWeb-app URLs for a database, its saved views, and/or a batch of records — without a round-trip per record.

Write (each returns the resulting record; each 422 is surfaced verbatim)

ToolWhat it does
create_recordCreate a record; values by api_name, selects accept the label, relations accept an array of target numbers/ids (linked in the same write).
update_recordMerge-update (null clears); record by uuid or public number. Naming a relation sets it to exactly those targets.
delete_recordTrash a record (restorable 30 days).
link_recordsLink a record to targets through a relation field. replace: true sets the link set to exactly targets — how you re-point or clear a one-to-many link.
unlink_recordsRemove specific links from a relation field (the relation itself stays).
add_commentPost a comment.
attach_fileAttach a file to a record — from a public url (fetched server-side) or inline content_base64; images get a thumbnail.
list_attachments / delete_attachmentList a record's files, or remove one by id.
run_buttonPress a button field, running its automation actions.

Build / schema (agents design the workspace, not just fill it)

ToolWhat it does
list_spaces / create_spaceList / create spaces (a space holds databases).
create_database / update_database / delete_databaseCreate, rename/move, or delete a database (delete needs confirm = name).
add_field / update_field / delete_field / change_field_typeManage fields; select options by label; convert a field's type (dry_run to preview).
create_view / update_view / delete_viewManage views; accepts group_by / card_fields / date fields plus filters + sorts.
create_relation / delete_relationLink two databases (one_to_many / many_to_many) — paired relation fields.
reorder_fields / reorder_viewsSet field / view order by name.

Skills (a workspace's saved skills, over MCP)

ToolWhat it does
list_skillsSkills visible to the caller — their own personal ones, plus every shared one (same visibility rule the in-app Skills list enforces).
run_skillResolve a skill's instructions/when_to_use by name or id, and record the run (last_run_at/last_run_status). The call invokes no model, so you — the connected agent — carry out the instructions against the inputs you pass; they're echoed back, not executed server-side (an agent set to "StoryOS AI" can have the skill named in its Skills field instead).

A workspace's skills are also exposed as native MCP resources and prompts, for clients that understand those primitives (not just tools):

  • Resources: a storyos-skill://{workspace}/{skill} template. resources/list returns one entry per visible skill (across every workspace the token can see); reading one returns the skill rendered as portable Markdown — the exact shape GET /skills/:id/export?format=markdown produces.
  • Prompts: one named prompt per visible skill (e.g. skill_weekly_status_digest), disambiguated by workspace name on a name collision. prompts/get returns the skill's instructions as a single user-role message, ready to paste into context.

Both are read-only and best-effort: a catalog fetch failing for one workspace never blanks out another's, and a failure registering them never breaks the tools (see server.ts).

Automations (build a complete workflow — admin-scoped, #334)

ToolWhat it does
list_automationsThe rules on a database — each with its trigger (field/relation names resolved), condition, actions, enabled state, failure streak and last-run status.
get_automationOne rule's full, editable definition — human-readable database/field/select names alongside their stable ids — ready to feed back into update_automation.
create_automationCreate a rule = trigger (record_created / record_updated / record_linked / schedule / webhook_received) + optional condition (a query_records-style filter) + 1–10 actions (set_values / create_record / add_comment / notify_user / update_linked / send_slack_message / send_webhook / send_email / http_request / run_agent). Field/relation/person names and select labels resolve server-side; the in-app validator (AutomationActionsService.validate) validates the whole rule, so a bad reference comes back as a structured error, not a 500.
update_automationRename, enable/disable, or replace a rule's trigger / condition / actions — every field optional, re-validated the same way.
delete_automationDelete a rule (requires confirm=true); reports the removed rule's name, trigger and action summary.

Automations are an admin surface (the API is @RequiresScope('admin') and creator-gated), so all five tools are advertised only to an admin-scoped token — a read- or write-scoped PAT never sees them and therefore can never mutate a rule. These tools call the same endpoints the in-app RuleEditor does; there is no parallel validation path. Diagnose why a rule did (or didn't) fire with get_runs.

Conveniences: query_records / get_record return select values as labels (not option ids) and rich_text as Markdown; create_record / update_record accept Markdown on a rich_text field (headings, lists, links, code → parsed to blocks) and select labels; create_record reports any unset template fields. get_record / query_records / create_record / update_record all include a url — a clickable web-app link for that record — so an agent never has to describe a manual navigation path.

Hosted Streamable HTTP (for ChatGPT / claude.ai connectors without a local process) is the remaining phase — it lands with the cloud tier (see MN-069).

Light enough for capped clients (ticket #1262)

Every listed tool description is billed on every request of every session, so the listing is kept small: under 60,000 characters in total and no description over 1,500 (src/tool-description-budget.test.ts enforces both against the live registry). A description in the source can be as long as the tool needs; tools/list carries a short lead plus [Full notes: get_started section "TOOL NOTES "] (the one canonical pointer format, double quotes), naming the exact section. get_started with no argument returns only the overview and an index of section names (under 10,000 characters, so no client truncates it); get_started with section set to a name from that index returns that one section: the full text of one tool (the long reference grammars are TOOL NOTES create_automation, install_pack, add_field, create_source), FILTERS, ICONS or WORKING NOTES. Matching is exact first, then case-insensitive; an unknown name returns a text answer listing the valid names. One 85,000-character result was the alternative, and a client that truncates a single result would have silently dropped the grammars. A section is only loaded when called, so it costs a capped client nothing up front (src/get-started-sections.test.ts checks every lead points at a section that exists). Where a lead must say something at call time, it is hand-written with a short: key next to the description. The agent-run profile (?profile=agent-run, the Runner's runs) offers get_started too, because parameter hints (FILTERS, ICONS) name it, but keeps every description WHOLE (WHOLE_DESCRIPTION_PROFILES in src/tool-profiles.ts): its 9 tools total about 3k characters, only ~1k more than leads would cost, and a lead is a round trip. src/profile-pointers.test.ts checks, for every profile, that a pointer names a tool the profile offers and a section its own index lists.

Maintainer-only tools (get_branch_name, get_pinned_tabs, set_pinned_tabs, get_dismissed_hints, set_dismissed_hints, list_icon_set; INTERNAL_TOOLS in src/tool-profiles.ts) are not offered on any customer connection. They appear with ?profile=internal over HTTP, or STORYOS_MCP_PROFILE=internal for a stdio server. The icon names list_icon_set used to return are in get_started section ICONS.

Descriptions state facts and references, never instructions (ticket #1288)

The Claude connector directory policy for tool metadata is that a description contains no instructions about model behaviour or other tools. A tool description says what the tool does, takes and returns; it may state a product fact and carry a neutral reference (See also: describe_database, [Full notes: get_started section "TOOL NOTES "]). Guidance for the model (look at the schema before writing, count with count_records, do not retry a held write, ...) lives in get_started section WORKING NOTES, which is a tool RESULT and not a description. src/tool-description-policy.test.ts enforces this against the live registry: every tool description and every parameter description, on every profile, is scanned for imperatives about another tool, sequencing words around a tool name, "read this before"-style calls to action and behavioural instructions (FORBIDDEN_PATTERNS), with self-tests and an explicit ALLOWED_PHRASES list that needs a reason per entry.

Why it doesn't hallucinate

  • Schema-first: describe_database gives exact api_names; you read before you write.
  • Validation-as-teacher: the API's typed error is surfaced verbatim, so a wrong field/value comes back naming the problem and the model self-corrects in one turn.
  • Structured filters, not a query language: nothing to invent; the op×type matrix ships in get_started section FILTERS.
  • Never invent ids: they come only from search / list_* / a prior result; names and slugs are accepted and resolved server-side.

Configure

1. Get a token — in StoryOS, sidebar → API tokens → create one for the workspace you want. Copy the mn_pat_… (shown once; scoped to that workspace). Without this, the server starts and immediately exits with fatal STORYOS_TOKEN is required — that's the config check working, not a broken install.

2a. Claude Code

claude mcp add storyos \

-e STORYOS_URL=https://app.storyos.dev \ -e STORYOS_TOKEN=mn_pat_xxx \ -- npx -y @storyos/mcp

2b. Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

{

"mcpServers": { "storyos": { "command": "npx", "args": ["-y", "@storyos/mcp"], "env": { "STORYOS_URL": "https://app.storyos.dev", "STORYOS_TOKEN": "mn_pat_xxx" } } } }

STORYOS_URL is https://app.storyos.dev for the cloud box, or

Nur der Anfang wird gezeigt; den Rest findest du im Repo