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

# Install the Veedcrawl MCP Server

> Install @veedcrawl/mcp globally and configure it in Claude Desktop, Claude Code, Cursor, or Windsurf with your API key.

The Veedcrawl MCP server is a Node.js binary published to npm. You install it once globally, then add a short config block to your AI host of choice. The server starts automatically when your host launches and registers all five Veedcrawl tools without any additional steps.

## Prerequisites

* **Node.js 18 or later** — the `veedcrawl-mcp` binary requires a modern Node.js runtime.
* **A Veedcrawl API key** — get one at [veedcrawl.com](https://veedcrawl.com).

## Install the package

```bash theme={null}
npm install -g @veedcrawl/mcp
```

This installs the `veedcrawl-mcp` command globally so any MCP host can find it by name.

## Configure your host

<Tabs>
  <Tab title="Claude Desktop">
    Open the Claude Desktop config file for your operating system:

    * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

    Add the `veedcrawl` entry inside `mcpServers`:

    ```json claude_desktop_config.json theme={null}
    {
      "mcpServers": {
        "veedcrawl": {
          "command": "veedcrawl-mcp",
          "env": {
            "VEEDCRAWL_API_KEY": "ma_your_key_here"
          }
        }
      }
    }
    ```

    Save the file, then restart Claude Desktop. The five Veedcrawl tools will appear automatically in the tools panel.
  </Tab>

  <Tab title="Claude Code">
    Run this command in your terminal, replacing the key with your own:

    ```bash theme={null}
    claude mcp add veedcrawl -- env VEEDCRAWL_API_KEY=ma_your_key_here veedcrawl-mcp
    ```

    Claude Code registers the server immediately — no restart required.
  </Tab>

  <Tab title="Cursor">
    Open or create `~/.cursor/mcp.json` and add the `veedcrawl` entry:

    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "veedcrawl": {
          "command": "veedcrawl-mcp",
          "env": {
            "VEEDCRAWL_API_KEY": "ma_your_key_here"
          }
        }
      }
    }
    ```

    Restart Cursor after saving.
  </Tab>

  <Tab title="Windsurf / Codeium">
    Add the `veedcrawl` entry to your Windsurf MCP config file:

    ```json theme={null}
    {
      "mcpServers": {
        "veedcrawl": {
          "command": "veedcrawl-mcp",
          "env": {
            "VEEDCRAWL_API_KEY": "ma_your_key_here"
          }
        }
      }
    }
    ```

    Restart Windsurf after saving.
  </Tab>
</Tabs>

## Environment variables

| Variable                      | Required | Default                     | Description                                                                                    |
| ----------------------------- | -------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
| `VEEDCRAWL_API_KEY`           | Yes      | —                           | Your Veedcrawl API key                                                                         |
| `VEEDCRAWL_BASE_URL`          | No       | `https://api.veedcrawl.com` | Override for self-hosted or staging environments                                               |
| `VEEDCRAWL_POLL_INTERVAL_MS`  | No       | `1500`                      | Milliseconds between job status polls for transcript and extraction jobs                       |
| `VEEDCRAWL_MAX_POLL_ATTEMPTS` | No       | `120`                       | Maximum poll attempts before a job times out (approximately 3 minutes at the default interval) |

<Note>
  `X_API_KEY` is accepted as an alternative to `VEEDCRAWL_API_KEY` if you are migrating from an earlier setup.
</Note>