Integrace MCP Serveru
Co je Ranketta MCP Server?
Ranketta MCP Server umožňuje AI klientům přistupovat k datům Ranketty přes Model Context Protocol (MCP).
Díky MCP můžete v nástrojích jako Claude Desktop nebo Cursor:
- načíst nejnovější prompty a metriky
- procházet citace a zdrojové domény
- analyzovat výkon query fan-outu
- vyhodnocovat výsledky site auditu
Kde najdu instrukce
Nejjednodušší je jít na mcp.ranketta.com, kde najdete aktuální návod krok za krokem pro jednotlivé klienty.
Jak funguje autentizace
Ranketta MCP používá OAuth 2.0.
Při připojení klienta se přihlásíte svým Ranketta účtem a udělíte klientovi přístup podle vašich stávajících oprávnění.
Postup nastavení
- Otevřete mcp.ranketta.com.
- Vyberte klienta, který chcete připojit (např. Claude Desktop nebo Cursor).
- Zkopírujte doporučenou konfiguraci serveru pro daného klienta.
- V klientovi přidejte nový remote MCP server a vložte konfiguraci.
- Dokončete OAuth přihlášení do Ranketty a autorizaci.
- Ověřte spojení testovacím dotazem (např. seznam promptů nebo citací).
Nástroje pro citace
MCP server vystavuje stejná data jako přehled citací:
| Nástroj | Co vrací |
|---|---|
get_citation_domains | Stránkované domény s usage rate |
get_citation_urls | Stránkované URL s usage rate |
get_citation_domain_types_breakdown | Podíl citací podle typu domény |
get_citation_page_types_breakdown | Podíl citací podle typu stránky |
get_prompt_citations | URL citací pro jeden prompt |
Volitelné filtry u seznamů: domain_types, page_types, mention, search, limit, offset. U breakdown nástrojů také start_date a end_date (ISO datum).
Typy domén zahrnují corporate, ugc, editorial, review, institutional, social_media, ecommerce, wiki, news a other. Typy stránek zahrnují blog_post, product_page, guide, listicle, comparison a další — úplný seznam je v Porozumění citacím.
Stejné endpointy jsou na veřejném REST API (api.ranketta.com/v1/citations/overall/...) pro integrace s API klíči místo MCP.
Doporučené první dotazy
- „Vypiš top prompty podle visibility za posledních 30 dní.“
- „Ukaž domény s nejvyšším usage rate za posledních 30 dní.“
- „Jaký podíl mých citací tvoří editorial vs UGC domény?“
- „Ukaž nejnovější URL citací pro prompt X.“
- „Porovnej výsledky fan-outu podle providerů.“
- „Ukaž nevyřešené problémy z posledního site auditu.“
Řešení problémů
- Pokud autorizace selže, připojte server znovu a zopakujte OAuth.
- Pokud jsou výsledky prázdné, ověřte aktivní kontext firmy.
- Pokud je přístup zamítnut, zkontrolujte roli a oprávnění modulů v Rankettě.