MCP Troubleshooting
Common recovery paths for OAuth, paid-plan, permission, approval, and async generation issues.
Paid plan required
If authorization returns paid_plan_required or plan_required, the account is authenticated but not on a paid MCP-enabled plan.
- Open the billing action URL in the error response.
- Upgrade the account or use a paid test account.
- Retry connector authorization after the account state refreshes.
Insufficient scope
If a tool returns insufficient_scope, the token is valid but the grant does not include the scopes required for that tool.
- Use mcp_permission_upgrade_request to summarize the scopes needed for the next tool or workflow.
- Reconnect DesignGen in the MCP client and approve the returned requestedScopes.
- Retry with the new access token rather than the old token.
Async generation
Image generation and carousel workflows are asynchronous. Repeating the initial write tool can create duplicate work.
- After designgen_generate (operation "image") returns generationId, use designgen_generation (operation "get") or designgen_generation (operation "list").
- After carousel generation starts, use designgen_carousel (operation "wait").
- Use the nextCall fields returned by DesignGen instead of asking the user to poll manually.