プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

StoryOS

✓ 提供元 · storyos.dev

作者:StoryFunnelsバージョン 0.1.2i★ 8 (リポジトリ全体のスター)iパソコンでもクラウドでも公式サイト ↗
レジストリ名dev.storyos/storyos

インストール方法

What it does

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

  • Connects パソコンでもクラウドでも
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs STORYOS_TOKEN
  • Category その他

この順位の理由

これは「AI につながるアプリ」タブにあり、スターを使わず次の順で並びます

1. Claude のコネクタディレクトリにあるいいえ
2. チームが実際に試したいいえ
3. タイのユーザー向けいいえ
4. スターを除いた利用状況20/100人気 0 · 新しさ 12 · 応答中 8 · ユーザーのいいね +0
5. 登録日2026-11-18

ユーザーのいいね: 0 · 順位に最大 5 点(1 人 1 点)加算。お金では買えません。

品質: 基本チェック 4/5 項目に合格(表示のみ、並び順には不使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

StoryOS をインストールして。https://mcp.popnx.com/i/storyos.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 4/5 合格 · 質問内容は提供元のサーバー(mcp.storyos.dev)を通ります · ✓ コマンド確認済み 2026年11月19日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前StoryOS
    Remote MCP server URL · アドレスhttps://mcp.storyos.dev/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsStoryOS

  4. 試してみる

    StoryOS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が StoryOS を使っていると言うか、回答に StoryOS のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前StoryOS
    Connection · アドレスhttps://mcp.storyos.dev/mcp
  3. チャットで StoryOS を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から StoryOS を選びます

  4. 試してみる

    StoryOS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が StoryOS を使っていると言うか、回答に StoryOS のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user storyos https://mcp.storyos.dev/mcp
  3. Claude Code で /mcp と入力

    StoryOS が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    StoryOS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が StoryOS を使っていると言うか、回答に StoryOS のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    StoryOS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が StoryOS を使っていると言うか、回答に StoryOS のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    StoryOS を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が StoryOS を使っていると言うか、回答に StoryOS のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.storyos.dev/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?StoryOS を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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"
    }
  }
}

パソコンにインストール

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"
      }
    }
  }
}

自分で入力する値

  • STORYOS_TOKEN 秘密 必須 env
    StoryOS の個人用 API トークン(mn_pat_...)。StoryOS の API tokens で作成されます。1 つのワークスペースに限定されます。
    英語の原文を見るStoryOS personal API token (mn_pat_...), created under API tokens in StoryOS. Scoped to one workspace.
  • STORYOS_URL env
    Base 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
    internal に設定すると、内部ツールプロファイルも公開されます。未設定の場合はデフォルトのツールが使用されます。
    英語の原文を見るSet to internal to also expose the internal tool profile. Leave unset for the default tools.
  • WEB_URL env
    StoryOS Webアプリのベース URL。ツールの結果内のリンクを作成するために使用されます。未設定の場合、サーバーは http://localhost:3000 を使用します
    英語の原文を見るBase URL of the StoryOS web app, used to build links in tool results. When unset the server uses http://localhost:3000.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

GitHubスターi
8 (リポジトリ全体のスター)
このリポジトリには複数の MCP があり、スターは順位で1件だけ数えます
週あたりのダウンロードi
8/週
確認済みドメイン
✓ storyos.dev
ライセンスi
ライセンスの記載なし
接続方法
パソコンでもクラウドでも
最新バージョンi
0.1.2
カテゴリi
その他
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月19日
最終確認
2026年11月19日
作者
StoryFunnels
パッケージ
npm: @storyos/mcp
ウェブサイト
storyos.dev
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

パソコン上で動かせるアプリ

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

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン storyos.dev で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ! 注意

    ライセンスがある

    GitHubがライセンスの種類を判別できませんでした。ファイルを開いて確認してください

  • ✓ 合格

    エンドポイントが応答する

    547ミリ秒で応答(HTTP 401)

  • ✓ 合格

    OAuthでサインイン

    OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

公開済みの脆弱性(OSV.dev)

OSV.dev に @storyos/mcp@0.1.2 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月19日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20815件のうち91%よりスターが多い
  • このカテゴリのほかの20815件のうち98%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20815件のうち60%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

StoryOSは安全ですか?

当てはまる基本チェック5項目のうち4項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:STORYOS_TOKEN

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.1.2)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

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

作者:koala73広く使われている★ 9.1万4 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

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

作者:openstatusHQ広く使われている★ 92762 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

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

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター31 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

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

作者:Klavis-AI成長中★ 582414 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

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

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
StoryOS
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック4/54/44/44/41/44/4
ライセンスNOASSERTIONAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@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

冒頭だけを表示しています。続きはリポジトリで読めます