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 — Peers, 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 Settings > My Data > API Keys in den Organisationseinstellungen und klicke auf Create a key. Nur Benutzer mit Owner-Zugriffsrechten 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. Jeder benötigt den Endpunkt und deinen API Key in seiner Konfiguration.

Claude Desktop

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 unterstützt individuelle MCP-Server im Developer Mode (Beta). Aktiviere ihn unter Settings > Connectors > Advanced > Developer mode und füge dann einen Connector hinzu, der auf https://mcp.peerdom.org/mcp zeigt.

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" }
}

Die veröffentlichten Connectors der ChatGPT-Consumer-App erfordern OAuth, das der Peerdom-Server noch nicht bietet — nutze daher vorerst den Developer Mode oder die Responses API. OAuth-Unterstützung kommt bald (siehe Was heute funktioniert).

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 authentifiziert sich über einen API-Key-Header, den jeder Assistent der Entwickler- und IDE-Klasse unterstützt. Cloud-Chat-Apps, die nur die Anmeldung per OAuth akzeptieren, sind noch nicht erreichbar — das ist ein einzelnes geplantes Feature, keine Einschränkung deiner Daten.

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 — Developer Mode	✅	Direkt	Beta; prüfe das Feld für individuelle Header in der Oberfläche
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)	⏳	—	Individuelle Connectors erfordern OAuth — kommt bald
ChatGPT — veröffentlichte Connectors	⏳	—	Erfordern OAuth — kommt bald
Gemini Consumer-App	❌	—	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":{}}}'

Ein fehlender oder ungültiger Key gibt 401 Missing X-Api-Key header zurück.

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, mit dem du einen Request-Header setzen kannst — 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 Peers, Rollen, Kreise, Inhaber/innen, Vakanzen und die Auslastung deiner Organisation. Es ist auf die eine Organisation beschränkt, zu der der Key gehört.

Wie können wir dir helfen?