Skip to content

Document single-prompt Factory MCP onboarding - #585

Open
harryalbert wants to merge 7 commits into
mainfrom
harry/docs-agent-driven-factory-onboarding
Open

Document single-prompt Factory MCP onboarding#585
harryalbert wants to merge 7 commits into
mainfrom
harry/docs-agent-driven-factory-onboarding

Conversation

@harryalbert

@harryalbert harryalbert commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

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

vercel Bot commented Aug 20, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 21, 2026 7:30pm

Request Review

@cla-bot cla-bot Bot added the cla-signed label Aug 20, 2026

Copy link
Copy Markdown
Contributor Author

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

harryalbert and others added 6 commits August 21, 2026 13:52
Add a copy-pasteable agent prompt that bootstraps Factory MCP installation and hands onboarding to the guidance published by the server. Update the feature summary, onboarding examples, and tool reference for factory creation.

Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
Co-Authored-By: Warp <agent@warp.dev>
@harryalbert
harryalbert force-pushed the harry/docs-agent-driven-factory-onboarding branch from fd49ca5 to 89a7d80 Compare August 21, 2026 17:52
@harryalbert
harryalbert marked this pull request as ready for review August 21, 2026 17:52
@warp-for-oss

warp-for-oss Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

@harryalbert

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@warp-for-oss warp-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR updates the Factory MCP documentation with agent-driven setup guidance, onboarding tool descriptions, and revised authentication guidance. The new flow is useful, but a few changed lines conflict with docs terminology and the linked API-key reference.

Concerns

  • The central prompt uses Warp Factory for an individual factory, which conflicts with the Warp Factories terminology rule and is repeated in the examples.
  • The API-key fallback introduces Team API key, but the linked reference defines the supported key types as personal and agent API keys.
  • The new tool-reference rows capitalize Factory where the docs style guide treats it as a lowercase common noun.

Verdict

Found: 0 critical, 3 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Comment thread src/content/docs/factories/factory-mcp.mdx Outdated
Comment thread src/content/docs/factories/factory-mcp.mdx Outdated
Comment thread src/content/docs/factories/factory-mcp.mdx Outdated
Comment thread src/content/docs/factories/factory-mcp.mdx Outdated
Comment thread src/content/docs/factories/factory-mcp.mdx Outdated
2. If it is not available, identify the coding environment and add `https://app.warp.dev/api/v1/mcp/factory` using that client's current MCP configuration mechanism.
3. Open the browser-based Warp authorization flow, where you can log in or create a Warp account.
4. Verify the Factory MCP tools are available.
5. Use the onboarding guidance published by Factory MCP to create or join your first team conversationally, complete browser-based Stripe funding if required, and select repositories, factory agents, and optional integrations before creating the factory.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

might just be some internal implementation details we don't need to expose

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah good call

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

instead of removing these entirely though, I added them to a new AgentOnly component that doesn't expose the text to human readers but will expose to agent readers who download the .md. That way the prompt can be really clean and this page can have the info the agent needs, but we don't need to make it messy.

Does that seem reasonable?

Comment thread src/content/docs/factories/factory-mcp.mdx Outdated

@hongyi-chen hongyi-chen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for putting this tgt! we can make it a bit more brief and abstract away some of the implementation details of the setup agent

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants