AI agenti (MCP)

Toolsety a nástroje

Jak MCP server AmICited zpřístupňuje více než 300 nástrojů, aniž by zahltil kontext vašeho agenta: malá inzerovaná sada, čtyři meta-nástroje pro hledání a spouštění zbytku a dvanáct toolsetů.

Otevřít v ChatGPT Otevřít v Claude

MCP server AmICited registruje více než 300 nástrojů, jeden pro vše, co dashboard umí. Předat modelu všechny tyto definice při každém požadavku by spotřebovalo velkou část jeho kontextu dřív, než by začal pracovat, a modely si z velmi dlouhého seznamu nástroje vybírají hůř. Server je proto zpřístupňuje postupně: váš klient vidí krátký seznam a agent zbytek vyhledá, když ho potřebuje.

Nic z toho nemusíte spravovat. Agenti se tímto vzorem řídí sami, vedeni pokyny serveru a skillem using-amicited. Tato stránka vysvětluje, co dělají, abyste mohli číst přepis, nebo záměrně zúžit dostupnou plochu.

Co vidí váš klient#

tools/list inzeruje malou, pevnou sadu:

Nástroj	K čemu slouží
`list_domains`	Domény ve workspace s ID, která potřebuje každý další nástroj
`list_prompts`	Sledované prompty pro doménu
`list_competitors`	Sledovaní konkurenti pro doménu
`list_tags`	Tagy promptů pro doménu
`prompt_analytics`	Hlavní čísla AI viditelnosti
`report_link`	Funkční odkaz na jakýkoli report nebo stránku nastavení v aplikaci
`list_toolsets`	Dvanáct produktových oblastí, po jednom řádku, s počty nástrojů
`search_tools`	Najít nástroj podle toho, co chcete udělat
`describe_tool`	Přečíst úplné vstupní schéma jednoho nástroje
`read_tool`	Spustit nástroj jen pro čtení podle jména
`run_tool`	Spustit jakýkoli nástroj podle jména, včetně zápisů a nástrojů utrácejících kredity

Protože se tento seznam během konverzace nikdy nemění, mezipaměť promptů klienta zůstává platná, což dlouhé relace udržuje rychlé a levné.

Najít, prozkoumat, spustit#

Ke každému dalšímu nástroji se dostanete ve třech krocích:

text

search_tools  {"query": "which prompts cite competitors but not us"}
describe_tool {"name": "seo_get_citation_gap_invisible_winners"}
read_tool     {"name": "seo_get_citation_gap_invisible_winners", "arguments": {...}}

search_tools řadí nástroje podle jména, popisu a toolsetu. Funguje nejlépe s otázkou prostými slovy (“is the site down”, “customer lifetime value”) než s napůl zapamatovaným jménem. Zadejte toolset s prázdným dotazem pro procházení jedné oblasti a zvyšte offset pro listování velkou.
describe_tool vrací skutečné schéma argumentů a druh nástroje. Agenti by jej měli vždy zavolat před spuštěním nástroje, protože některé nástroje berou ploché argumenty a jiné vnořený objekt query.
read_tool spouští nástroje, jejichž druh je read: bezplatné, opakovatelné čtení vašich vlastních dat. Cokoli jiného odmítne, proto je označen jako jen pro čtení a proto jej opatrní klienti (například Codex s vypnutým schvalováním) mohou používat, aniž by se zastavovali ptát.
run_tool spouští vše, včetně ostatních tří druhů:

Druh	Význam
`read`	Čte data vašeho workspace. Zdarma.
`external`	Volá API třetí strany (Google, Bing, Meta, OpenAI, poskytovatelé dat) nebo stojí kredity
`write`	Vytváří nebo upravuje data workspace. Vyžaduje rozsah `amicited:write`
`destructive`	Maže data, nebo spouští a zastavuje skutečné výdaje na reklamu

Nástroj, který není inzerován, není méně chráněn. Každý nástroj si oprávnění, limity tarifu a kredity kontroluje sám a run_tool aplikuje vlastní kontrolu zápisu cílového nástroje, takže token jen pro čtení se přes něj k zápisu nedostane.

Dvanáct toolsetů#

Každý nástroj patří přesně do jednoho toolsetu. Agenti je používají k rozhodnutí, kde hledat, a vy je můžete použít k připnutí oblasti (viz níže).

