Agent integrations

    Připojte svého AI asistenta k 2efka

    Zkopírujte adresu níže a vložte ji do ChatGPT nebo Claude.
    Asistent pak umí pracovat s nástroji, které aplikace nabízí.

    https://dmupsylvmfomzbahtprf.supabase.co/functions/v1/mcp

    Vložte Bearer token (např. z OAuth flow), aplikace odešle ukázkový MCP request tools/list a zobrazí odpověď.

    Token se nikam neukládá ani neodesílá jinam než na uvedený MCP server.

    Jak asistenta připojit

    ChatGPT

    1. Otevřete nastavení Connectors a zapněte režim Developer mode (přečtěte si upozornění).
    2. V okně chatu klikněte na tlačítko „+" a zapněte Developer mode.
    3. Klikněte na „Add sources" a poté „Connect more".
    4. Pojmenujte konektor a vložte adresu MCP serveru.
    5. Zeptejte se ChatGPT, ať aplikaci použije.

    Claude

    1. Otevřete Custom connector v Claude.
    2. Pojmenujte konektor a vložte adresu MCP serveru.
    3. V okně chatu konektor zapněte.
    4. Zeptejte se Claude, ať aplikaci použije.

    Po aktualizaci aplikace obnovte připojení

    Asistent si nástroje ukládá do paměti.
    Když aplikaci upravíme, obnovte konektor, ať vidí novinky.

    ChatGPT

    1. Otevřete nastavení aplikací a vyberte tento konektor v „Enabled apps".
    2. Vedle „Information" klikněte na „Refresh".
    3. Pokud se adresa změnila, vložte novou z pole výše.
    4. Otevřete nový chat a zkuste asistenta znovu.

    Claude

    1. Otevřete stránku Connectors a vyberte tento konektor.
    2. Obnovte nebo aktualizujte jeho nástroje.
    3. Pokud se adresa změnila, vložte novou z pole výše.
    4. Zeptejte se Claude, ať aplikaci znovu použije.

    Interaktivní průvodce

    Odpovězte na pár otázek.
    Podle vašeho setupu ukážeme přesně, co udělat.

    Krok 1 z 2

    Kterého asistenta používáte?

    Generátor requestu

    Načtěte seznam nástrojů, vyberte jeden, doplňte argumenty a získejte hotový kód pro curl, TypeScript, Python i konfiguraci mcp.json. Volání můžete rovnou spustit.

    Uloží šablonu, transport, nástroj, argumenty i token do JSON souboru.

    Token zůstává v prohlížeči a odesílá se výhradně na uvedený MCP server.

    Připojení z vlastního agentu

    Návod pro vývojáře, kteří chtějí volat MCP server přímo z vlastního agenta.
    Protokol je Streamable HTTP dle MCP 2025-06-18, autorizace přes OAuth 2.1.

    Rychlá kontrola dostupnosti

    Ověřím MCP server a seznam nástrojů dřív, než začnete generovat konfiguraci.
    Bez tokenu — jen veřejné discovery a anonymní pokus o tools/list.

    Cíl: https://dmupsylvmfomzbahtprf.supabase.co/functions/v1/mcp

    1. Krok 1

      Zjistěte OAuth issuer

      Zavolejte GET na https://dmupsylvmfomzbahtprf.supabase.co/functions/v1/mcp/.well-known/oauth-protected-resource. Odpověď obsahuje pole authorization_servers s URL, kde získáte access token.

    2. Krok 2

      Získejte access token

      Server podporuje Dynamic Client Registration (RFC 7591). Váš agent se sám zaregistruje na /oauth/register, spustí authorization code flow s PKCE a získá bearer token pro přihlášeného uživatele. Token je vázaný na uživatele a respektuje RLS.

    3. Krok 3

      Volejte MCP endpoint

      POST na MCP URL s JSON-RPC 2.0 payloadem. Povinné hlavičky: Content-Type: application/json, Accept: application/json, text/event-stream, Authorization: Bearer …. Bez druhé hlavičky server vrátí 406.

    # 1) Discovery, aby agent zjistil, že server chce OAuth
curl -s https://dmupsylvmfomzbahtprf.supabase.co/functions/v1/mcp/.well-known/oauth-protected-resource | jq

