fabro/docs/internal
Bryan Helmkamp a19f6dd03a
feat(cli): add Fabro MCP server (#236)
## Summary

Adds a stdio-based Fabro MCP server so MCP clients can manage Fabro
workflow runs through the authenticated `fabro` CLI, without a separate
MCP auth flow.

## What Changed

- Adds `fabro mcp start`, `fabro mcp config`, and `fabro mcp init
<agent>` for launching and configuring the MCP server.
- Introduces a new `fabro-mcp-server` crate with run-management tools:
  - `fabro_run_create`
  - `fabro_run_search`
  - `fabro_run_interact`
  - `fabro_run_gather`
  - `fabro_run_events`
- Reuses the CLI's authenticated server connection behavior, including
OAuth refresh, dev-token/local-server handling, explicit server targets,
proxy behavior, and stdio env/cwd isolation.
- Moves shared run-manifest construction into `fabro-manifest` so CLI
runs and MCP-created runs use the same override semantics.
- Extends MCP client stdio support with configured cwd and exact
environment handling for reliable spawned-server tests.

---------

Co-authored-by: fabro-sh-0530[bot] <281434857+fabro-sh-0530[bot]@users.noreply.github.com>
Co-authored-by: Fabro <noreply@fabro.sh>
2026-05-11 18:20:50 -04:00
..
assets/brand docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
demo chore(demo): move simplify prompt to prompts/ alongside graphs 2026-04-30 08:35:48 -04:00
licenses docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
product refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00
cargo-target-apfs-churn-plan.md docs: commit plan 2026-04-28 09:46:52 -07:00
cli-workflow-coupling-audit.md refactor(types): remove stage status compatibility 2026-04-30 06:48:47 -04:00
error-handling-strategy.md docs: clarify chain-rendering boundary in error strategy 2026-05-04 11:28:28 -04:00
event-schema-competitive-analysis.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
events-strategy.md refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00
events.md refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00
fabro-event-schema-v2-concrete-shape.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
fabro-event-schema-v2-proposal.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
llm-client-resolution.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
logging-strategy.md feat(cli): polish foreground TTY logs 2026-05-06 15:31:25 -04:00
mcp-server-qa-test-plan.md feat(cli): add Fabro MCP server (#236) 2026-05-11 18:20:50 -04:00
plan-events-as-source-of-truth-follow-ups.md refactor(run-projection): use stage vocabulary 2026-05-01 19:56:22 -04:00
plan-events-as-source-of-truth.md Make git metadata sandbox-native 2026-04-27 21:43:15 -07:00
run-directory-keys.md refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00
server-secrets-strategy.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
slow-test-opportunities-2026-04-07.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
testing-strategy.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
updating-web-screenshots.md refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00