Zum Inhalt springen
Demo buchen Jetzt starten

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.

Dein API-Schlüssel entscheidet, was ein Assistent tun darf. Mit einem Schlüssel mit **Nur lesen** kann er Fragen zu deiner Organisation stellen, aber nichts verändern. Mit einem Schlüssel mit **Voller Zugriff** kann er auch Änderungen vornehmen (Kolleginnen und Kollegen, Rollen und Gruppen erstellen, bearbeiten und entfernen). Widerrufe einen Schlüssel jederzeit, um jeden Assistenten zu trennen, der ihn nutzt.

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.

Behandle jeden API-Schlüssel wie ein Passwort, auch einen mit Nur lesen: Er kann die vollständigen internen Daten deiner Organisation lesen. Füge ihn niemals in ein öffentliches Repository ein, teile ihn nicht in einem Screenshot und speichere ihn nur dort, wo dein Assistenten-Client ihn erreichen kann. Du kannst einen Schlüssel jederzeit in den Organisationseinstellungen widerrufen, was sofort jeden Assistenten trennt, der ihn nutzt.

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.

Individuelle Connectors erfordern einen kostenpflichtigen Claude-Plan. Beim Verbinden wird dein API-Schlüssel gegen ein privates Zugriffstoken getauscht; widerrufst du den Schlüssel in Peerdom, ist der Assistent sofort getrennt.

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.

Beachte, dass der Header kein Leerzeichen nach dem Doppelpunkt hat (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.

In GitHub Copilot Business und Enterprise wird MCP von einem Administrator freigegeben und ist standardmässig deaktiviert. Bitte deinen Copilot-Administrator, MCP-Server zu aktivieren, falls du die Option nicht siehst.

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" }
}
OpenAI benennt diesen Bereich von ChatGPT regelmässig um: Plugins hiessen vorher Apps, davor Connectors. Wandern die Menünamen erneut, such nach der Stelle, an der eigene MCP-Server hinzugefügt werden: Endpunkt und OAuth-Anmeldung bleiben gleich.

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.

Möchtest du das Modell selbst wählen? Die Anleitung Bring your own LLM führt durch ein Entwickler-Setup mit Infomaniaks schweizerisch gehosteter, OpenAI-kompatibler API als durchgespieltes Beispiel.

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.

ClientFunktioniert heuteWieHinweise
Claude Desktop✅mcp-remote-BrückeDie native Connector-Oberfläche hat kein Header-Feld: nutze die Konfiguration oben
Claude Code✅DirektSauberste Lösung
Cursor✅Direktheaders in mcp.json
VS Code / Copilot✅DirektBusiness/Enterprise: Administrator muss MCP aktivieren
ChatGPT: eigene Plugins✅OAuth-ConnectorDeveloper mode aktivieren, Plugin hinzufügen: keine Konfiguration nötig
OpenAI Responses API✅DirektNatives mcp-Tool
Gemini CLI✅DirekthttpUrl + headers
LM Studio / lokale Agenten✅DirektHalte das Modell lokal oder Schweiz-gehostet
claude.ai (Web + Apps)✅OAuth-ConnectorEigenen Connector hinzufügen: keine Konfiguration nötig
ChatGPT: Plugin-Verzeichnis⏳KeineNoch nicht gelistet: füge es heute als eigenes Plugin hinzu
Gemini Consumer-App❌KeineKeine 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