Troubleshooting

Solutions to common issues you might encounter when using Instructionly.

MCP Connection Issues

Problem: IDE can't connect to Instructionly

Solutions:

1. Verify your MCP Key ID and Secret are correct
2. Check the workspace slug matches your workspace
3. Restart your IDE after configuration changes
4. Run instructionly upgrade to get the latest version

Invalid or Expired Tokens

Problem: Getting token errors during authentication

Solutions:

1. Request a new verification/reset email
2. Check if the link has expired (usually 24 hours)
3. Clear browser cookies and try again

Credit Balance Issues

Problem: "Insufficient credits" errors

Solutions:

1. Check your billing account balance
2. Ensure the billing account is linked to your workspace
3. Purchase more credits or enable auto top-up

Workspace Access Denied

Problem: Can't access a workspace or feature

Solutions:

1. Verify you have the correct role (some features require Admin or Owner)
2. Check if your membership is still active
3. Contact the workspace owner for access

Recovery Code Not Working

Problem: Account recovery code is rejected

Solutions:

1. Ensure you're entering the code exactly as shown (case-sensitive)
2. Check for spaces or special characters
3. If regenerated, use the latest code
4. Contact support for manual recovery

CLI Installation Issues

Problem: Can't install or run the instructionly CLI

Solutions:

1. Ensure Node.js is installed (version 18+)
2. Try installing with admin/sudo privileges: sudo npm install -g instructionly
3. Clear npm cache: npm cache clean --force
4. Check your PATH includes npm global binaries

Skills Not Being Applied

Problem: Instructions aren't showing up in AI responses

Solutions:

1. Ensure the skill is enabled (not disabled)
2. Check that the action type matches your request
3. Verify you're using the /instructionly/ion command prefix
4. Restart your IDE to refresh the MCP connection