> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/scraping/serp-api/integration/mcp-integration/thordata-mcp-quick-start.md).

# ThorData MCP Quick Start

Run Thordata MCP Server locally, authenticate with an API token, connect an MCP client, and make your first search data request.

Start using Thordata MCP Server with quick setup steps for API keys, tool configuration, and your first search data request.

This document is intended for first-time users of <kbd>thordata-mcp</kbd>, aiming to complete the following in the fewest possible steps:\
1\. Launching the service locally\
2\. Connecting via an MCP Client

{% stepper %}
{% step %}
**Environmental Requirements**

Please confirm before starting:

* Installed [Golang](https://go.dev/dl/)
* You already have an available [Thordata SERP API Token](https://dashboard.thordata.com/serp-api/get-started)
  {% endstep %}

{% step %}
**Launch locally**

Run the following in the project root directory:

```
go mod tidy
go run .
```

After successful startup, the default service address is:

```
http://127.0.0.1:8800
```

{% endstep %}

{% step %}
**Authentication method**

The user token can be passed using either of the following two methods:

* Recommend: `Authorization: Bearer <user-token>`
* Compatible: `/{user-token}/mcp`
  {% endstep %}

{% step %}
**Integrating into the MCP Client**

**Method 1: Recommended – use the header.**

Suitable for MCP clients that support custom headers.

```
{
  "mcpServers": {
    "thordata": {
      "url": "http://127.0.0.1:8800/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_USER_TOKEN"
      }
    }
  }
}
```

**Method 2: Use a path token when headers are not supported.**

```
{
  "mcpServers": {
    "thordata": {
      "url": "http://127.0.0.1:8800/YOUR_USER_TOKEN/mcp"
    }
  }
}
```

{% endstep %}
{% endstepper %}