MCP-szerver

MCP-kliens beállítása

A kapcsolat két módja, a kész beállítási blokk helye, és a leggyakoribb csatlakozási hibák.

Kroky nastavení

1
Vytvořte MCP klíč
V Posty na stránce Nastavení → Vývojáři. Klíč začíná předponou psty_mcp_ a při vytvoření ho uvidíte jen jednou.
2
Zkopírujte hotový konfigurační blok
Na stejné stránce najdete hotové bloky pro nejčastější klienty, i s klíčem.
3
Vložte ho do nastavení klienta
Každý klient ukládá konfiguraci jinde. Obsah bloku je ale stejný.
4
Restartujte klienta
Většina klientů načte konfiguraci jen při spuštění.

Formát nastavení

Většina klientů používá stejný formát JSON. Důležitá je adresa a hlavička:

{
  "mcpServers": {
    "posty": {
      "type": "http",
      "url": "https://api.posty.hu/mcp",
      "headers": {
        "Authorization": "Bearer psty_mcp_a_kulcsod"
      }
    }
  }
}

Tady použijte předponu Bearer

MCP klíč se posílá s předponou Bearer, zatímco u REST API je hodnotou hlavičky samotný klíč. Tyto dva případy lze snadno zaměnit.

Pokud se klient připojuje přes OAuth a klíč neukládá, použijte adresu https://api.posty.hu/mcp-oauth bez hlavičky. Autorizaci si klient vyřídí sám.

Nastavení podle klienta

Klient	Kde to nastavíte
Claude a Claude Code	V nastavení MCP příslušného klienta. Hotový blok je na stránce Nastavení → Vývojáři.
ChatGPT	V konektorech nebo v nastavení aplikace.
Gemini CLI	V souboru `~/.gemini/settings.json` pod klíčem `mcpServers`. Adresa patří do pole `httpUrl`. Webová ani mobilní aplikace Gemini neumí přidat vzdálený MCP server.
Jiný MCP klient	Výše uvedený formát funguje s každým klientem, který podporuje transport Streamable HTTP.

Návod pro jednotlivé klienty krok za krokem najdete na stránce AI agentů, včetně snímků z terminálu.

Kontrola

Nejjednodušší zkouška: zeptejte se agenta, jaké máte kanály. Když je vypíše, připojení i oprávnění jsou v pořádku.

Pokud klient vypisuje dostupné nástroje, musí jich být deset. Seznam je na stránce Přehled nástrojů.

Když se připojení nedaří

Příznak	Příčina	Řešení
401 nebo „ověření se nezdařilo“	Vložili jste REST klíč místo MCP klíče.	Na stránce Nastavení → Vývojáři vytvořte klíč s předponou `psty_mcp_`.
401 se správným klíčem	Chybí předpona `Bearer`.	Hodnota hlavičky má být `Bearer psty_mcp_…`.
403, „není součástí tarifu“	MCP je k dispozici od tarifu Pro.	Viz stránku Tarify.
Klient server nevidí	Klient nebyl restartován nebo je nastavení ve špatném souboru.	Restartujte klienta a zkontrolujte, že je JSON platný.
Agent nevidí žádný kanál	Klíč patří k jinému pracovnímu prostoru, nebo není propojený žádný kanál.	Podívejte se na stránku Kanály a ověřte, ve kterém pracovním prostoru byl klíč vytvořen.

Něco vám na této stránce chybí? Napište na [email protected] nebo na stránce Nápověda vyplňte formulář.