MCP-Server

Der FirstReply-MCP-Server stellt Ihren Workspace als Werkzeuge für einen KI-Assistenten bereit, der das Model Context Protocol spricht — Claude Desktop, Claude Code und alles andere mit MCP-Unterstützung.

Damit verbunden können Sie einen Assistenten bitten, mit Ihnen die Warteschlange durchzugehen: „was ist über Nacht gekommen, das niemand beantwortet hat", „entwirf eine Antwort auf die Batteriebeschwerde", „wie viele Konversationen haben wir letzte Woche geschlossen".

Installieren

Sie brauchen Node.js 18 oder neuer und einen API-Schlüssel für den Workspace.

Claude Desktop

Fügen Sie den Server in Ihre MCP-Konfiguration ein:

{
  "mcpServers": {
    "firstreply": {
      "command": "npx",
      "args": ["-y", "@firstreply/mcp"],
      "env": {
        "FIRSTREPLY_API_TOKEN": "fr_..."
      }
    }
  }
}

Claude Code

claude mcp add firstreply --env FIRSTREPLY_API_TOKEN=fr_... -- npx -y @firstreply/mcp

Über HTTP

Der Server läuft auch als zustandsloser Streamable-HTTP-Dienst, um ihn zentral statt auf jedem Rechner zu betreiben:

npm run build && npm run start:http   # lauscht auf :8080

Jede Anfrage muss Authorization: Bearer fr_... mitführen. Ein /health-Endpunkt steht für Prüfungen bereit.

Konfiguration

Variable	Beschreibung
FIRSTREPLY_API_TOKEN	API-Schlüssel des Workspace, im stdio-Modus
FIRSTREPLY_API_URL	Basis-URL der API, Standard https://api.firstreply.ai
PORT	HTTP-Port im HTTP-Modus, Standard 8080
MCP_ENDPOINT_PATH	HTTP-Endpunktpfad, Standard /

Was der Assistent kann

Workspace

Werkzeug	Tut
organization_list	Die erreichbaren Workspaces auflisten
inbox_list	Die verbundenen Kanäle auflisten
member_list	Das Team auflisten
api_key_list	API-Schlüssel auflisten, nur Metadaten
api_key_create	Einen Schlüssel anlegen; das Geheimnis kommt einmal zurück
api_key_delete	Einen Schlüssel widerrufen

Konversationen

Werkzeug	Tut
conversation_list	Konversationen auflisten und filtern
conversation_get	Eine Konversation lesen
conversation_messages	Ihre Nachrichten lesen
conversation_reply	Eine Antwort an den Kunden senden
conversation_close	Eine Konversation schließen
conversation_update	Zuweisen, Priorität ändern, neu klassifizieren
conversation_stats	Statistiken für einen Zeitraum
conversation_totals	Aktuelle offene und ungelesene Summen

KI

Werkzeug	Tut
ai_draft_reply	Einen Entwurf erzeugen, ohne zu senden

Berechtigungen und Sicherheit

Ein API-Schlüssel handelt mit den Berechtigungen des Workspace-Inhabers. Es gibt keinen engeren Geltungsbereich, ein an einen MCP-Server gegebener Schlüssel kann also alles im Workspace — einschließlich Antworten an echte Kunden zu senden.

Zwei Werkzeuge erreichen die Außenwelt: conversation_reply sendet an einen Kunden, und api_key_delete widerruft Zugriff. Alles andere ist lesend oder intern.

Praktische Hinweise:

• Legen Sie einen eigenen Schlüssel für den MCP-Server an, statt einen bestehenden weiterzuverwenden.
• Lassen Sie die Bestätigungsabfragen Ihres MCP-Clients für conversation_reply an. Die Warteschlange zu lesen ist sicher automatisierbar; sie zu beantworten nicht.
• Bevorzugen Sie ai_draft_reply im Arbeitsablauf und senden Sie nach dem Lesen des Entwurfs aus dem Posteingang.
• Rotieren Sie, indem Sie einen neuen Schlüssel anlegen und den alten löschen.

Quellcode

Der Server ist quelloffen und als @firstreply/mcp auf npm veröffentlicht, unter MIT-Lizenz.