GramClaw stellt denselben Telegram-Motor auf zwei Wegen bereit: eine REST API für eigene Automatisierung und einen entfernten MCP-Server (Model Context Protocol) für KI-Agenten. Beide authentifizieren sich mit einem API-Schlüssel, den du in den Einstellungen erstellst, beide respektieren dieselbe Taktung pro Konto, die deine Telegram-Konten gesund hält, und beide erfordern ein aktives Abonnement oder eine aktive Testphase.
In der Praxis: Die REST API ist für Code — Kontakte aus deinem Produkt synchronisieren, eine Kampagne auslösen, wenn sich ein Nutzer registriert, Unterhaltungen in dein Data Warehouse leiten. Der MCP-Server ist für Agenten — Claude Desktop, Claude Code, Cursor oder dein eigener Agent bekommt Tools, um Chats aufzulisten, Nachrichten zu lesen, Antworten zu senden, Broadcasts zu fahren und die Pipeline zu verwalten, ganz ohne eine Zeile Code.
Einen API-Schlüssel erstellen
- 1
Einstellungen → API-Schlüssel öffnen
Erzeuge einen Schlüssel und wähle seine Scopes — read zum Auflisten und Lesen von Daten, send für alles, was schreibt oder Nachrichten sendet. Beschränke Schlüssel auf das Minimum, das sie brauchen.
- 2
Einmal kopieren
Der vollständige Schlüssel (gc_live_…) wird nur bei der Erstellung angezeigt — bewahre ihn in einem Secrets-Manager auf. Falls er durchsickert, lösche ihn in den Einstellungen, und er funktioniert sofort nicht mehr.
- 3
Authentifizieren
REST: Sende ihn als Authorization: Bearer Header. MCP: Trage ihn als key-Parameter in die Server-URL ein.
Die REST API in einer Minute
Die API deckt die gesamte Plattformoberfläche ab: Konten, Chats, Nachrichten, Kontakte, Kampagnen, Broadcasts, Pipeline-Spalten und Analytics. Anfragen sind schlichtes JSON über HTTPS. Die vollständige Endpunkt-Dokumentation — jede Route, ihre Scopes und Request-/Response-Beispiele — liegt auf der API-Dokumentationsseite, und eine maschinenlesbare OpenAPI-Spezifikation ist unter /openapi.json verfügbar, für Codegenerierung oder um sie einem LLM zu geben.
Den MCP-Server verbinden
- 1
Die Server-URL kopieren
https://gramclaw.com/api/mcp?key=gc_live_… — der Schlüssel identifiziert und autorisiert dich zugleich, beschränkt auf die Konten, auf die er wirken darf.
- 2
In deinem MCP-Client hinzufügen
Claude Desktop, Claude Code, Cursor oder jeder MCP-kompatible Client akzeptiert eine entfernte Server-URL. Keine lokale Installation, kein Proxy.
- 3
Echte Arbeit anfordern
Einmal verbunden, kann dein Agent Chats durchsuchen, Antworten entwerfen und senden, Kampagnen starten, den Kampagnenstatus prüfen und Deals durch die Pipeline bewegen — jeder Versand unterliegt derselben Konto-Taktung wie der Rest von GramClaw.
Bewährte Praktiken
- Ein Schlüssel pro Integration, entsprechend benannt — so macht das Widerrufen einer Sache nie eine andere kaputt.
- Bevorzuge Nur-Lese-Scopes für Dashboards und Analytics-Jobs.
- Rotiere Schlüssel, wenn Teammitglieder gehen, und lösche Schlüssel, die du nicht mehr nutzt — der Widerruf wirkt sofort.
- Denk daran, dass API- und MCP-Sendungen echte Telegram-Nachrichten von deinen echten Konten sind: Es gilt dasselbe Urteilsvermögen zu Einwilligung und Volumen wie in der App.