Document single-prompt Factory MCP onboarding

[harryalbert]

Summary

Adds a single copy-pasteable prompt to the existing Factory MCP page so a coding agent can install and authenticate Factory MCP using its own environment conventions, then hand off to the onboarding guidance published by the MCP server.

Related implementation:

• warpdotdev/warp-server#15592 — onboarding tools and create-time agent selection
• warpdotdev/warp-server#15608 — MCP-bundled onboarding skill and discovery breadcrumbs

Docs outline

• Extends the existing Connect and authenticate section; no new page or sidebar entry.
• Provides the exact prompt: “Set up a Warp Factory for me.”
• Explains the agent's bootstrap sequence: detect, connect, authenticate, verify tools, and begin server-driven onboarding.
• Keeps the existing Claude Code, JSON, Codex, and API-key setup instructions as manual fallbacks.
• Adds onboarding to the example prompts and documents the four new tools.
• Updates create_factory to mention repository, integration, and optional factory-agent selection.

Verified from codebase

• Production Factory MCP endpoint and browser OAuth flow.
• Production Dynamic Client Registration enablement and rate limiting.
• Server-published skill, onboarding resource, and initialize instructions.
• Team, forge, repository, agent-role, integration, creation, and verification flow.

Items needing review

• Confirm the copy-paste prompt wording.
• Confirm placement within the existing Factory MCP page.

Validation

• npm run build — passed.
• trunk was unavailable locally, so the Trunk wrapper was not run.

/cc @harryalbert

Warp conversation

Co-Authored-By: Warp agent@warp.dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Aug 20, 2026 6:07pm

[harryalbert]

• Document single-prompt Factory MCP onboarding #585 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.