Troubleshooting

Start by identifying whether the problem is Studio access, an MCP connection, a draft conflict, validation, or media. Each has a different next step.

I cannot open Campaign Studio

Sign in at https://www.wayweaver.app/admin. Studio requires an active owner or administrator workspace membership. A player profile alone does not provide author access. If a session expired, sign in again; if you still cannot enter, ask the workspace owner to check your membership.

My MCP client cannot connect

Confirm the configured endpoint is https://www.wayweaver.app/api/mcp. The token must exist in the environment or secret store of the process running the client; setting it in a different terminal or after the client started may have no effect. Reconnect or restart, then call studio_get_context.

An HTTP 401 means the bearer token is missing, malformed, expired, or revoked. A browser request from a different Origin may receive 403. GET on /api/mcp returns 405 because the endpoint uses POST, so opening its URL in a browser is not a connection test.

If a client demands an OAuth browser login, use a client that accepts a manually supplied bearer token. OAuth is not available yet. An unsupported resources/list response is not a failure if tools/list and tool calls work.

A campaign is missing from MCP

Call studio_get_context and check the granted campaign scope. A selected-campaign connection only lists its allow-listed campaigns. Create a new connection with the needed scope if necessary. campaign:create needs entire-workspace scope.

A write reports a conflict

Another Studio or MCP write advanced the draft's editVersion. Read the campaign and affected mission again, reconcile the new state, and submit a new logical changeset with the latest version and a new request ID. Keep a request ID only when retrying the identical write after an uncertain response.

A mission cannot be playtested

Open the validation tray or call studio_validate_campaign. Resolve blocking findings such as unreachable nodes, broken references, missing transitions, or a route without an ending. Wait for pending Studio saves before creating a snapshot. An earlier snapshot becomes stale when the draft changes.

An image will not attach

Use JPEG, PNG, or WebP within the reported size limit. For MCP, finish the full prepare → raw PUT → complete sequence. The signed URL expires; request another if needed. A prepared upload is not a registered asset until completion succeeds. Do not try to supply an arbitrary object path.

A token was lost or exposed

Revoke its AI connection in Studio and create a new one. The plaintext of an existing token cannot be retrieved from the connection list.