Skip to content

docs(mcp): MCP server guide#34

Open
rnv812 wants to merge 9 commits into
developfrom
feat/mcp-docs
Open

docs(mcp): MCP server guide#34
rnv812 wants to merge 9 commits into
developfrom
feat/mcp-docs

Conversation

@rnv812
Copy link
Copy Markdown
Member

@rnv812 rnv812 commented Jun 5, 2026

Summary

Documentation for the first-party MCP server (Eventum 2.6 flagship). Adds a new top-level MCP section plus the supporting CLI and config reference.

Pages

  • mcp/ section (sidebar, Bot icon):
    • index — overview: what it is, who it's for, "no model required".
    • how-it-works — the author → validate → preview loop (Mermaid), the two transports, and the safety model.
    • connect — step-by-step setup for Claude Code, Cursor, and Claude Desktop (stdio and HTTP).
    • tools — full reference: tools, resources, and prompts.
    • scenarios — worked examples (build from a description, simulate an incident, manage live, author offline).
  • core/cli/eventum-mcp$ eventum mcp command reference.
  • core/config/eventum-ymlserver.mcp.* keys added to the server reference.
  • Root nav + CLI nav updated.

Infrastructure

  • mdx-components.tsx registers Tabs/Tab (used by the connect guide; the MDX rules list them as available, but they weren't wired) and the Bot icon (overview hero).

Notes

  • End-user language, no engine jargon; matches sibling-page voice; internal links verified.
  • pnpm build green (588 pages).

🤖 Generated with Claude Code

@rnv812 rnv812 self-assigned this Jun 5, 2026
rnv812 added 7 commits June 6, 2026 00:17
- new tools: delete_generator_file, delete_generator, list_secrets,
  unregister_generator, get_generator_logs
- new resource: eventum://schema/generator
- generalized simulate_incident; new historical_backfill and live_ops
  prompts
- --keyring-cryptfile on the eventum mcp command; log/secret scrubbing
  and diagnostics in how-it-works and scenarios

🤖 Generated with [Claude Code](https://claude.com/claude-code)
- index/connect: list the full live tool set (unregister, logs); add
  the keyring / --keyring-cryptfile setup note
- scenarios: add a "diagnose a failing generator" walkthrough and name
  the bundled examples (CSV, linspace, timestamps)
- cross-link from secrets.mdx (list_secrets) and generator-yml.mdx
  (eventum://schema/generator resource)

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Higher-effort review follow-ups:
- eventum.yml: allow_write now lists unregister/delete and the
  read-only mode's live status/log reads (both were missing)
- scenarios: add a "backfill a past time range" walkthrough for the
  historical_backfill prompt, with a skip_past=false note so past-dated
  generators do not preview empty
- eventum mcp intro: complete the live-tool list; templating-reference
  blurb: add the state namespace

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant