# MCP server be1st.ai

Audity webov priamo z tvojho AI asistenta: technológie, SEO, bezpečnosť, výkon, AI pripravenosť a viditeľnosť v odpovediach AI.

## Pripojenie

**URL:** `https://mcp.be1st.ai/mcp`

Autorizácia je cez OAuth, token si nikam neopisuješ: pri prvom volaní ťa asistent presmeruje na prihlásenie do be1st.ai.

### Claude Code

```bash
claude mcp add --transport http be1st https://mcp.be1st.ai/mcp
```

### Claude na webe a v aplikácii

Settings → Connectors → Add custom connector, vlož `https://mcp.be1st.ai/mcp` a potvrď prihlásenie.

### Codex

```bash
codex mcp add be1st --url https://mcp.be1st.ai/mcp
codex mcp login be1st
```

- Prvý príkaz server pridá, druhý otvorí prehliadač na prihlásenie.
- Alternatíva bez CLI: do `~/.codex/config.toml` pridaj `[mcp_servers.be1st]` s `url = "https://mcp.be1st.ai/mcp"`.

### Cursor

Súbor `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "be1st": {
      "url": "https://mcp.be1st.ai/mcp"
    }
  }
}
```

- Blok vlož do `.cursor/mcp.json` v projekte alebo do `~/.cursor/mcp.json` pre všetky projekty.
- Cursor server načíta sám; pri prvom volaní ťa vyzve na prihlásenie.

### OpenCode

Súbor `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "be1st": {
      "type": "remote",
      "url": "https://mcp.be1st.ai/mcp",
      "enabled": true
    }
  }
}
```

- Blok vlož do `opencode.json` v projekte (alebo do globálneho konfigu).
- OpenCode rozpozná OAuth sám a pri prvom volaní ťa prihlási.

### ChatGPT

- Settings → Connectors → Advanced → zapni Developer mode.
- Create → názov „be1st“, MCP server URL `https://mcp.be1st.ai/mcp`, autentifikácia OAuth.
- Prihlás sa účtom be1st.ai a v chate zapni konektor cez „+“.

### OpenClaw

Súbor `~/.openclaw/openclaw.json`:

```json
{
  "mcp": {
    "servers": {
      "be1st": {
        "url": "https://mcp.be1st.ai/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer b1_..."
        }
      }
    }
  }
}
```

- OpenClaw beží bez prehliadača, takže OAuth nepripadá do úvahy: použi API kľúč.
- Vytvor kľúč v sekcii nižšie a nahraď ním `b1_...`.
- Blok zlúč do `mcp.servers` v `~/.openclaw/openclaw.json` a reštartuj OpenClaw.

### Hermes Agent

Súbor `~/.hermes/config.yaml`:

```yaml
mcp_servers:
  be1st:
    url: https://mcp.be1st.ai/mcp
    headers:
      Authorization: Bearer b1_...
    timeout: 180
```

- Hermes beží ako služba bez prehliadača: prihlásenie ide cez API kľúč.
- Vytvor kľúč v sekcii nižšie a nahraď ním `b1_...`.
- Blok vlož pod `mcp_servers:` v `~/.hermes/config.yaml` a reštartuj Hermes.

### Iný klient

Server hovorí štandardným MCP protokolom (Streamable HTTP) s OAuth 2.1. Stačí zadať URL vyššie; klient, ktorý OAuth nevie, pošle API kľúč v hlavičke.

### Klient bez OAuth (API kľúč)

Kľúč `b1_...` si vygeneruješ v dashboarde v sekcii MCP (`/sk/dashboard/mcp`) a posielaš ho v hlavičke každej požiadavky:

```http
Authorization: Bearer b1_...
```

Kľúč sa zobrazí len raz a viaže sa na tvoj účet: volania cez neho vidno v dashboarde v štatistikách MCP.

## Čo to stojí

Cez MCP platia rovnaké ceny ako na webe. Čítanie dát je zadarmo, kredity strháva len spustený audit. MCP nie je viazané na žiadny plán: máš ho aj po registrácii s 20 kreditmi zadarmo.

Aktuálny sadzobník vráti `get_limits`.

## Nástroje (23)

### Spúšťanie auditov

| Nástroj | Kredity | Popis |
|---|---|---|
| `run_audit` | 2-9 | Spustí audit pre jednu alebo viac domén. Beží asynchrónne, typicky 1-3 minúty. |
| `get_audit_status` | - | Stav konkrétnych auditov. Toto volaj po spustení, kým nedobehne. |
| `list_audits` | - | Posledné audity používateľa. |
| `get_limits` | - | Zostatok kreditov, cena každého nástroja a stropy na dávku. Toto si zavolaj pred väčšou dávkou auditov. |

### Výsledky

| Nástroj | Kredity | Popis |
|---|---|---|
| `get_audit_summary` | - | Stručný prehľad: jeden riadok na doménu so skóre, tech stackom a tromi najväčšími problémami. |
| `get_site_issues` | - | Chyby jedného webu z posledného behu každého technického nástroja (SEO, bezpečnosť, výkon, AI readiness) ako zoznam úloh: problém, riešenie, priorita. Pridá zastarané a zraniteľné verzie technológií s cieľovou verziou a zoznamom zraniteľností. Povie aj, ktorý nástroj ešte nebežal. |
| `get_audit_report` | - | Kompletný report ako Markdown, ten istý dokument, aký dostane používateľ. |
| `get_screenshots` | - | Snímky obrazovky vo WebP. Berie domény aj UUID auditov. |
| `get_content` | - | Výstup nástroja AI SEO Content pre jednu alebo viac domén. |
| `get_visibility_gap` | - | Témy, v ktorých sa doména v odpovediach AI neobjavuje. |
| `get_competitor_content` | - | Mapa obsahu konkurenta z jeho sitemapy: sekcie, tempo publikovania, nové URL. |

### Weby, štítky a kolekcie

| Nástroj | Kredity | Popis |
|---|---|---|
| `search_sites` | - | Nájde weby podľa časti domény, témy, štítkov alebo kolekcie. Stránkované, účet môže mať tisíce domén. |
| `get_site` | - | Kompletný detail jedného webu v jednom volaní, vrátane toho, ktoré jazykové verzie webu boli auditované a ktoré nie. |
| `list_tags` | - | Všetky štítky používateľa. |
| `tag_sites` | - | Hromadná zmena štítkov na vybraných weboch. |
| `manage_tags` | - | Správa štítku naprieč všetkými webmi. |
| `list_collections` | - | Kolekcie používateľa: id, názov, typ, počet členov. |
| `collect_sites` | - | Pridanie alebo odobranie domén v kolekcii. |
| `manage_collections` | - | Správa kolekcie ako celku. |
| `get_collection_feed` | - | Čo je nové na weboch kolekcie: URL, ktoré pribudli v ich sitemapách. |

### Monitoring

| Nástroj | Kredity | Popis |
|---|---|---|
| `schedule_audits` | 2-9 | Opakovaný alebo jednorazový audit pre viac domén naraz, voliteľne pre konkrétnu jazykovú verziu webu (language=sk). Každý beh strhne kredity ako ručný audit. |
| `list_schedules` | - | Naplánované audity: doména, jazyk verzie, stav, frekvencia, najbližší beh. |
| `update_schedules` | - | Hromadná zmena plánov: pozastaviť, obnoviť, zrušiť, zmeniť frekvenciu. |