Řešení problémů s MCP
Než akci zopakujete, prověřte zjišťování dostupných nástrojů, ověřování, přístup k organizaci, argumenty a nejasné výsledky.
Další kontrolu zvolte podle příznaku: pokud nástroj chybí, zkontrolujte připojení; pokud je volání odmítnuto, prověřte chybu argumentu nebo oprávnění. Uchovejte název nástroje, vstupy bez citlivých údajů, odpověď a příslušný prostředek nebo revizi zdroje. Tyto podklady vám pomohou dokončit zamýšlenou práci, aniž byste opakovali zápis, jehož výsledek není znám.
Chybí očekávané nástroje #
Porovnejte nastavený koncový bod se seznamem nástrojů, který vrací klient. /mcp a /main zpřístupňují stejné nástroje vyžadující ověření; /account po ověření přesměruje na /main.
Vyhledejte members_listMemberships a engines_list a postupujte podle úvodních příkladů načítání dat. Přesné názvy a schémata najdete v aktuální odpovědi tools/list. Samotná existence koncového bodu API neznamená, že ho MCP zpřístupňuje.
Pokud jsou skryté jen některé nástroje, zkontrolujte seznam povolených nástrojů a schválení v klientovi a povolte jen to, co úkol vyžaduje. Pokud nástroj má být dostupný, ale chybí, uchovejte pro hlášení údaje o serveru a jeho verzi a výstup zjišťování dostupných nástrojů bez citlivých údajů.
GET vrací 405 #
Nastavte Streamable HTTP na /mcp. Po ověření vrací GET na /mcp nebo /main odpověď 405 s Allow: POST; klient odesílá zprávy MCP metodou POST. Pokud token chybí nebo není platný, server vrátí 401 ještě před předáním požadavku ke zpracování. Ověřený požadavek na /account místo toho vrátí 308 s přesměrováním na /main. Tyto odpovědi na GET neověřují, zda funguje platné připojení MCP přes POST. Po výběru správného transportu zkontrolujte chybu připojení hlášenou klientem.
Nesprávné ověření nebo organizace #
U 401 zkontrolujte, zda ověření připojení přes OAuth proběhlo pod správným uživatelským účtem Lingo.dev. Hostovaný server vyžaduje platný uživatelský token typu bearer; osobní ani služební klíč API nepřijímá v x-api-key ani jako hodnotu bearer. Nechte klienta obnovit autorizaci nebo se znovu připojte přes jeho správu účtů. Tokeny do diagnostických údajů nezahrnujte.
Zavolejte members_listMemberships, vyberte požadovanou organizaci z data a předejte její ID v poli pro organizaci následujícího nástroje. U engines_list je to pole orgId. Výběr jiné organizace ze stejného seznamu nevyžaduje novou autorizaci OAuth. Pokud je přihlášená nesprávná osoba, připojte se znovu; samotný restart může znovu použít uloženou relaci.
Pokud se členství zobrazuje v ssoRequired, přihlaste se do Lingo.dev prostřednictvím poskytovatele identity dané organizace a připojte se znovu. Pokud jsou data i ssoRequired prázdné, dokončete nastavení organizace na https://lingo.dev/orgs/start a poté znovu načtěte členství. Nedostupná organizace nemusí existovat, uživatel nemusí být jejím členem nebo může vyžadovat SSO; nepovažujte každou takovou odpověď za známku vypršení platnosti přihlašovacích údajů.
Pokud nástroj odmítne operaci kvůli chybějícímu oprávnění nebo nároku na přístup, zkontrolujte požadavky dané operace místo opakovaného ověřování. Přístup k organizaci a oprávnění provést konkrétní zápis se kontrolují samostatně. Vysvětlete, jaké oprávnění chybí. Nevolte bez upozornění roli s širšími právy ani přihlašovací údaje s širším oprávněním.
Nástroj hlásí nedokončené nastavení organizace #
Organizace byla vytvořena nedávno a její zakladatel ještě nedokončil nastavení ve webové aplikaci: integrace, členy týmu a první engine. Nástroje na úrovni organizace mohou být až do dokončení nastavení zablokované; opakované volání ani nová autorizace tyto kroky nedokončí. members_listMemberships zůstává k dispozici. Jako zakladatel organizace otevřete odkaz ze zprávy, https://lingo.dev/orgs/<orgId>, dokončete kroky uvedené ve zprávě a poté volání zopakujte. Viz Dokončení nastavení nové organizace.
Nástroj odmítá argumenty #
Porovnejte vstup s přesným schématem vráceným připojením. Argumenty nástrojů jsou nyní uspořádané jako pole na nejvyšší úrovni; vnořené hodnoty zůstávají tam, kde je schéma definuje. Nepřidávejte smyšlené obalové struktury body, params ani query. Kde je to vyžadováno, výslovně vyplňte pole pro organizaci; z tokenu bearer se nedoplňuje. Nepovinné pole intent slouží k popisu úkolu. Podporované operace s účtem najdete v části Možnosti.
Zkontrolujte, co jednotlivá ID označují. members_remove.id je ID členství z members_list; members_setRole.userId označuje uživatele, ke kterému toto členství patří. ID lokalizačního engine nemůže nahradit ID záznamu požadavku. Neprůhledné kurzory nebo dvojice časového razítka v plné přesnosti a ID kopírujte přesně, místo abyste je znovu sestavovali ze zobrazených datumů.
Zachovejte rozdíly, které schéma rozlišuje: mezi vynechanými hodnotami a hodnotami null, mezi čísly a řetězci i mezi poli a jednotlivými hodnotami. Než se pokusíte chybu argumentu obejít, zkontrolujte schéma připojeného nástroje.
Výsledek zápisu do účtu nebo úlohy není jasný #
Než akci zopakujete, načtěte příslušný prostředek nebo stav úlohy. K chybě sítě může dojít až poté, co server přijal vytvoření klíče, pozvánku, rozhodnutí při kontrole, návrh nebo úlohu. Místo automatického opětovného odeslání nejprve ověřte, zda zamýšlená změna existuje.
U odeslané úlohy zřizování načtěte provisioningJobs_get s uloženým ID úlohy, než se rozhodnete, zda ji zopakovat. U ostatních operací zkontrolujte uložený prostředek a podmínky, za kterých připojený nástroj považuje operaci za dokončenou. Pro překladová workflow použijte referenční dokumentaci CLI nebo API.
Chybí dokumentace nebo podklady #
Vyhledejte informace pomocí localization_search a poté předejte path z výsledku do docs_fetch, abyste načetli celou stránku. Pokud cesta nefunguje, vyhledejte daný úkol znovu a použijte aktuální výsledek. Znalostní báze používá jinou cestu k úložišti než web založený na souborech, takže stránka webu může v tomto indexu chybět nebo být zastaralá. Než dospějete k závěru, že daná funkce není dostupná, zkontrolujte aktuální referenční dokumentaci na webu.
Při hlášení nevyřešeného nedostatku MCP uveďte úkol, který jste se pokoušeli provést, přesný název nástroje, verzi serveru a odpověď bez citlivých údajů. Potvrzení přijetí hlášení není příslibem termínu opravy.
U dotazu na kvalitu určete, co chybí: zdrojové podklady, dokončené hodnocení, použitelné kritérium, nebo jednoznačná odpověď. Každá z těchto situací vyžaduje jiný další postup. Část Měření vysvětluje, jak vykázat dostupné podklady, aniž by se nezodpovězené případy považovaly za úspěšné.