Skip to content

Error Types

This page lists common high-level error categories returned by the MCP server.

When to read this page: a call failed and you need to classify whether the problem is in parameters, permissions, or runtime behavior.

Related pages:

Error TypeMeaning
validation_errorInvalid parameters or missing required fields
permission_deniedNotebook permission does not allow the operation
api_errorSiYuan API returned an error
internal_errorMCP server internal failure
action_disabledTool or action is disabled in config

Triage Order

  1. Check required fields and path type
  2. Check notebook permission
  3. Check SiYuan connectivity and token configuration
  4. Check whether the action is disabled or gated

Released under the MIT License.