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

# Troubleshooting

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

If the `neetocal` tools don't appear in your assistant, work through these — each maps back to a step in [Connect](/mcp/connect).

<AccordionGroup>
  <Accordion title="Restart or reload after editing the config">
    MCP servers are read when the assistant starts. After saving the config, restart Claude Code, restart Cursor (or reload the window), or reload VS Code / Windsurf. The `neetocal` tools won't appear until the assistant re-reads the config.
  </Accordion>

  <Accordion title="Use the correct config key for your client">
    A single wrong key stops the server from loading. Windsurf and Antigravity use `serverUrl`; Claude Code, Cursor, and VS Code use `url`. VS Code nests the server under `servers`, while the others use `mcpServers`. Also make sure the JSON is valid — a trailing comma or missing brace will prevent it loading.
  </Accordion>

  <Accordion title="Check the endpoint and API key">
    The endpoint must be exactly `https://connect.neetocal.com/mcp/messages`, and the `Authorization` header must be `Bearer` followed by a valid NeetoCal API key. Generate or verify your key from the [API Keys article](https://help.neetocal.com/articles/api-keys); a key only works for the workspace it was created in.
  </Accordion>

  <Accordion title="VS Code: check the version and mode">
    The NeetoCal server needs VS Code 1.99 or later and is used from GitHub Copilot chat's **Agent** mode — it isn't available in Ask or Edit mode.
  </Accordion>

  <Accordion title="Windsurf: enable it and watch the tool limit">
    Enable the server under **Settings → Cascade → MCP Servers**. Windsurf allows up to 100 MCP tools across all connected servers, so disable servers you aren't using if you've hit that limit.
  </Accordion>
</AccordionGroup>

Still stuck? Reach the team through the [help center](https://help.neetocal.com) or at [support@neetocal.com](mailto:support@neetocal.com).