Serverul MCP Seenly

Seenly are un server MCP (Model Context Protocol) oficial — standardul prin care asistenții AI (Claude, Cursor, VS Code și alții) se conectează la surse de date externe. Odată conectat, îți poți întreba asistentul AI, în limbaj natural, orice despre vizibilitatea brandului tău în ChatGPT, Gemini și Perplexity — iar el răspunde cu datele reale, live, din contul tău Seenly.

Ce poți întreba

  • „Cum a evoluat vizibilitatea brandului meu în AI în ultimele 30 de zile?"
  • „Cine mă depășește în răspunsurile AI și cu cât?"
  • „Ce surse citează ChatGPT pe temele mele? Unde ar trebui să fac outreach?"
  • „Compară vizibilitatea celor două branduri ale mele pe ultimele 90 de zile."
  • „Generează-mi linkul raportului de client pentru brandul X."

Asistentul tău alege singur tool-ul potrivit, trage datele și le interpretează.

Detalii de conectare

| | | |---|---| | URL server | https://app.seenly.ai/api/mcp | | Transport | Streamable HTTP (stateless) | | Autentificare | Cheie API ca Bearer token (header Authorization) | | Acces | Read-only, scopat strict la echipele tale | | Limită | 120 cereri/minut |

Cheia API se generează din Settings → API în contul tău Seenly (disponibil pe planurile cu acces API). Aceeași cheie merge și pe API-ul REST v1.

Configurare per client

Claude Code (terminal)

O singură comandă:

claude mcp add --transport http seenly https://app.seenly.ai/api/mcp --header "Authorization: Bearer CHEIA_TA"

Apoi deschide claude și întreabă direct: „ce branduri am în Seenly?"

Cursor

În ~/.cursor/mcp.json (sau .cursor/mcp.json în proiect):

{
  "mcpServers": {
    "seenly": {
      "url": "https://app.seenly.ai/api/mcp",
      "headers": { "Authorization": "Bearer CHEIA_TA" }
    }
  }
}

Claude Desktop / alți clienți MCP

Orice client care suportă servere MCP remote (transport Streamable HTTP) cu headere custom funcționează cu aceeași configurație: URL-ul serverului + headerul Authorization: Bearer CHEIA_TA. În Claude Desktop, adaugă serverul din Settings → Connectors (sau echivalentul din versiunea ta).

Tool-urile disponibile

Serverul acoperă întreaga platformă — 14 tool-uri read-only:

| Tool | Ce returnează | Parametri | |---|---|---| | list_brands | Brandurile (proiectele) accesibile cheii tale: id, nume, domeniu | — | | get_visibility_scores | Seria zilnică: scor vizibilitate AI + Share of Voice | brand_id, days (7/14/30/90) | | get_leaderboard | Tu vs fiecare competitor aprobat (medii pe perioadă, sortat) | brand_id, days | | get_platform_performance | Vizibilitate per motor AI (ChatGPT, Gemini, Perplexity...) — unde ești slab/puternic | brand_id, days | | get_prompts_performance | Per prompt monitorizat: rulări, apariții, vizibilitate %, poziție medie | brand_id, days | | get_recent_answers | Ultimele răspunsuri AI: dată, platformă, prompt, brand menționat + poziție | brand_id, days, limit | | get_top_sources | Top domenii citate de AI pe prompturile tale (citări + URL-uri unice) | brand_id, days, limit | | get_source_gaps | „Ținte hot": domenii citate unde apar competitorii dar tu NU — ținte de outreach | brand_id, days, limit | | get_boost_actions | Planul de acțiuni Boost + lift-ul măsurat de vizibilitate după fiecare fix | brand_id | | get_aio_eligibility | Eligibilitatea paginilor pentru Google AI Overview (worst-first, cu trend) | brand_id | | get_bot_traffic | Vizitele crawlerelor AI pe site (GPTBot, ClaudeBot...) — cere Cloudflare conectat | brand_id, days | | get_traffic_overview | Sesiuni GA4 venite din AI (pe sursă) + click-uri/afișări Google (GSC) | brand_id, days | | get_shopping_products | AI Shopping: produsele recomandate de AI (vizibilitate, win rate, prețuri citate) | brand_id, days, view | | get_client_report_link | Linkul public, semnat, al raportului de Vizibilitate AI (white-label) | brand_id, days |

Fluxul tipic: asistentul cheamă întâi list_brands ca să afle ID-urile, apoi tool-urile de date.

Workflow-uri pre-construite (MCP Prompts)

Serverul expune și prompts — analize gata scrise pe care le invoci direct din clientul tău MCP (în Claude Code apar la /mcp__seenly__...):

| Prompt | Ce face | |---|---| | monthly_visibility_review | Analiza lunară completă: evoluție, platforme, competitori, surse + recomandări | | competitor_battle_analysis | Deep-dive competitiv: unde pierzi, de ce, și top 5 mutări concrete | | source_opportunity_plan | Plan de outreach prioritizat din sursele citate + gap-uri | | weekly_health_check | Puls săptămânal scurt: semafor verde/galben/roșu pe fiecare zonă |

Securitate

  • Read-only — niciun tool nu poate modifica ceva în contul tău.
  • Scoping strict — cheia vede exclusiv brandurile echipelor în care ești owner sau membru; cererile către alte branduri primesc 404.
  • Revocare instant — ștergi cheia din Settings → API și accesul dispare imediat.
  • Tratează cheia ca pe o parolă: n-o pune în repository-uri publice sau în prompturi partajate.

Depanare

| Simptom | Cauză probabilă | |---|---| | 401 Unauthenticated | Cheia lipsește/greșită în header. Formatul corect: Authorization: Bearer CHEIA_TA | | 404 la un tool | brand_id nu aparține echipelor tale — rulează întâi list_brands | | 405 | Clientul a făcut GET — serverul e stateless, acceptă doar POST (normal pentru clienții MCP standard) | | 429 | Ai depășit limita de 120 cereri/min — așteaptă un minut | | Serverul nu apare în client | Verifică transportul: trebuie http (Streamable HTTP), nu sse sau stdio |

Setări și alerte Întrebări frecvente
din