docs(local): mark Orbit Local MCP page as roadmap — orbit mcp serve does not exist yet
What
Rewrites docs/source/local/access/mcp.md as a roadmap page. orbit mcp serve and glab orbit local mcp serve do not exist in any released Orbit CLI version (verified against v0.74.0, released June 9). The page previously carried a Beta status badge and config examples that fail silently.
Changes
- Added a Not yet available warning callout at the top, linking !1377 (the implementation MR) for tracking.
- Removed the details/history blocks claiming the MCP server shipped as an experiment in 19.0 and beta in 19.1. It never shipped.
- Aligned the Planned interface section with !1377's actual shape:
run_sql,get_graph_schema,index, speaking raw DuckDB SQL over stdio. The old page contradicted itself (query_graphin the intro,run_sqlin the table). - Replaced the workaround examples with commands verified against v0.74.0:
glab orbit local sqland bareglab orbit local schema. Thequerysubcommand and the--ontologyflag were removed from the binary. - Marked inbound MCP mentions as planned in
_index.md,getting-started.md,cli.md, andglab.mdso no local page presents MCP as a working access path.
Review follow-up
- Duo flagged a
definitionsvsgl_definitiontable-name inconsistency: fixed, both examples now usegl_definition(verified against the binary). - Duo flagged the
glab.mdMCP section presenting the command as working: !1604 (merged) (merged) reframed that section as planned. This MR additionally fixes its stalequery_graphtool name.
Out of scope
v0.74.0 removed the query and compile subcommands and the schema --ontology/--query flags, which several local pages still document. Tracked separately (follow-up issue).
Validation
mise run lint:docs: the only vale errors are pre-existing on main (CONTRIBUTING.md and two dev docs), identical count with and without this change.- Workaround commands run against orbit v0.74.0 and a real local graph.
Closes #643 (closed)
Edited by Meg Corren