omnigraph/docs/user
Ragnor Comerford c06343362a
docs(mcp): document the MCP surface, authoring controls, and skill (v0.8.0)
Document the per-graph MCP surface (POST /graphs/{id}/mcp, shipped in the
preceding commits and landing under v0.8.0) and the `.gq` authoring controls
that shape stored-query tools.

- New docs/user/operations/mcp.md: the client-facing guide — transport, tool
  catalog (built-ins + stored queries), projection modes, structured output,
  authorization (call-authoritative + list-relaxation), Host/Origin policy, the
  protocol-version contract.
- docs/user/operations/server.md: the /mcp endpoint + an "MCP surface" section;
  docs/user/index.md: a "Connect an MCP agent" pointer.
- docs/user/queries/index.md: an Annotations section — query @description /
  @instruction / @mcp(expose, tool_name) and per-parameter @description.
- AGENTS.md: topic-table row + MCP note on the HTTP-server capability row.
- docs/dev/testing.md: the omnigraph-mcp crate + server tests/mcp.rs.
- docs/dev/rfc-005 §D5: retire the "cluster = everything exposed" bridge —
  cluster mode honors source `@mcp(expose: …)`; presentation vs authorization
  split made explicit.
- skills/omnigraph: server-policy.md MCP section; stored-queries.md corrected
  (per-query controls now ship via @mcp, not "planned"); SKILL.md MCP triggers,
  Deep Dives row, version → 0.8.0.
- docs/releases/v0.8.0.md: the MCP surface + authoring-controls release notes.

Crate version manifests are deliberately NOT bumped — that is the v0.8.0
release-cut step; this lands on the feature branch.
2026-06-17 16:04:29 +02:00
..
branching docs(user): de-dev polish — strip internal scaffolding from user docs (Phase 3a) (#226) 2026-06-14 14:39:25 +03:00
cli [codex] fix RFC-011 follow-up regressions (#258) 2026-06-16 03:11:43 +03:00
clusters Merge remote-tracking branch 'origin/main' into ragnorc/shaping-config-integration 2026-06-16 04:13:00 +03:00
concepts docs(user): de-dev polish — strip internal scaffolding from user docs (Phase 3a) (#226) 2026-06-14 14:39:25 +03:00
mutations docs(user): split language/branching pages + add front-door pages (Phase 2) (#225) 2026-06-14 13:53:46 +03:00
operations docs(mcp): document the MCP surface, authoring controls, and skill (v0.8.0) 2026-06-17 16:04:29 +02:00
queries docs(mcp): document the MCP surface, authoring controls, and skill (v0.8.0) 2026-06-17 16:04:29 +02:00
reference Wire cluster embedding providers 2026-06-16 04:02:08 +03:00
schema docs(embeddings): @embed model arg + same-space validation (RFC-012 Phase 3-4) 2026-06-15 21:09:35 +02:00
search Merge remote-tracking branch 'origin/main' into ragnorc/shaping-config-integration 2026-06-16 04:13:00 +03:00
deployment.md docs: onboarding-first README + in-repo agent skill + drop RustFS script (#257) 2026-06-16 11:48:13 +02:00
index.md docs(mcp): document the MCP surface, authoring controls, and skill (v0.8.0) 2026-06-17 16:04:29 +02:00
install.md Add Windows release binaries (#127) 2026-05-30 14:23:40 +02:00
quickstart.md docs(readme): embedded quick-start run-through + trimmed Clients (#266) 2026-06-16 12:36:11 +02:00