---
title: Einen MCP-Server hinzufügen
description: Erstelle einen Server, wähle, wer sich verbinden darf und welche Operationen er anbietet, und teile seinen Endpunkt mit den Leuten, die ihn aus einem AI-Client nutzen werden.
sidebar:
  order: 2
area: ai
feature: mcp-servers
appPath: /ai/agents/mcp-servers
lastVerified: 2026-11-03
version: "2026-11-02"
audience: admin
related:
  - ai/mcp-servers
  - ai/mcp-servers/connect-an-ai-client
  - settings/users
  - ai
translation:
  source: ai/mcp-servers/add-an-mcp-server.mdx
  sourceSha: 399cbaac900fa77894625d79f0ba31875b615007
---

Du willst, dass das People-Team seinen AI-Assistenten fragen kann, wer nächste Woche anfängt, ohne ihm den ganzen Workspace zu geben. Ein MCP-Server ist ein benanntes Bündel von Operationen mit einer Mindestrolle; du erstellst ihn in zwei Schritten, erst Details, dann Operationen, oder gehst von einem Preset aus, und gibst seinen Endpunkt weiter.

## Bevor du beginnst

- Du bist Admin oder Owner. Nur diese Rollen sehen **AI** in der Navigation.
- Wähle einen Namen, der sich nicht ändern wird: Kleinbuchstaben, Ziffern und Bindestriche, beginnend mit einem Buchstaben, bis zu 63 Zeichen.
- Du weißt, welche Operationen du anbieten willst oder welches Preset dem am nächsten kommt. Der Picker listet nur Operationen, die du selbst aufrufen kannst.

