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

# TalorData MCP Quick Start

This document is intended for first-time users of <kbd>talordata-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 [Talordata SERP API Token](https://dashboard.talordata.com/scraping/serp-api/api-token)

{% 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": {
    "talordata": {
      "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": {
    "talordata": {
      "url": "http://127.0.0.1:8800/YOUR_USER_TOKEN/mcp"
    }
  }
}
```

{% endstep %}
{% endstepper %}