На головну

Підключити AI-асистента

Оновлено 21 вересня 2026

Укошику можна підключити до свого ChatGPT, Claude чи Gemini як MCP-сервер: асистент бачить твої рецепти й план харчування, шукає товари підключеного магазину і може запропонувати новий рецепт — але нічого не зберігає без твого явного підтвердження.

Як підключити

  1. У ChatGPT, Claude.ai чи Gemini відкрий налаштування конекторів (Connectors / MCP servers) і додай новий, вставивши адресу вище.
  2. Клієнт сам знайде параметри OAuth і покаже стандартний екран «Підключити [назва]?» зі списком прав доступу.
  3. Дозволь доступ у своїй сесії Укошику — далі асистент може читати дані одразу, а будь-яку зміну (новий рецепт, запис у план, рядок списку покупок) ти підтверджуєш окремим посиланням.
Claude Code:
claude mcp add --transport http ukoshiku https://dev.ukoshiku.com/api/mcp

For agents that don't speak MCP natively

If you can make HTTP requests but have no built-in MCP client (e.g. you are a browsing agent), you can drive the protocol by hand. Everything below is plain JSON-RPC over HTTPS — no SDK required.

Server: https://dev.ukoshiku.com/api/mcp — stateless Streamable HTTP, one POST per call, no session state kept between requests. Handshake:

POST https://dev.ukoshiku.com/api/mcp
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}

→ returns "instructions" with an overview and the tool list to expect.

Auth: every call except initialize needs a Bearer token. Discover the flow from the standard metadata documents rather than hardcoding it:

GET https://dev.ukoshiku.com/.well-known/oauth-protected-resource/api/mcp
GET https://dev.ukoshiku.com/.well-known/oauth-authorization-server

That's OAuth 2.1 with dynamic client registration and PKCE (S256) — register a client, send the person to the authorization endpoint to click "Дозволити" once in their own session, then exchange the returned code for a token. No client secret: it's a public client, PKCE is what protects the code exchange.

Tools (call tools/list for exact schemas):

  • ukoshiku_list_my_recipes, ukoshiku_get_my_recipe, ukoshiku_list_plan — read-only, the person's own data.
  • ukoshiku_search_public_recipes, ukoshiku_search_store_products — read-only search.
  • ukoshiku_propose_recipe_draft, ukoshiku_propose_plan_entry, ukoshiku_propose_shopping_list — the only tools that write anything, and even they don't: each returns status: "needs_user_confirmation" and a confirmation_url. Nothing is created, changed, or added until the person opens that link in their own Ukoshiku session and confirms it themselves.

Practical consequence: never tell the person a recipe, plan entry, or shopping-list line has been created — hand them the confirmation link and say it's pending until they open it.

Scopes

ukoshiku.read — required for every read tool. ukoshiku.drafts, ukoshiku.plan, ukoshiku.shopping-list — one per propose tool, requested separately so a client only asks for what it actually uses.

Підключити AI-асистента — Укошику · Укошику