> ## 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.

# Connect

> Point your AI assistant at the NeetoKB MCP server.

NeetoKB hosts the MCP server, so there is nothing to install or run locally. Add it to your assistant, then restart the assistant to make the `neetokb` tools available.

## Server details

|                    |                                                                     |
| ------------------ | ------------------------------------------------------------------- |
| **Endpoint**       | `https://connect.neetokb.com/mcp/messages`                          |
| **Transport**      | HTTP                                                                |
| **Authentication** | An OAuth grant, or an `Authorization: Bearer <your-api-key>` header |

## Which method does your assistant use?

The credential decides what the assistant can reach, so read [Authentication](/mcp/authentication) before you pick.

| Assistant   | Method  | Where it is configured                |
| ----------- | ------- | ------------------------------------- |
| Claude      | OAuth   | In-app, no config file                |
| ChatGPT     | OAuth   | In-app, no config file                |
| Claude Code | API key | `~/.claude.json`                      |
| Codex       | API key | `~/.codex/config.toml`                |
| Cursor      | API key | `~/.cursor/mcp.json`                  |
| Gemini CLI  | API key | `~/.gemini/settings.json`             |
| VS Code     | API key | `.vscode/mcp.json`                    |
| Windsurf    | API key | `~/.codeium/windsurf/mcp_config.json` |

## OAuth assistants

Nothing to copy: add the server URL and approve the sign-in prompt.

<Tabs>
  <Tab title="Claude">
    Open **Settings → Connectors → Add → Add custom connector**, give it a **Name** such as `NeetoKB`, and paste the server URL:

    ```
    https://connect.neetokb.com/mcp/messages
    ```

    Save it, then click **Connect** on the new connector and approve the NeetoKB sign-in prompt. Works on claude.ai, the Claude desktop app, and Cowork.
  </Tab>

  <Tab title="ChatGPT">
    Open **Settings → Security and login** and turn on **Developer mode**. Then go to **Plugins → Browse plugins → +  → New Plugin** and paste the server URL:

    ```
    https://connect.neetokb.com/mcp/messages
    ```

    Approve the NeetoKB sign-in prompt when it appears.
  </Tab>
</Tabs>

## API key assistants

Replace `YOUR_API_KEY` with your [NeetoKB API key](/mcp/authentication) in each example below.

<Warning>
  These files hold your API key in plain text, and some of them live inside a project you may share. Keep `.vscode/mcp.json` out of version control - add it to `.gitignore` before you commit - and never push any of these files to a public repository.
</Warning>

<Tabs>
  <Tab title="Claude Code">
    Add the server to `~/.claude.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetokb": {
          "type": "http",
          "url": "https://connect.neetokb.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Or add it from the terminal:

    ```bash theme={"system"}
    claude mcp add --transport http neetokb https://connect.neetokb.com/mcp/messages \
      --header "Authorization: Bearer YOUR_API_KEY"
    ```

    Save the file, then restart Claude Code.
  </Tab>

  <Tab title="Codex">
    Codex uses TOML, not JSON. Add the server to `~/.codex/config.toml`:

    ```toml theme={"system"}
    [mcp_servers.neetokb]
    url = "https://connect.neetokb.com/mcp/messages"
    bearer_token_env_var = "NEETOKB_API_KEY"
    ```

    `bearer_token_env_var` is the *name* of an environment variable, not the key itself. Export the key in your shell, then restart Codex:

    ```bash theme={"system"}
    export NEETOKB_API_KEY=your-api-key
    ```
  </Tab>

  <Tab title="Cursor">
    Create or edit `~/.cursor/mcp.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetokb": {
          "url": "https://connect.neetokb.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Save the file, then restart Cursor or reload its window from the command palette.
  </Tab>

  <Tab title="Gemini CLI">
    Add the server to `~/.gemini/settings.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetokb": {
          "httpUrl": "https://connect.neetokb.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Gemini CLI uses `httpUrl` for streamable HTTP servers; `url` means SSE and will not work here. Restart the CLI after saving.
  </Tab>

  <Tab title="VS Code">
    Create `.vscode/mcp.json` in your workspace:

    ```json theme={"system"}
    {
      "servers": {
        "neetokb": {
          "type": "http",
          "url": "https://connect.neetokb.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    This requires VS Code 1.99 or later and GitHub Copilot Chat's **Agent** mode. VS Code uses `servers`, not `mcpServers`. Because this file lives in your repository, add it to `.gitignore` before committing.
  </Tab>

  <Tab title="Windsurf">
    Edit `~/.codeium/windsurf/mcp_config.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetokb": {
          "serverUrl": "https://connect.neetokb.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Windsurf uses `serverUrl`, not `url`. Enable the server in **Settings → Cascade → MCP Servers**. Windsurf allows up to 100 MCP tools across all connected servers.
  </Tab>
</Tabs>

## Verify the connection

After your assistant reloads, confirm that `neetokb` is listed among its tools. Then try a prompt such as *"Search my NeetoKB articles for billing."* Find more in [Examples](/mcp/examples).