# `3.11.0` Host-Specific MCP Onramps

Status: Planned

## Goal

Remove the last translation step for major chat hosts by shipping exact,
copy-pasteable MCP setup guidance for the hosts users actually reach for.

## Public API Changes

No core runtime or workspace API change is required in this milestone.

The main user-visible additions are host-specific integration assets and docs:

- Claude setup should have a first-class maintained example
- Codex should have a first-class maintained example
- OpenCode should have a first-class maintained example
- the integrations docs should show the shortest working path for each host and
  the same recommended `workspace-core` profile

## Implementation Boundaries

- keep the underlying server command the same:
  `pyro mcp serve --profile workspace-core`
- treat host-specific configs as thin wrappers around the same MCP server
- cover both package-without-install and already-installed variants where that
  materially improves copy-paste adoption
- keep generic MCP config guidance, but stop forcing users of major hosts to
  translate it themselves

## Non-Goals

- no client-specific runtime behavior hidden behind host detection
- no broad matrix of every MCP-capable editor or agent host
- no divergence in terminology between host examples and the public contract

## Acceptance Scenarios

- a Claude user can copy one shipped example and connect without reading generic
  MCP docs first
- a Codex user can copy one shipped example or exact `codex mcp add ...` command
- an OpenCode user can copy one shipped config snippet without guessing its MCP
  schema shape
- the README and integrations docs point to those host-specific examples from
  the first integration pass

## Required Repo Updates

- new shipped config examples for Codex and OpenCode
- README, install docs, and integrations docs updated to point at the new host
  examples
- at least one short host-specific quickstart section or example command for
  each supported host family
- runnable or documented verification steps that prove the shipped examples stay
  current