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.

So richtest du es ein

1
Erstell einen MCP-Schlüssel
In Posty, unter Einstellungen → Entwickler. Der Schlüssel beginnt mit psty_mcp_ und ist nur einmal sichtbar, direkt bei der Erstellung.
2
Kopier den fertigen Einstellungsblock
Auf derselben Seite findest du fertige Blöcke für die häufigsten Clients, mit dem Schlüssel darin.
3
Füg ihn in die Client-Einstellungen ein
Jeder Client legt die Konfiguration woanders ab. Der Inhalt des Blocks ist aber derselbe.
4
Start den Client neu
Die meisten Clients lesen die Konfiguration nur beim Start.

Das JSON-Format

Die meisten Clients nutzen dieselbe JSON-Struktur. Wichtig sind die Adresse und der Header:

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

Hier mit Bearer-Präfix

Den MCP-Schlüssel schickst du mit einem Bearer-Präfix. Den REST-API-Schlüssel schreibst du allein in den Header. Diese zwei Stellen sind leicht zu verwechseln.

Wenn dein Client über OAuth verbindet und keinen Schlüssel speichert, nimm https://api.posty.hu/mcp-oauth, ohne Header. Die Freigabe holt sich der Client selbst.

Je nach Client

Client	Wo du es einstellst
Claude und Claude Code	In den MCP-Einstellungen des Clients. Den fertigen Block gibt es unter Einstellungen → Entwickler.
ChatGPT	Unter Konnektoren, oder in den App-Einstellungen.
Gemini CLI	Unter dem Schlüssel `mcpServers` in `~/.gemini/settings.json`, die Adresse im Feld `httpUrl`. Die Gemini-App für Web und Handy kann keinen Remote-MCP-Server hinzufügen.
Anderer MCP-Client	Jeder Client, der streamable HTTP als Transport unterstützt, funktioniert mit dem Format oben.

Schritt-für-Schritt-Anleitungen je Client stehen auf der Seite für KI-Agenten, mit Terminal-Screenshots.

So prüfst du es

Der einfachste Test: Frag deinen Agenten, welche Kanäle du hast. Listet er sie auf, stimmen Verbindung und Berechtigung.

Wenn dein Client die verfügbaren Tools auflistet, solltest du zehn sehen. Die Liste steht auf der Seite Tool-Referenz.

Wenn es nicht verbindet

Symptom	Ursache	Lösung
401, oder „Authentifizierung fehlgeschlagen”	Du hast einen REST-Schlüssel eingefügt, statt eines MCP-Schlüssels.	Erstell unter Einstellungen → Entwickler einen Schlüssel, der mit `psty_mcp_` beginnt.
401 mit dem richtigen Schlüssel	Das `Bearer`-Präfix fehlt.	Der Header-Wert muss `Bearer psty_mcp_…` sein.
403, „nicht im Tarif enthalten”	MCP ist ab dem Pro-Tarif verfügbar.	Schau auf die Seite Tarife.
Der Client sieht den Server nicht	Kein Neustart, oder die Einstellung steht in der falschen Datei.	Start den Client neu, und prüf, ob das JSON gültig ist.
Der Agent sieht keine Kanäle	Der Schlüssel gehört zu einem anderen Arbeitsbereich, oder es ist kein Kanal verbunden.	Schau auf die Kanäle-Seite, und prüf, in welchem Arbeitsbereich der Schlüssel erstellt wurde.

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [email protected] oder nutze auf der Hilfeseite das Formular.