Skip to main content
Use this page when Kyberis skill installation or MCP connection fails.

​
Node.js is too old

Both npm setup tools require Node.js 20 or newer with npx.
Upgrade Node.js if the version is below 20.

​
Connect Token is Invalid or Expired

Generate a new one-time connect token from API keys when setup reports:

​
Preview Config without Changing Files

Use --dry-run to print configuration guidance without updating local client files.
Use --json when you need machine-readable connection details.

​
Agent oes not Show Kyberis Tools

Check the client’s MCP config file: For Claude, rerun setup with --dry-run and verify the printed claude mcp add command. Restart or reload the agent after changing MCP configuration.

​
Agent does not Follow the Kyberis Workflow

Check whether the skill is installed:
Refresh installed skills with:

​
API Calls Return 401

401 usually means credentials are missing, invalid, or expired. Reconnect MCP with a fresh connect token, or mint a new bearer token from API key credentials.

​
API Calls Return 403

403 usually means the API key is missing required scopes. Check the response required_scopes field, then update or create an API key with those scopes from API keys.

​
API Calls Return 429

Back off and honor retry_after_seconds when present. Repeated bad authentication attempts can also trigger 429.

​
Report a Setup Issue

When asking for help, include:
  • agent client and version
  • setup command used, without secrets
  • request_id, run_id, and step_id from any failed Kyberis call
  • relevant error code and message