Error Handling

Scope

This file keeps Notion-specific failure notes only. For canonical error taxonomy and OAuth recovery playbooks, use uxc skill:

• section: Failure handling and retry strategy
• file name in $uxc: references/error-handling.md

Notion-Specific Failure Notes

1. If first real call returns invalid_token:

2. Check for duplicate endpoint bindings (uxc auth binding list).

3. Confirm the binding that currently matches:

   • uxc auth binding match mcp.notion.com/mcp

4. If multiple candidates exist, verify each candidate with explicit credential:

   • uxc --auth <credential_id> mcp.notion.com/mcp <same_read_operation> ...

5. Remove only the binding(s) confirmed stale/invalid.

6. Retry the original read call that failed.

7. When notion-update-page signals deletion risk:

8. Do not retry automatically with permissive flags.

9. Show what would be deleted.

10. Ask for explicit confirmation before executing destructive change.