> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetokb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Get the NeetoKB MCP server connected when the tools don't show up.

If the `neetokb` tools do not appear in your assistant, work through the checks for the way you connected. Each one corresponds to a [Connect](/mcp/connect) step.

## Every connection

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## OAuth assistants

These apply to **Claude** and **ChatGPT**.

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/mcp/authentication) instead.
  </Accordion>

  <Accordion title="ChatGPT: turn on Developer mode">
    Custom MCP plugins are only available with **Developer mode** enabled under **Settings → Security and login**.
  </Accordion>
</AccordionGroup>

## API key assistants

These apply to **Claude Code, Codex, Cursor, Gemini CLI, VS Code, and Windsurf**.

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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](https://help.neetokb.com/articles/api-keys). A key only works in the workspace where you created it.
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Article errors

<AccordionGroup>
  <Accordion title="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.
  </Accordion>
</AccordionGroup>

If that does not resolve the issue, contact the team through the [help center](https://help.neetokb.com) or at [support@neetokb.com](mailto:support@neetokb.com).