MCP trikčių šalinimas
Dauguma Ocoya MCP problemų kyla dėl kliento konfigūracijos, nebaigto OAuth patvirtinimo, trūkstamos prieigos prie prekės ženklo arba dėl to, kad perduodami neteisingo prekės ženklo ID.
Greita patikra
| Simptomas | Ką patikrinti |
|---|---|
| Klientas nerodo Ocoya įrankių | Patvirtinkite, kad MCP URL yra https://mcp.ocoya.com, paleiskite klientą iš naujo ir įsitikinkite, kad klientas palaiko nuotolinius HTTP MCP serverius. |
| OAuth atsidaro, bet prieiga nesuteikiama | Prisijunkite prie teisingos Ocoya paskyros ir patvirtinkite bent vieną prekės ženklą. |
401 atsakas | Klientas nebaigė OAuth, pasibaigė prieigos rakto galiojimo laikas arba klientas siunčia API raktą vietoj OAuth naudojimo. |
| Prekės ženklas nerastas | Prekės ženklas nebuvo pasirinktas patvirtinimo metu arba klientas naudoja prekės ženklo ID iš kitos Ocoya paskyros. |
| Socialinis profilis atmestas | Iškvieskite ocoya_list_social_profiles tam pačiam brandId ir naudokite vieną iš grąžintų ID. |
| Neteisingas planavimas | Naudokite ISO datos ir laiko formatą, pvz., 2026-07-01T09:00:00Z. |
| Nepavyksta įjungti workflow | Išspręskite workflow patvirtinimo klaidas Ocoya prieš jį įjungdami arba paleisdami. |
OAuth ir autorizacija
Ocoya MCP nepriima Ocoya API raktų. MCP klientai turėtų naudoti OAuth ir siųsti bearer token, kurį išduoda Ocoya po to, kai vartotojas suteikia prieigą.
Diagnostikai neautentifikuota užklausa turėtų grąžinti 401 su WWW-Authenticate antrašte, kuri nurodo Ocoya OAuth metaduomenis:
curl -i https://mcp.ocoya.com \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'Jei klientui nuolat nesiseka atlikti OAuth, pašalinkite Ocoya MCP ryšį iš to kliento, pridėkite jį vėl ir užbaikite patvirtinimo eigą naudodami naršyklę, kurioje galite prisijungti prie Ocoya.
Prieiga prie prekės ženklo
Įrankiams, kurie veikia prekės ženklo lygiu, reikalingas brandId, kurį grąžina ocoya_list_brands. Jei prekės ženklo trūksta:
- Iš naujo prijunkite Ocoya MCP.
- Pasirinkite trūkstamą prekės ženklą OAuth patvirtinimo eigoje.
- Paprašykite kliento dar kartą iškviesti
ocoya_list_brands.
Nenaudokite prekės ženklo ID iš kitos paskyros, aplinkos ar kito OAuth leidimo.
Skelbimas ir planavimas
Prieš kuriant ar planuojant įrašus paprašykite kliento iš naujo gauti naujausius ID:
List my Ocoya brands and connected social profiles for the Acme brand.Naudokite grąžintą brandId ir socialProfileIds įrašo įrankiuose. Planavimui perduokite ISO datas ir laikus:
2026-07-01T09:00:00ZPastabos apie konkrečius klientus
| Klientas | Ką tikrinti |
|---|---|
| Claude Code | Cituokite URL, jei jūsų aplinka specialius simbolius interpretuoja kitaip. Paleiskite Claude Code iš naujo pridėję naują MCP serverį. |
| Codex | Paleiskite programą iš naujo arba atidarykite naują giją po ~/.codex/config.toml redagavimo. Vykdykite codex mcp login ocoya, kai reikalingas OAuth prisijungimas. |
| VS Code | Naudokite naują VS Code versiją su MCP palaikymu ir perjunkite Copilot Chat į Agent režimą. |
| Tik Stdio klientai | Naudokite mcp-remote, kad sujungtumėte su https://mcp.ocoya.com. |
Saugus atstatymas
Jei ryšys atrodo pasenęs arba prijungta neteisinga paskyra:
- Atšaukite arba pašalinkite Ocoya MCP ryšį kliente.
- Pridėkite MCP serverį dar kartą.
- Užbaikite OAuth naudodami norimą Ocoya paskyrą.
- Pasirinkite prekės ženklus, prie kurių klientas turėtų turėti prieigą.
- Prieš rašymo veiksmus patikrinkite su
ocoya_list_brands.