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 Key. Auf deiner Seite musst du nichts installieren, und du bist in etwa einer Minute startklar.

Der MCP-Server ist heute schreibgeschützt: Assistenten können deine Organisation abfragen, sie aber nicht verändern. Sichere, klar abgegrenzte Schreibaktionen sind geplant und kommen in einer späteren Version.

Was du fragen kannst

Sobald die Verbindung steht, kannst du deinen 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.»

Im Hintergrund nutzt der Assistent eine Reihe von Lesewerkzeugen - Kolleginnen und Kollegen, Rollen und Kreise auflisten und untersuchen, vakante Rollen finden und die Auslastung über die Organisation hinweg zusammenfassen - 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 Key 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 Keys erstellen und verwalten. Es ist derselbe Key, den auch die REST API verwendet: ein Key pro Organisation.

Dein API Key gewährt vollen Lesezugriff auf die Daten deiner Organisation: Behandle ihn wie ein Passwort. Füge ihn niemals in ein öffentliches Repository ein und teile ihn nicht in einem Screenshot. Du kannst einen Key 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 Key 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 Key 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 Key gegen ein privates Zugriffstoken getauscht; widerrufst du den Key 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 Key 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 Key deiner Organisation einmal einfügst: Der Key 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 Key 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 Key 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 individuelle MCP

Funktion überprüfen

Frage deinen Assistenten: „Mit welcher Organisation bin ich verbunden?“ Er sollte mit dem Namen deiner Organisation antworten: Das bestätigt, dass Key, 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 Key antwortet der Server mit 401 invalid_token; ein ungültiger Key gibt einen Tool-Fehler zurück, der den Key als fehlend, ungültig oder abgelaufen meldet.

Häufig gestellte Fragen

Kann der Assistent meine Organisation verändern?

Nein. Der MCP-Server ist heute schreibgeschützt: Assistenten können deine Daten lesen und zusammenfassen, aber nichts erstellen, bearbeiten oder löschen. Sichere, klar abgegrenzte Schreibaktionen kommen in einer späteren Version.

Speichert Peerdom meinen API Key?

Nein. Dein Key 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?

Alles, was dein API Key lesen kann: die Kolleginnen und Kollegen, Rollen, Kreise, Inhabende, Vakanzen und die Auslastung deiner Organisation. Es ist auf die eine Organisation beschränkt, zu der der Key gehört.