KI-Assistenten (MCP)
Der Peerdom MCP-Server ermöglicht es jedem KI-Assistenten, Fragen zu deiner Organisation in natürlicher Sprache zu beantworten (zu deinen Personen, Rollen und Kreisen, wer was innehat und wo Lücken bestehen). Er spricht das Model Context Protocol (MCP), einen offenen Standard zur Anbindung von KI-Assistenten an Tools und Daten, und funktioniert so mit dem Assistenten, den du bereits nutzt, anstatt dich an einen einzelnen Anbieter zu binden.
Du verbindest ihn mit deinem bestehenden Peerdom API-Schlüssel. Auf deiner Seite musst du nichts installieren, und du bist in etwa einer Minute startklar.
Was du fragen kannst
Sobald die Verbindung steht, kannst du deinem Assistenten Fragen stellen wie:
- «Mit welcher Organisation bin ich verbunden?»
- «Welche Rollen im Marketing-Kreis sind aktuell vakant?»
- «Wer hat die Rolle Finance Lead inne, und was ist ihr Beitrag?»
- «Welche Rollen hat Maria inne, und in welchen Kreisen sind sie?»
- «Wer trägt aktuell die meisten Rollen: Ist jemand überlastet?»
- «Zeige mir unsere Organisationsstruktur als Gliederung.»
- «Hier ist ein neues Projekt: Welche Rolle sollte es verantworten, und welche anderen Rollen werden beteiligt sein?»
Im Hintergrund nutzt der Assistent eine Reihe von Tools: Lesewerkzeuge, um Kolleginnen und Kollegen, Rollen und Kreise aufzulisten und zu untersuchen, vakante Rollen zu finden und die Auslastung zusammenzufassen, sowie Schreibwerkzeuge, um Kolleginnen und Kollegen, Rollen und Gruppen zu erstellen, zu bearbeiten und zu entfernen. Ein Lesewerkzeug, read_okf, gibt dem Assistenten deine gesamte Organisation auf einmal als verlinktes Markdown: jeden Kreis und jede Rolle mit ihrem vollständigen Inhalt (Zweck, Verantwortlichkeiten und deine eigenen Felder), dazu Personen, Ziele und Seiten. Genau das erlaubt es ihm, über alle deine Rollen hinweg zu schliessen, zum Beispiel um die richtige Verantwortliche oder den richtigen Verantwortlichen für eine Aufgabe zu finden. Es ist derselbe Inhalt wie im Agentenlesbaren Export (OKF). Der Assistent wählt anhand deiner Frage, welche Tools er aufruft, und antwortet in natürlicher Sprache.
Was jeder Client benötigt
Jeder MCP-Client verbindet sich mit demselben Endpunkt und demselben Header:
Endpoint: https://mcp.peerdom.org/mcp
Header: X-Api-Key: <your-api-key>
API-Schlüssel erhalten
Navigiere zu Einstellungen > Meine Daten > API-Schlüssel in den Organisationseinstellungen und klicke auf Neuer API-Schlüssel. Nur Personen mit Zugriffsrechten als Besitzerin oder Besitzer können API-Schlüssel erstellen und verwalten. Es ist dieselbe Art von Schlüssel, die auch die REST API verwendet, und jeder Schlüssel gehört zu genau einer Organisation.
Wenn du einen Schlüssel erstellst, wählst du seinen Zugriff:
- Nur lesen (Standard): Der Assistent kann die Daten deiner Organisation lesen, aber nicht verändern.
- Voller Zugriff: Der Assistent kann die Daten deiner Organisation lesen und verändern.
Wenn du nur Fragen stellen möchtest, nutze einen Schlüssel mit Nur lesen. Wähle Voller Zugriff nur für einen Assistenten, mit dem du Änderungen vornehmen willst und dem du das auch zutraust.
Client einrichten
Wähle den Assistenten, den du nutzt. Auf claude.ai und in ChatGPT verbindest du dich direkt im Browser; jeder andere Client benötigt den Endpunkt und deinen API-Schlüssel in seiner Konfiguration.
claude.ai und die Claude-Apps
Der einfachste Weg: ganz ohne Konfigurationsdatei. Öffne auf claude.ai Settings > Connectors, klicke auf Add custom connector und füge den Endpunkt ein:
https://mcp.peerdom.org/mcp
Klicke danach auf Connect. Es öffnet sich eine Peerdom-Seite, die nach dem API-Schlüssel deiner Organisation fragt: einmal einfügen, fertig. Connectors, die du hier hinzufügst, stehen auch in den Claude Desktop- und Mobile-Apps zur Verfügung.
Claude Desktop
Mit einem kostenpflichtigen Claude-Plan deckt der claude.ai-Connector oben auch die Desktop-App ab. Du bevorzugst eine Konfigurationsdatei oder nutzt den Gratisplan? Claude Desktop erreicht entfernte Server über eine kleine Brücke namens mcp-remote. Öffne Settings > Developer > Edit Config und füge hinzu:
{
"mcpServers": {
"peerdom": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.peerdom.org/mcp", "--header", "X-Api-Key:${PEERDOM_API_KEY}"],
"env": { "PEERDOM_API_KEY": "your-api-key" }
}
}
}
Speichere die Datei und starte Claude Desktop neu. Die Peerdom-Tools erscheinen unter dem Connectors-Symbol.
X-Api-Key:${PEERDOM_API_KEY}). Die Brücke trennt das Argument am ersten Leerzeichen, daher vermeidet ein angehängter Wert einen häufigen Verbindungsfehler.
Claude Code
Aus deinem Terminal:
claude mcp add --transport http peerdom https://mcp.peerdom.org/mcp \
--header "X-Api-Key: your-api-key"
Führe claude mcp list aus, um die Verbindung zu bestätigen.
Cursor
Öffne Settings > MCP > Add new MCP server oder bearbeite ~/.cursor/mcp.json direkt:
{
"mcpServers": {
"peerdom": {
"url": "https://mcp.peerdom.org/mcp",
"headers": { "X-Api-Key": "your-api-key" }
}
}
}
VS Code / GitHub Copilot
Füge im Agent-Modus eine Datei .vscode/mcp.json zu deinem Workspace hinzu:
{
"servers": {
"peerdom": {
"type": "http",
"url": "https://mcp.peerdom.org/mcp",
"headers": { "X-Api-Key": "${input:peerdom_key}" }
}
}
}
VS Code fragt beim ersten Mal nach dem Schlüssel und speichert ihn sicher.
ChatGPT
ChatGPT verbindet sich über Plugins (früher Connectors, dann Apps). Aktiviere den Developer mode unter Settings > Plugins > Advanced, füge ein eigenes Plugin hinzu, das auf https://mcp.peerdom.org/mcp zeigt, und wähle OAuth als Authentifizierung. ChatGPT führt dich auf eine Peerdom-Seite, wo du den API-Schlüssel deiner Organisation einmal einfügst: Der Schlüssel wird gegen ein privates Zugriffstoken getauscht und nie bei OpenAI gespeichert.
Für die programmatische Nutzung akzeptiert die OpenAI Responses API unseren Server direkt als mcp-Tool:
{
"type": "mcp",
"server_label": "peerdom",
"server_url": "https://mcp.peerdom.org/mcp",
"headers": { "X-Api-Key": "your-api-key" }
}
Gemini CLI
Bearbeite ~/.gemini/settings.json:
{
"mcpServers": {
"peerdom": {
"httpUrl": "https://mcp.peerdom.org/mcp",
"headers": { "X-Api-Key": "your-api-key" }
}
}
}
Lokale und Schweiz-gehostete Modelle
Da MCP ein offener Standard ist, kannst du alles auf einer Infrastruktur belassen, der du vertraust. Richte einen lokalen MCP-Client wie LM Studio auf den Server aus:
{
"mcpServers": {
"peerdom": {
"url": "https://mcp.peerdom.org/mcp",
"headers": { "X-Api-Key": "your-api-key" }
}
}
}
Kombiniere einen MCP-fähigen Client mit einem lokalen Open-Weight-Modell (zum Beispiel Qwen3, GLM-4.5 oder Gemma) für einen vollständig offline laufenden Stack, oder mit einer schweizerisch-souveränen Modell-API wie Infomaniak für ein in der EU/CH gehostetes Setup. Der Assistent läuft dort, wo du es bestimmst; nur dein API-Schlüssel erreicht Peerdom.
Was heute funktioniert
Der Server unterstützt zwei Wege: einen API-Key-Header, den jeder Assistent der Entwickler- und IDE-Klasse unterstützt, und die Anmeldung per OAuth für Cloud-Chat-Apps wie claude.ai und ChatGPT: Dort fügst du deinen API-Schlüssel einmal auf einer Peerdom-Seite ein, statt ihn in einer Konfigurationsdatei zu speichern.
| Client | Funktioniert heute | Wie | Hinweise |
|---|---|---|---|
| Claude Desktop | ✅ | mcp-remote-Brücke | Die native Connector-Oberfläche hat kein Header-Feld: nutze die Konfiguration oben |
| Claude Code | ✅ | Direkt | Sauberste Lösung |
| Cursor | ✅ | Direkt | headers in mcp.json |
| VS Code / Copilot | ✅ | Direkt | Business/Enterprise: Administrator muss MCP aktivieren |
| ChatGPT: eigene Plugins | ✅ | OAuth-Connector | Developer mode aktivieren, Plugin hinzufügen: keine Konfiguration nötig |
| OpenAI Responses API | ✅ | Direkt | Natives mcp-Tool |
| Gemini CLI | ✅ | Direkt | httpUrl + headers |
| LM Studio / lokale Agenten | ✅ | Direkt | Halte das Modell lokal oder Schweiz-gehostet |
| claude.ai (Web + Apps) | ✅ | OAuth-Connector | Eigenen Connector hinzufügen: keine Konfiguration nötig |
| ChatGPT: Plugin-Verzeichnis | ⏳ | Keine | Noch nicht gelistet: füge es heute als eigenes Plugin hinzu |
| Gemini Consumer-App | ❌ | Keine | Keine Unterstützung für eigene MCP-Server |
Funktion überprüfen
Frage deinen Assistenten: «Mit welcher Organisation bin ich verbunden?» Er sollte mit dem Namen deiner Organisation antworten: Das bestätigt, dass Schlüssel, Verbindung und Datenpfad alle funktionieren.
Um ohne Client zu testen, sende eine Anfrage direkt:
curl -s -X POST https://mcp.peerdom.org/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'X-Api-Key: your-api-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_organization","arguments":{}}}'
Ohne Schlüssel antwortet der Server mit 401 invalid_token; ein ungültiger Schlüssel gibt einen Tool-Fehler zurück, der den Schlüssel als fehlend, ungültig oder abgelaufen meldet.
Häufig gestellte Fragen
Kann der Assistent meine Organisation verändern?
Nur mit einem Schlüssel mit Voller Zugriff. Mit einem Schlüssel mit Nur lesen wird jeder Versuch, etwas zu ändern, abgelehnt: Der Assistent kann lesen, aber nie bearbeiten. Mit Voller Zugriff kann ein Assistent Kolleginnen und Kollegen, Rollen und Gruppen erstellen, bearbeiten und entfernen, Werte eigener Felder setzen, Rollen besetzen und mehr. Die meisten KI-Clients (Claude Desktop, Claude Code, Cursor usw.) zeigen jeden Tool-Aufruf an, bevor sie ihn ausführen, sodass du jede Änderung bestätigen oder abbrechen kannst. Manche Vorgänge lassen sich rückgängig machen (das Löschen einer Kollegin oder eines Kollegen ist ein weiches Löschen, die Person bleibt in deinem Archiv), das Entfernen einer Rolle oder Gruppe dagegen ist endgültig. Nutze einen Assistenten, dem du vertraust, und widerrufe den API-Schlüssel jederzeit, um alle Assistenten auf einmal zu trennen.
Speichert Peerdom meinen API-Schlüssel?
Nein. Dein Schlüssel wird mit jeder Anfrage an die Peerdom API durchgereicht und nie auf dem MCP-Server gespeichert. Widerrufe ihn jederzeit in den Organisationseinstellungen, um alle Assistenten auf einmal zu trennen.
Welche Assistenten kann ich nutzen?
Jeden MCP-Client. Cloud-Chat-Apps wie claude.ai und ChatGPT verbinden sich per OAuth-Anmeldung; Entwickler-Tools setzen einen Request-Header, siehe Was heute funktioniert. Du bist nicht an einen einzelnen Anbieter gebunden: Bring den Assistenten mit, dem du bereits vertraust.
Benötige ich einen bestimmten Peerdom-Plan?
API-Zugang ist in kostenpflichtigen Plänen verfügbar. Kontaktiere den Peerdom-Support für Details zu deinem Plan.
Welche Daten kann der Assistent sehen?
Die vollständigen internen Daten deiner Organisation: Kolleginnen und Kollegen, Rollen und Kreise mit ihrem vollständigen Inhalt (Zweck, Verantwortlichkeiten und eigene Felder), Inhabende, Vakanzen, Auslastung, Ziele und Seiten. Schlüssel mit Nur lesen und mit Voller Zugriff sehen dieselben Daten; sie unterscheiden sich nur darin, ob der Assistent sie verändern kann. Der Zugriff ist auf die eine Organisation beschränkt, zu der der Schlüssel gehört.
Verwandte Artikel
- Bring your own LLM, wähle dein eigenes Modell (Infomaniak, lokal, souverän)
- Agentenlesbarer Export (OKF), veröffentliche deine Organisation, damit jeder KI-Agent sie lesen kann
- API und Webhooks, individuelle Integrationen mit der REST API erstellen
- Integrationen im Überblick, alle verfügbaren Integrationen auf einen Blick
- Zugriffsrechte, verstehen, wer API-Schlüssel erstellen kann
- Organisationseinstellungen, wo du API-Schlüssel findest und widerrufst
- Dein Organigramm kann jetzt Fragen beantworten, die Geschichte hinter dieser Integration