# 2) Seznam nástrojů (po autorizaci vložte Bearer token)
curl -X POST https://dmupsylvmfomzbahtprf.supabase.co/functions/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

    Alternativní šablony pro rychlou instalaci

    Vyberte klienta, zkopírujte, stáhněte nebo upravte podle svého prostředí.

    {
  "schema_version": "v1",
  "name_for_model": "2efka",
  "name_for_human": "2efka",
  "description_for_model": "Nástroje pro aplikaci 2efka. Volají MCP server přes Streamable HTTP.",
  "auth": {
    "type": "oauth",
    "client_url": "https://dmupsylvmfomzbahtprf.supabase.co/functions/v1/mcp/.well-known/oauth-protected-resource",
    "scope": "",
    "authorization_content_type": "application/json"
  },
  "api": {
    "type": "openapi",
    "url": "https://dmupsylvmfomzbahtprf.supabase.co/functions/v1/mcp"
  }
}

    2efka_chatgpt_actions.json je validní a připravený ke stažení.

    Poznámky

    • Token vypršel? Použijte refresh token nebo znovu spusťte OAuth flow.
    • Anonymní volání (bez tokenu) vrátí 401, veřejné nástroje server v této instalaci nemá.
    • MCP session je stateless — každý request musí obsahovat autorizaci.
    • Validace kontroluje strukturu, transport, https:// URL a formát hlavičky Authorization.

    Nejčastější chyby a jak je opravit

    Když něco nefunguje, zkontrolujte tyto body.
    Většinu problémů vyřešíte za minutu.

    Asistent ohlásí chybu 401 nebo neautorizovaný přístup

    Chyba 401 znamená, že asistent nemá platný token k aplikaci. Postupujte podle těchto kroků:

    1. Ujistěte se, že jste přihlášeni do 2efka v tomto prohlížeči.
    2. Vraťte se do asistenta a klikněte na „Připojit znovu" nebo „Autorizovat".
    3. V prohlížeči se objeví stránka s žádostí o souhlas. Povolte ji.
    4. Pokud se stránka neobjeví, vypněte blokovače reklam nebo VPN a zkuste znovu.
    Nástroje se v asistentovi nezobrazí

    Asistent si seznam nástrojů ukládá do mezipaměti. Zkuste je obnovit:

    1. V nastavení konektoru klikněte na „Obnovit" nebo „Refresh tools".
    2. Zavřete a znovu otevřete okno chatu.
    3. Pokud nástroje stále nevidíte, odpojte konektor a připojte ho znovu.
    Ověření dostupnosti vrátí chybu 404 nebo 406

    Adresa serveru je pravděpodobně nesprávná. Zkontrolujte:

    • Adresa musí začínat https:// a končit /functions/v1/mcp.
    • Nepřidávejte žádné koncové lomítko, cestu ani parametry za /mcp.
    • Pokud používáte vlastní adresu, klikněte na „Vrátit výchozí" a zkuste znovu.
    Server neodpovídá nebo ověření překročí časový limit

    Problém bývá v síti nebo prohlížeči:

    1. Zkontrolujte připojení k internetu.
    2. Vypněte VPN nebo firemní proxy, pokud ji používáte.
    3. Zkuste jiný prohlížeč nebo anonymní okno.
    4. Dejte nám vědět na kontaktu, pokud problém přetrvává.
    Vlastní adresa se po zavření stránky nezobrazí

    Vlastní adresa se ukládá do localStorage tohoto prohlížeče. Pokud se neuloží:

    • Zkontrolujte, zda nepoužíváte anonymní režim nebo blokovač cookies.
    • Ujistěte se, že jste klikli na „Uložit adresu" a ne jen na „Zrušit".
    • Vyplňte adresu znovu a ověřte ji tlačítkem „Ověřit dostupnost".

    Troubleshooting

    Vyberte chybu, kterou vidíte.
    Každá položka obsahuje příčinu a krok za krokem nápravu.

    Chyba 401 / 403 — asistent nemá přístup

    Server odmítl autorizaci. Token chybí, vypršel, nebo nemá potřebná práva.

    1. Zkontrolujte, že jste přihlášeni do 2efka ve stejném prohlížeči.
    2. V asistentovi klikněte na „Reconnect“ / „Autorizovat“ a projděte souhlasovým oknem.
    3. V Safari povolte cross-site tracking, nebo zkuste Chrome / Edge.
    4. Vypněte blokovače reklam, VPN a firemní proxy pro domény 2efka.cz a supabase.co.
    5. Pokud chyba přetrvává, odstraňte konektor a přidejte ho znovu.
    Neplatný nebo vypršelý token

    Asistent používá token, který server neuznává — například zkopírovaný z jiné session nebo starý.

    1. Token získávejte pouze oficiálním OAuth souhlasem v asistentovi.
    2. Nezkoušejte vkládat svůj login hesla nebo jiné API klíče — nebudou fungovat.
    3. Po změně hesla nebo odhlášení starý token zaniká, proveďte autorizaci znovu.
    4. V Claude / ChatGPT obnovte konektor a otevřete nový chat.
    Chybějící nástroj nebo prázdný seznam

    Konektor je připojený, ale asistent nevidí žádné nástroje, nebo chybí ten, který potřebujete.

    1. V nastavení konektoru klikněte „Obnovit nástroje“ / „Refresh tools“.
    2. Zavřete aktivní chat a otevřete nové vlákno — staré může držet zastaralý snapshot.
    3. Odpojte konektor a připojte ho znovu s aktuální adresou z pole výše.
    4. Ujistěte se, že máte v aplikaci roli potřebnou pro daný nástroj (např. admin).
    Nesprávná konfigurace / špatná adresa

    Jedna chyba v URL nebo hlavičkách způsobí, že asistent server vůbec nenajde.

    1. Adresa musí přesně odpovídat: https://<project>.supabase.co/functions/v1/mcp (bez lomítka na konci).
    2. Nepřidávejte cestu za /mcp, ani parametry jako ?v=1.
    3. Pokud máte vlastní adresu, klikněte „Vrátit výchozí“ a ověřte tlačítkem „Ověřit dostupnost“.
    4. Asistent musí posílat hlavičku Accept: application/json, text/event-stream, jinak server vrátí 406.
    Jiná chyba nebo nevíte, kde je problém

    Když nic z předchozího nepomáhá, projděte univerzální kontrolní seznam.

    1. Zkuste ověřit dostupnost serveru tlačítkem „Ověřit dostupnost“ výše.
    2. Otestujte připojení s aktuálním tokenem přes „Otestovat připojení“.
    3. Použijte interaktivní průvodce — podle odpovědí dostanete konkrétní kroky.
    4. Vyzkoušejte anonymní okno nebo jiný prohlížeč, abyste vyloučili rozšíření.
    5. Zkopírujte chybovou hlášku a kontaktujte nás — pomůžeme do 24 hodin.
    Nedaří se připojení? Napište nám na kontaktu a pomůžeme.