MCP

MCP Troubleshooting

Common setup and runtime issues for Kognyt MCP.

npx: command not found

Install Node.js 18 or later. npx is included with Node.js.

Server not connecting

Check the config file path for your client and verify the JSON shape. Restart the client after changing the config.

Tools are missing

Some clients require a restart after config changes. Also verify the config key matches the client format:

  • mcpServers for Claude Code and Cursor
  • servers for VS Code Copilot

API key not working

Use KOGNYT_API_KEY, not a legacy variable name. Regenerate the key from kognyt.dev/dashboard/mcp if needed.

Getting HTTP 429

You hit the daily limit. Wait for the midnight UTC reset or use the Pro path.

Permission denied when running npx

On macOS or Linux, check shell and Node installation permissions. If you use nvm, confirm the intended Node version is active.