Open-source help

Find the safe next step.

Troubleshoot setup, MCP connections, draft delivery, and Search Console evidence without expanding agent authority.

MCP & Connections

MCP returns 401

A 401 is normal until OAuth or a site-scoped token authenticates the client. Start from protected-resource discovery; do not work around it with a token in a prompt.

Open the related guide →

Content & Review

A draft revision conflicts

Reread the post and use its current expected_updated_at value. The conflict protects a newer edit from being overwritten.

Open the related guide →

CMS Draft Delivery

Preflight blocks CMS delivery

Review the current packet, resolve its blocker, keep the destination explicit, and retry only with the current version.

Open the related guide →

Why did my CMS draft not publish?

That is the intended boundary. BlogFactory creates CMS drafts for human review; it never live-publishes or deletes.

Open the related guide →

Self-hosting

What is the health and readiness difference?

Health confirms the API process responds. Readiness confirms required dependencies are available for work.

Open the related guide →

Can I deploy everything to Vercel, Netlify, or Railway?

Docker Compose is the canonical installation. Railway has a guided topology; Vercel is expert-only and Netlify is unsupported.

Open the related guide →

Does a community instance call blogfactory.io?

No. Your self-hosted app, data stores, and AI credentials remain in your infrastructure.

Open the related guide →

Getting Started

Is BlogFactory Cloud available?

No. Cloud is coming soon; there is no hosted signup, plan, billing, or SLA today.

Open the related guide →

Search Growth

Search Console does not show enough data

Reporting is delayed and limited. Use complete-day evidence and URL inspection or sitemaps for a narrow diagnosis.

Open the related guide →

Still stuck?

Share a reproducible product or documentation issue.

Do not include credentials, tokens, or private content in an issue.

Open GitHub Issues →