![Add MCP server: the details step, before choosing operations.](https://support.pyn.ai/media/ai/mcp-servers/ai-mcp-servers-add.png)

## Schritte

1. Öffne in Pyn **AI** in der linken Navigation, dann **MCP Servers** unter **Agents**.

2. Wähle **Add**. Die Seite **Add MCP server** öffnet sich. Um stattdessen von einem fertigen Bündel auszugehen, öffne den Pfeil neben **Add** und wähle **Add from Preset**. Der Picker hat zwei Kategorien, **Read only** (**People Directory**, **Workspace Explorer**) und **Read and write** (**Flow Author**, **Flow Operator**, **Forms and Polls**, **Journey Mapper**, **Onboarding Coordinator**); jedes Preset zeigt eine Beschreibung, wie viele Operationen es enthält und welche Rolle es braucht. Das gewählte Preset füllt Name, Titel, Beschreibung, Mindestrolle und Operationen aus, die du alle noch ändern kannst, und nichts bindet den Server danach an das Preset. Ein Preset listet nur die Operationen, die dein Workspace anbietet, und eines, dem nichts als `core_getTemplate` bleibt, wird nicht gezeigt.

3. Gib den **Name** ein (zum Beispiel `people-directory`). Das Feld erklärt „Lowercase letters, numbers and hyphens. It cannot be changed later.“

4. Gib einen **Title** und eine **Description** ein: „Tells people, and their AI client, what this server is for.“

5. Wähle die **Minimum role**: **Owner**, **Admin**, **Power User** oder **User**. „Only people with this role, or one above it, can connect.“ Wähle **Next**.

6. Unter **Operations** ist `core_getTemplate` schon gelistet: Die Operation lässt einen Client die Eigenschaften einer Vorlage nachschlagen, damit er die Elemente versteht, die er liest, und du kannst sie wie jede andere entfernen. Suche, um jede weitere Operation hinzuzufügen. Jede trägt einen Chip **Read** oder **Write**, und die Zeile unter dem Suchfeld zählt „n / 100 selected“, gefolgt von der Größe der Tool-Liste, die die gewählten Operationen ergeben, in Kilobyte und als ungefähre Token-Zahl (zum Beispiel „108 KB · ≈31,000 tokens“): Diese Liste lädt ein AI-Client bei jeder Verbindung. Über 256 KB erscheint ein Hinweis: „A tool list this large takes a noticeable slice of the AI client's context on every connect. Consider offering fewer operations.“ Entferne eine, indem du ihre Zeile wählst; das Papierkorb-Symbol an ihrem Ende zeigt an, was das Wählen der Zeile tut.

7. Wähle **Add**. Das Panel des Servers öffnet sich rechts.

> **Note:** Schlägt das Speichern fehl, zeigt die Seite „The server could not be saved. If you are adding a server, its name may already be in use.“ Ein archivierter Server gibt seinen Namen frei.

## Was du sehen solltest

![Select a server to open its panel: edit the description, copy the address AI clients connect to, and see its operations; Advanced holds the minimum role and schema size.](https://support.pyn.ai/media/ai/mcp-servers/ai-mcp-servers-panel.png)

Das Panel öffnet sich mit einem Hinweis, „AI clients connect to this address.“, über der Adresse, einem Link **How to connect an AI client**, der diese Anleitung im Help-Panel über der Seite öffnet, und einem Button **Copy URL**. Der Button zeigt einen Moment lang **Copied**, nachdem du ihn gewählt hast. Unter dem Hinweis liegen zwei Tabs. **Operations**, mit der Anzahl in seiner Beschriftung, enthält die Beschreibung, die direkt dort bearbeitet wird (eine leere lautet **(No Description)**), und dann die Operationen, jede mit ihrem Chip **Read** oder **Write**. **Advanced**, am Ende der Tab-Leiste, enthält **Minimum Role** und **Schema size**, die Kilobyte und ungefähren Token, die die Tool-Liste wiegt, mit demselben Hinweis darunter, sobald die Liste 256 KB überschreitet.

Füge die Adresse in die MCP-Einstellungen des AI-Clients ein; [Einen AI-Client verbinden](https://support.pyn.ai/de/ai/mcp-servers/connect-an-ai-client/) sagt, wo Claude, Claude Code und ChatGPT sie entgegennehmen. Der Client schickt die Person zu Pyn, wo sie sich wie gewohnt anmeldet (eine Anmeldung per Magic Link oder SSO, die von diesem Bildschirm aus gestartet wird, kehrt dorthin zurück) und dann **Connect *client*?** sieht: „*Client* is asking to use *server title* in *workspace* as you. It can only do what that server offers and you are allowed to do.“ Darunter zählt eine Zeile die Tools, die der Client bekommt, aufgeteilt in **read** und **write**; **Show** klappt sie zu den Listen **Can read** und **Can change data** auf, die jedes Tool mit seinem Titel (**Get item**) hinter der App nennen, aus der es kommt, damit die Person genau sieht, was der Client tun können wird. **Who am I** kommt mit jeder Verbindung und wird dort nicht mitgezählt. Wer mit seiner Rolle keines davon erreicht, liest „Your role does not allow any of the tools this server offers.“ **Allow** schickt die Person verbunden zurück zum Client; **Deny** verweigert es. Wer unter der **Minimum role** des Servers liegt, sieht **Connection Failed** mit „Your account is not allowed to connect to this server.“, und eine zu lange offen gelassene Anfrage zeigt „This request has expired. Start again from your AI client.“ Einmal verbunden, zeigt die Tool-Liste des Clients **Who am I** (`who_am_i`), das mit der Person, dem Workspace und dem Server antwortet, als die die Verbindung handelt, damit du bestätigen kannst, als wer der Client arbeitet, und ein Tool für jede Operation auf dem Server, die die eigene Rolle der Person erlaubt, benannt nach der Operation (zum Beispiel `core_getItem`) und in Worten betitelt, wo der Client Titel zeigt (**Get item**). Jedes Tool läuft als diese Person, und eine Operation, die ihre Rolle nicht erreicht, wird weder gelistet noch ist sie aufrufbar. **Write**-Tools ändern Daten und sind so markiert; ein Client, der solche Änderungen bestätigt, fragt die Person also zuerst. Operationen, die MCP-Server verwalten, werden nie angeboten, und ein Aufruf, der einen MCP-Server oder eine Verbindung nennt, wird abgewiesen. Clients, die im Browser laufen, verbinden sich genauso wie Desktop-Clients. Die Server-Zeile zeigt **Active**; nutze **Disable** in ihrem **...**-Menü, um ihn zu pausieren, was auch jede bestehende Verbindung aufhebt.

## Verwandte Seiten

- [MCP Servers](https://support.pyn.ai/de/ai/mcp-servers/) dafür, wie über den Zugang entschieden wird.
- [Einen AI-Client verbinden](https://support.pyn.ai/de/ai/mcp-servers/connect-an-ai-client/), um die Adresse zu Claude, Claude Code oder ChatGPT hinzuzufügen.
- [Users](https://support.pyn.ai/de/settings/users/) dafür, was jede Rolle darf.
- [AI](https://support.pyn.ai/de/ai/) für Pyns eingebaute Agents.
