An agent that is refused says why, in the refusal's own words. Find the code below. What each scope allows is in What Agents Can Do.
The Page Is Verified or Due for Review
| Code | The refusal says |
|---|---|
page_verified | "This page is verified, so an agent does not rewrite it. Suggest the change instead with suggest_edit, for a person to accept." |
page_review_due | "This page is due for review, so an agent does not rewrite it until a person has looked at it. Suggest the change instead with suggest_edit, for a person to accept." |
This is on purpose, and no setting changes it: a page a person vouched for changes only when a person accepts the change. Have the agent use suggest_edit (the CLI's suggest), then accept it under Edits Suggested by Agents. See Suggested Edits.
The Connection Does Not Hold the Write Scope
scope_needed, with "This connection holds the read and suggest scopes here, so it does not change the knowledgebase directly." A new connection reads and suggests. To let it write:
Open the AI Knowledge tab in the footer and find the agent under Connected Agents.
Press the More button (⋯) on its card, choose Allow Writing, and confirm.
Only an Editor can do this. The agent can then write pages that were never verified, and move pages, in this Knowledgebase only.
The Card Has No Menu
The card says why the connection cannot be allowed to write:
- "Its token is read-only, or its person only views this knowledgebase, so it cannot be allowed to write." Make a full API token in Settings and connect with that, or ask for the Editor or Participant role.
- "It acts for someone who is not an Editor here, so it cannot be allowed to write." Writing is an Editor's agent's alone. Ask an Editor for the Editor role, or have the agent suggest.
"This connection holds the read scope alone here" means the token is read-only: it can read and report questions, but not suggest. Connect with a full token.
The Agent Is Not Listed at All
An agent shows under Connected Agents once it has read or written this Knowledgebase. If it is missing:
- Check it is connected to this Knowledgebase's server:
https://mcp.liveknowledge.app/mcp. See Connecting an Agent. - A Knowledgebase kept Offline is in your browser only, so no agent can reach it.
- A card stays for 30 days after the agent was last seen.
Was this article helpful?
Still need help?
Try Troubleshooting, or tell us what you were trying to do.