MCP dokumentace

Připojení

• Endpoint: https://ptackova.photo/mcp
• Transport: MCP Streamable HTTP, JSON-RPC 2.0 přes HTTP POST.
• Autentizace: žádná. Není potřeba API klíč ani OAuth.
• Server je stateless, nevyžaduje uchovávání MCP session ID.
• Posílejte Content-Type: application/json a Accept: application/json, text/event-stream.

MCP klient se připojí přes initialize, oznámí notifications/initialized a načte tools/list. Aktuální vstupní a výstupní schémata poskytuje přímo tools/list. Odpověď může mít formát SSE, který MCP klient zpracuje.

Otevření /mcp v prohlížeči používá GET a vrátí 405 Method not allowed. Neznamená to nedostupnost serveru. Dokumentace je na této stránce; katalog API je dostupný přes GET i HEAD.

Dostupné nástroje

ptackova.get_services

Read-only. Bez vstupů vypíše služby, jejich slug, popis, kategorii, orientační cenu a URL.

ptackova.recommend_service

Read-only. Vyžaduje userNeed; volitelně location, occasion, budget a preferredDate. Porovnává klíčová slova s českým katalogem. Doporučení není potvrzením dostupnosti ani rozpočtu.

ptackova.get_service_detail

Read-only. Podle slug vrací popis, obrázek, ceník a URL služby. Neznámé informace vrací jako null nebo prázdné pole.

ptackova.create_inquiry_draft

Read-only. Přijímá volitelné name, email, phone, serviceSlug, preferredDate, location a message. Vrací návrh, chybějící pole, shrnutí a náhled e-mailu. Nic neodesílá.

ptackova.send_inquiry_email

Externí write akce. Vyžaduje confirmed: true, name, email, serviceSlug a message. Volitelně phone, preferredDate a location. Po ověření služby odešle poptávku fotografce.

WebMCP v prohlížeči

Pro podporované prohlížeče web poskytuje také experimentální WebMCP přes document.modelContext. Zpřístupňuje pouze seznam služeb, detail s ceníkem a doporučení: ptackova.get_services, ptackova.get_service_detail a ptackova.recommend_service. Data a vstupní schémata přebírá z existujícího MCP serveru.

Tato vrstva nic neobjednává, nepřipravuje poptávky a neodesílá e-maily. Vyžaduje podporu API v prohlížeči a zabezpečený kontext; v ostatních prohlížečích zůstává web beze změny. Nenahrazuje serverový endpoint /mcp pro ChatGPT.

Bezpečné odeslání poptávky

1. Vyberte existující službu podle jejího slugu z výpisu služeb.
2. Připravte návrh a doplňte chybějící jméno, e-mail, službu a zprávu.
3. Ukažte uživateli obsah poptávky a vyžádejte si výslovné potvrzení odeslání fotografce.
4. Teprve po potvrzení zavolejte write nástroj s confirmed: true.

Telefon, preferovaný termín a lokalita jsou volitelné. Termín může být ISO datum nebo text, například „podle domluvy“. Pro preferenci prostředí použijte „interiér“ nebo „exteriér“; konkrétní adresu či místo upřesněte ve zprávě.

Odesílá se skutečný e-mail fotografce, nikoliv potvrzovací e-mail zákazníkovi. Nevzniká rezervace, platba ani garance dostupnosti. Termín, místo a konečná cena se domlouvají individuálně. Cena 0 v CMS znamená „Cena dle aktuální nabídky“, nikoliv focení zdarma; používejte textové cenové údaje vrácené nástrojem.

Odeslání není idempotentní. Při timeoutu ho automaticky neopakujte, mohli byste odeslat duplicitní e-mail. Úspěch ověřte podle result.success, ne pouze podle HTTP statusu.

Chyby a omezení

Write nástroj vrací CONFIRMATION_REQUIRED, SERVICE_NOT_FOUND, RATE_LIMITED nebo MAIL_SEND_FAILED v result.error. Neplatné vstupy mohou být odmítnuty MCP validací. Chybějící údaje o službě nevymýšlejte a aktuální nabídku vždy načítejte z nástrojů.

Odesílání má limit 10 pokusů za 15 minut na IP a 3 za hodinu na e-mail. Limity se počítají v paměti jednotlivé instance, nejsou globální garancí napříč serverless instancemi. Při omezení respektujte dobu čekání uvedenou v chybové zprávě.

Příklad bez odeslání e-mailu

Inicializace a následné vypsání schémat nástrojů:

curl https://ptackova.photo/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example","version":"1.0.0"}}}'

curl https://ptackova.photo/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

curl https://ptackova.photo/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Další informace: pravidla a odkazy pro AI, ochrana osobních údajů a podmínky použití.