Control · MCP Connections
Create tokenSite: Plantwise Token: •••••••••••••••• Shown once. Copy it now.
Step 1 of 5
Create a site-scoped token
In Control → MCP Connections, create a token for one site. It is shown once and stored hashed.
Create a token, add the server, let an agent work to review.
Control · MCP Connections
Create tokenSite: Plantwise Token: •••••••••••••••• Shown once. Copy it now.
Step 1 of 5
In Control → MCP Connections, create a token for one site. It is shown once and stored hashed.
Terminal · your machine
$ export BLOGFACTORY_MCP_TOKEN=<paste token>Run ⏎
Set for this session. Nothing is sent anywhere.
Step 2 of 5
Store the token as BLOGFACTORY_MCP_TOKEN in the client environment. Never paste it into a prompt, an issue or a chat.
Terminal · your machine
$ codex mcp add blogfactory \
--url https://content.example.com/mcp \
--bearer-token-env-var BLOGFACTORY_MCP_TOKENRun ⏎Server “blogfactory” added.
Step 3 of 5
Add the endpoint to your client. This is the Codex form; other clients take the same URL and bearer token.
AI client · first session
Ask: what can you do here?Step 4 of 5
Start with whoami and list_sites, and read the live tool list instead of assuming one. Every call stays inside the site you approved.
AI client · playbook
Run playbook promptStep 5 of 5
Paste the playbook prompt. The agent researches, drafts, checks and fixes, asks before it spends your model budget, and stops at review.
Illustrative UI: a composite of the real screens with an invented example product. It is not a recording, and no real account or data is shown.
| You need | Who sets it | Without it |
|---|---|---|
| A site-scoped token | You, in Control → MCP Connections | The client gets a 401 and cannot call any tool. Where your instance has OAuth set up, the client signs in instead and is still limited to the site you approve. |
| A Brave Search API key | You: save your own key in Article Settings. A key set by the server operator is only a fallback | Research returns the question tree only, and the rank tracker cannot run checks. Brave has a free tier, and searches bill to your own Brave account. |
| Your own OpenRouter key | You, in the site settings | No draft is generated and the AI visibility check does not run. Everything else on the plan sheet still works. |
| A connected CMS | You, in Control → Integrations | Nothing is sent. The draft stays in BlogFactory and the review steps still work. |
Drafts only. BlogFactory only creates CMS drafts. It never publishes live on its own.
Every step above is in both editions. You approve each draft, and nothing publishes itself.