Toolset	Co pokrývá	Příklady nástrojů
`domains`	Domény, konkurenti a tagy: ID, která přijímá každý další toolset	`list_domains`, `create_competitor`, `create_tag`
`prompts`	Sledované prompty a jejich odpovědi: vytvoření, plánování, čtení odpovědí, fan-outy, pokrytí	`create_prompts_bulk`, `list_prompt_responses`, `prompt_query_fanouts`, `get_prompt_coverage`
`visibility`	Kde se doména objevuje v AI odpovědích: metriky v čase, citované zdroje, share of voice, sémantické mapy	`get_dashboard_metrics`, `get_prompt_detail`, `get_citations_timeseries`, `list_top_cited_domains`
`organic_search`	Google Search Console a Bing Webmaster Tools: dotazy, stránky, pokrytí indexem, sitemapy, odesílání URL	`gsc_get_queries`, `gsc_inspect_url`, `bing_wmt_get_pages`, `indexnow_submit`
`paid_ads`	Reporting Google Ads, Microsoft Ads, Meta a LinkedIn: výdaje, kampaně, klíčová slova, vyhledávací výrazy, skutečné ROAS	`google_ppc_get_search_terms`, `bing_ppc_get_campaigns`, `meta_profit_true_roas`, `linkedin_performance`
`chatgpt_ads`	ChatGPT Ads: čtení výkonu a vytváření či úpravy kampaní, skupin reklam, kreativ a sledování konverzí	`ads_get_insights`, `ads_list_campaigns`, `ads_create_campaign`
`seo_reports`	Organická analýza postavená v datovém skladu: movers, striking distance, mezery v CTR a citacích, kanibalizace, index bloat	`seo_get_striking_distance`, `seo_get_citation_gap_invisible_winners`, `seo_get_cannibalization_queries`
`eshop`	Analytika e-shopu: tržby a marže, produkty, zákazníci, kohorty a LTV, segmenty, vstupní náklady	`eshop_get_kpis`, `eshop_get_products`, `eshop_get_ltv`, `eshop_get_cost_mix`
`uptime`	Monitory, heartbeaty, incidenty, SLA reporty, servisní okna, stavové stránky	`uptime_list_monitors`, `uptime_sla_report`, `heartbeat_create`, `status_page_create`
`content`	AI články, anotace a pravidla interního prolinkování pro připojený obchod	`article_generate`, `annotation_create`, `link_building_list_rules`
`audits`	Zdraví webu pro AI agenty: přístupnost pro agenty, kontrola llms.txt, Web Vitals, aktuálnost, site audit, zpětné odkazy	`get_agent_accessibility`, `llms_txt_get_comparison`, `get_web_vitals`, `backlinks_list`
`workspace`	Připojené datové platformy, stav synchronizace, importy a schránka oznámení	`platform_list_domain_connections`, `platform_get_sync_status`, `inbox_list_entries`

Názvy nástrojů mají předponu podle oblasti (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), což usnadňuje procházení přepisů.

Připnutí toolsetů pomocí `?toolsets=`#

Někteří klienti zpracovávají vnořené volání run_tool špatně a někdy chcete úzkého agenta, který vidí jen jednu oblast. Přidejte k URL připojení parametr dotazu:

text

https://api.flowhunt.io/mcp/amicited?toolsets=eshop,uptime
https://api.flowhunt.io/mcp/amicited?toolsets=all

Pojmenované toolsety se poté inzerují nativně v tools/list, vedle základní sady. all inzeruje vše, čímž se vzdáváte úspor kontextu, takže jej používejte jen s klienty, kteří provádějí vlastní vyhledávání nástrojů. Neznámé názvy se ignorují, ne odmítají, takže pokud se oblast neobjeví, zkontrolujte pravopis. Výběr je pevný po celou dobu života připojení; žádný nástroj jej během konverzace nemůže rozšířit.

Stránky, pole a limity#

Stránky po 25 řádcích. Každý nástroj, který vrací seznam řádků, vrací ve výchozím stavu 25, nejvýše 500 na volání. Když existuje více řádků, odpověď obsahuje blok paging s has_more a hodnotou k předání při dalším volání (nativní offset nebo stránka, nebo next_cursor).
fields. Nástroje, které vracejí jeden seznam řádků, přijímají pole fields, aby vrátily jen sloupce, které potřebujete. Sloupec, který řádky nemají, se odmítne, ne ignoruje.
Žádný argument workspace. Workspace je pevně dán vašimi přihlašovacími údaji, takže žádný nástroj nepřijímá ID workspace. Téměř každý nástroj potřebuje domain_id z list_domains.
Hodinový limit. Volání nástrojů se počítají na workspace a hodinu (viz připojení). Výpis nástrojů a čtení skills jsou zdarma; skrytý nástroj zpřístupněný přes read_tool nebo run_tool se počítá jednou.

Související#

Playbook skills Které nástroje volat, v jakém pořadí, pro skutečné otázky. Recepty Prompty, které tyto nástroje uvádějí do práce.