---
title: "MCP-kliens beállítása | Posty dokumentáció"
description: "A kapcsolat két módja, a kész beállítási blokk helye, és a leggyakoribb csatlakozási hibák."
canonical: https://posty.hu/de/dokumentation/mcp/einrichtung
source: https://posty.hu/de/dokumentation/mcp/einrichtung.md
---

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. 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. 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. 3
   
   Füg ihn in die Client-Einstellungen ein
   
   Jeder Client legt die Konfiguration woanders ab. Der Inhalt des Blocks ist aber derselbe.
4. 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"
      }
    }
  }
}
```

Kód másolása

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](https://posty.hu/de/ai), 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](https://posty.hu/de/dokumentation/mcp/werkzeuge).

## 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](https://posty.hu/de/dokumentation/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. |

Dokumentationsseiten

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [norbert@posty.hu](mailto:norbert@posty.hu) oder nutze auf der [Hilfeseite](https://posty.hu/de/hilfe) das Formular.