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

# MCP Server Installation

> Install and configure the Anysite MCP Server

## Overview

The Anysite MCP (Model Context Protocol) Server provides AI tools with direct access to LinkedIn, Instagram, Reddit, and other social media data extraction capabilities.

## Prerequisites

* Python 3.8 or higher
* Anysite API account and credentials
* Compatible AI client (Claude Desktop, Cursor, Windsurf)

## Installation

<Steps>
  <Step title="Clone Repository">
    ```bash theme={null}
    git clone https://github.com/horizondatawave/hdw-mcp-server.git
    cd hdw-mcp-server
    ```
  </Step>

  <Step title="Get API Credentials">
    1. Visit [anysite.io](https://anysite.io)
    2. Create your account and log in
    3. Navigate to account settings
    4. Generate your API credentials:
       * `HDW_ACCESS_TOKEN`: Your API access token
       * `HDW_ACCOUNT_ID`: Your account identifier (optional)
  </Step>

  <Step title="Configure Environment">
    Create a `.env` file or set environment variables:

    ```bash theme={null}
    export HDW_ACCESS_TOKEN="your_access_token_here"
    export HDW_ACCOUNT_ID="your_account_id_here"
    ```
  </Step>
</Steps>

## Client Configuration

### Claude Desktop

Add this configuration to your Claude Desktop config file:

<Tabs>
  <Tab title="macOS">
    Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "hdw-mcp-server": {
          "command": "python",
          "args": ["/path/to/hdw-mcp-server/main.py"],
          "env": {
            "HDW_ACCESS_TOKEN": "your_access_token_here",
            "HDW_ACCOUNT_ID": "your_account_id_here"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windows">
    Edit `%APPDATA%\Claude\claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "hdw-mcp-server": {
          "command": "python",
          "args": ["C:\\path\\to\\hdw-mcp-server\\main.py"],
          "env": {
            "HDW_ACCESS_TOKEN": "your_access_token_here",
            "HDW_ACCOUNT_ID": "your_account_id_here"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

### Cursor

Add to your Cursor settings:

```json theme={null}
{
  "mcp.servers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["/path/to/hdw-mcp-server/main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}
```

### Windsurf

Configure in your Windsurf settings:

```json theme={null}
{
  "mcpServers": {
    "hdw-mcp-server": {
      "command": "python",
      "args": ["/path/to/hdw-mcp-server/main.py"],
      "env": {
        "HDW_ACCESS_TOKEN": "your_access_token_here",
        "HDW_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}
```

## Verification

After installation, restart your AI client and verify the MCP server is working:

1. Open a new conversation in your AI client
2. Ask: "What MCP tools do you have available?"
3. You should see Anysite tools listed

<Note>
  Make sure to replace `/path/to/hdw-mcp-server/` with the actual path where you cloned the repository.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP server not appearing in AI client">
    * Check that the file path in your configuration is correct
    * Verify that Python is accessible from the command line
    * Ensure your credentials are properly set in the environment variables
    * Restart your AI client after making configuration changes
  </Accordion>

  <Accordion title="Authentication errors">
    * Verify your `HDW_ACCESS_TOKEN` and `HDW_ACCOUNT_ID` are correct
    * Check that your Anysite account is active
    * Ensure you have API access permissions
  </Accordion>

  <Accordion title="Python path issues">
    * Use the full path to your Python executable
    * If using a virtual environment, use the Python path from that environment
    * On Windows, use forward slashes or double backslashes in paths
  </Accordion>
</AccordionGroup>

## Next Steps

* [Configure the MCP Server](/mcp-server/configuration)
* [Explore Available Tools](/mcp-server/tools)
* [View Usage Examples](/mcp-server/examples)