neetokb tools do not appear in your assistant, work through the checks for the way you connected. Each one corresponds to a Connect step.
Every connection
Restart or reload after adding the server
Restart or reload after adding the server
Assistants read their MCP servers when they start. After adding the server or saving the configuration, restart the assistant or reload its window. The
neetokb tools appear only after it reads the configuration again.Check the endpoint
Check the endpoint
The endpoint must be exactly
https://connect.neetokb.com/mcp/messages. A trailing slash or a missing /messages segment prevents the server from loading.OAuth assistants
These apply to Claude and ChatGPT.Finish the approval prompt
Finish the approval prompt
Adding the connector does not sign you in. Claude needs you to click Connect on the connector afterwards; ChatGPT shows the prompt when you first use the plugin. If you dismissed it, remove the server and add it again.
Confirm you approved the right workspace
Confirm you approved the right workspace
The grant is bound to the workspace you picked while approving it. If the assistant reports finding no articles, you may have approved a different NeetoKB workspace - remove the connector, add it again, and choose the intended one.
You only see what your account can see
You only see what your account can see
An OAuth grant runs under your NeetoKB permissions, so articles in categories you cannot access stay hidden and restricted actions are refused. That is expected. For workspace-wide reach, connect with an API key instead.
ChatGPT: turn on Developer mode
ChatGPT: turn on Developer mode
Custom MCP plugins are only available with Developer mode enabled under Settings → Security and login.
API key assistants
These apply to Claude Code, Codex, Cursor, Gemini CLI, VS Code, and Windsurf.Use the correct config key for your client
Use the correct config key for your client
One incorrect key prevents the server from loading. VS Code nests the server under
servers, while the others use mcpServers. Windsurf uses serverUrl and Gemini CLI uses httpUrl; the rest use url. Codex uses TOML rather than JSON. Also check that the file parses: a trailing comma or missing brace stops it loading.Check the API key itself
Check the API key itself
The
Authorization header must contain Bearer followed by a valid NeetoKB API key. Generate or verify your key in the API Keys article. A key only works in the workspace where you created it.Codex: export the environment variable
Codex: export the environment variable
bearer_token_env_var names an environment variable rather than holding the key. Confirm the variable is exported in the shell that launches Codex, and that the name matches the one in config.toml.VS Code: check the version and mode
VS Code: check the version and mode
The NeetoKB server requires VS Code 1.99 or later and works in GitHub Copilot Chat’s Agent mode. It is not available in Ask or Edit mode.
Windsurf: enable it and watch the tool limit
Windsurf: enable it and watch the tool limit
Enable the server in Settings → Cascade → MCP Servers. Windsurf allows up to 100 MCP tools across all connected servers. If you reach that limit, disable servers you are not using.
Article errors
An article tool reports the article is not published
An article tool reports the article is not published
Unlisted links exist only for published articles. Ask the assistant to publish the article first, then request the link again.