# Tracora MCP Server

Tracora'daki marka ve sorgu verilerinizi Claude Desktop, Claude Code veya Cursor gibi
MCP (Model Context Protocol) destekli asistanlara bağlar. İki araç sunar:

- **list_brands** — hesabınızdaki aktif markaları listeler
- **list_queries** — çalıştırılmış AI görünürlük sorgularını ve sonuçlarını listeler (marka/rakip geçti mi, atıf alınan kaynaklar)

Bu araçlar, mevcut [Tracora public API](https://tracora.ai/docs/api)'sinin ince bir sarmalayıcısıdır —
kendi API anahtarınızla kimlik doğrular, salt-okunurdur.

## Kurulum

```bash
cd mcp-server
npm install
npm run build
```

Bir API anahtarını Tracora → Ayarlar → API Anahtarları sayfasından oluşturun.

## Yapılandırma (Claude Desktop / Claude Code)

`claude_desktop_config.json` (veya Claude Code'un MCP ayar dosyası) içine ekleyin:

```json
{
  "mcpServers": {
    "tracora": {
      "command": "node",
      "args": ["/tam/yol/tracora-app/mcp-server/dist/index.js"],
      "env": {
        "TRACORA_API_KEY": "trk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

Kurulumdan sonra asistanınıza "Tracora'da hangi markalarım var?" veya "ChatGPT'de son
sorgularımda rakiplerim ne sıklıkla geçiyor?" gibi sorular sorabilirsiniz.