Telinfy MCP server

Telinfy MCP-Integrationsleitfaden

So verbinden und nutzen Sie den Telinfy MCP-Server mit KI-Assistenten

Der Telinfy MCP-Server bietet programmatischen Zugriff auf die SMS-, WhatsApp- und RCS-Messaging-Funktionen von Telinfy und ermöglicht es KI-Assistenten, Nachrichten zu versenden, Kontakte zu verwalten, Kampagnen zu planen und Berichte in Ihrem Auftrag abzurufen.

---

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Anwendungen ermöglicht, sich sicher mit MCP-kompatiblen Datenquellen und Werkzeugen zu verbinden. Stellen Sie sich MCP wie einen USB-C-Anschluss für KI-Anwendungen vor – eine standardisierte Möglichkeit, KI-Apps mit verschiedenen Diensten zu verbinden.

---

Telinfy MCP-Server

Der Telinfy MCP-Server ist ein sicherer, authentifizierter Dienst, der Zugriff auf Ihre Telinfy-Messaging-Plattform bietet.

Basis-Server-URL: https://mcp.telinfy.com/sse

Authentifizierung erforderlich

Um den Telinfy MCP-Server zu nutzen, benötigen Sie:

• Telinfy-Benutzername
• Telinfy-Passwort
• API-Anmeldeinformationen (werden nach dem Login automatisch abgerufen)

---

Verfügbare Werkzeuge

Der Telinfy MCP-Server bietet umfassende Werkzeuge für Messaging und Kampagnenmanagement:

SMS-Operationen

1. send_sms – SMS-Nachrichten mit DLT-Konformität versenden
2. schedule_sms – SMS-Kampagnen für zukünftige Zustellung planen
3. scheduleDynamicCampaign – Dynamische SMS-Kampagnen mit Excel-Dateien und Vorlagenvariablen planen
4. get_sms_schedule – Alle geplanten SMS-Kampagnen anzeigen
5. fetch_sms_campaign_report – Detaillierte Berichte für SMS-Kampagnen abrufen

WhatsApp-Operationen

1. send_whatsapp_campaign – WhatsApp-Nachrichten mit vorerstellten Vorlagen versenden
2. whatsapp_campaign – Alle WhatsApp-Kampagnen auflisten
3. fetch_whatsapp_smart_report – WhatsApp-Kampagnenberichte mit Datumsfilterung abrufen

RCS-Operationen

1. fetch_rcs_report – RCS-Nachrichtenberichte mit Datumsfilterung abrufen

Kontaktverwaltung

1. create_phonebook – Neue Telefonbuchgruppen mit Kontakten erstellen
2. get_phonebook_groups – Alle Telefonbuchgruppen auflisten
3. get_group_contacts – Kontakte innerhalb einer bestimmten Gruppe anzeigen
4. edit_contact – Kontaktinformationen aktualisieren
5. toggle_contact_status – Kontakte in einer Gruppe aktivieren/deaktivieren
6. delete_contact_group – Telefonbuchgruppen entfernen

Nachrichtenberichte

1. getMessageReport – Zustellberichte und Status für gesendete Nachrichten abrufen

Authentifizierung

1. login_to_telinfy – Authentifizieren und eine Sitzung mit der Telinfy-Plattform aufbauen

---

Übertragungsprotokoll

Der Telinfy MCP-Server verwendet das SSE-Protokoll (Server-Sent Events):

SSE (Server-Sent Events) - /sse

• URL: https://mcp.telinfy.com/sse
• Die offizielle MCP-Spezifikationsversion
• Unterstützt von Claude, Windsurf, Cursor und anderen MCP-Clients
• Empfohlen für alle Integrationen

---

Einrichtungsanleitung

Für Claude Desktop/Web:

1. Gehen Sie zu Ihren Claude-Einstellungen
2. Navigieren Sie zu „Integrationen“ oder „Verbindungen“
3. Fügen Sie einen neuen MCP-Server mit diesen Details hinzu:
   • Name: Telinfy
   • Server-URL: https://mcp.telinfy.com/sse
4. Speichern Sie die Konfiguration

Für Claude Code (Befehlszeile):

claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse

Für Windsurf, Cursor oder andere MCP-Clients:

Fügen Sie diese Konfiguration zu Ihrer MCP-Einstellungsdatei hinzu:

{ "mcpServers": { "telinfy": { "serverUrl": "https://mcp.telinfy.com/sse" } } }

---

Verwendung von Telinfy MCP

Ersteinrichtung

Nachdem Sie den MCP-Server verbunden haben, müssen Sie sich mit Ihren Telinfy-Anmeldeinformationen authentifizieren:

Claude, please log me into Telinfy using my username and password.

Der KI-Assistent verwendet das Werkzeug login_to_telinfy, um eine sichere Sitzung aufzubauen.

Beispielanwendungsfälle

Eine SMS-Kampagne versenden

Send an SMS to +919876543210 with the message "Your OTP is 123456" 
using sender name "NOTIFY" and template ID "1234567890"

Eine Marketingkampagne planen

Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM 
to these numbers: +919876543210, +919876543211 with the message 
"Flash Sale this weekend! 50% off. Visit now."

Eine Kontaktgruppe erstellen

Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211

WhatsApp-Nachrichten versenden

Send a WhatsApp campaign using my "order_confirmation" template 
to +919876543210 with customer name "John" and order number "ORD123"

Kampagnenberichte abrufen

Show me the SMS campaign report for campaign ID "12345"

Nachrichtenzustellstatus abrufen

Get the delivery status for all messages sent today

---

Hauptfunktionen

DLT-Konformität

Alle SMS-Kampagnen unterstützen DLT-Konformität (Distributed Ledger Technology) mit Vorlagen-IDs und Absendernamen, um die Einhaltung gesetzlicher Vorschriften in Indien zu gewährleisten.

Dynamische Kampagnen

Planen Sie personalisierte SMS-Kampagnen mit Excel-Dateien und Variablenersetzung, perfekt für personalisierte Massennachrichten.

Mehrkanal-Messaging

• SMS – Werbe- und Transaktionsrouten
• WhatsApp – Vorlagenbasiertes Business-Messaging
• RCS – Rich Communication Services

Umfassende Berichterstattung

Verfolgen Sie die Nachrichtenzustellung und Kampagnenleistung und erstellen Sie detaillierte Berichte mit Datumsfilterung.

Organisieren Sie Kontakte in Gruppen, aktivieren/deaktivieren Sie Kontakte und pflegen Sie übersichtliche Telefonbuchlisten.

---

Sicherheit & Authentifizierung

• Alle API-Aufrufe werden mit Ihren Telinfy-Anmeldeinformationen authentifiziert
• Sichere tokenbasierte Authentifizierung nach dem ersten Login
• Sitzungen werden für die Dauer Ihrer Konversation aufrechterhalten
• Es werden keine Anmeldeinformationen vom KI-Assistenten gespeichert

---

Support & Ressourcen

• Telinfy-Dashboard: https://telinfy.com
• API-Dokumentation: Kontaktieren Sie den Telinfy-Support für detaillierte API-Dokumentation
• MCP-Protokoll: https://modelcontextprotocol.io
• Support: Kontaktieren Sie Ihren Telinfy-Kundenbetreuer

---

Fehlerbehebung

Authentifizierungsprobleme

Wenn Sie Login-Probleme haben:

1. Überprüfen Sie, ob Benutzername und Passwort korrekt sind
2. Prüfen Sie, ob Ihr Konto für den API-Zugriff freigeschaltet ist
3. Kontaktieren Sie den Telinfy-Support, um sicherzustellen, dass Ihr Konto MCP-Zugriff hat

Verbindungsprobleme

Wenn der MCP-Server keine Verbindung herstellt:

1. Überprüfen Sie, ob die Server-URL genau ist: https://mcp.telinfy.com/sse
2. Überprüfen Sie Ihre Internetverbindung
3. Versuchen Sie, den MCP-Server in Ihren KI-Client-Einstellungen erneut zu verbinden

Probleme bei der Nachrichtenzustellung

Wenn Nachrichten nicht gesendet werden:

1. Stellen Sie sicher, dass Sie ausreichend Guthaben auf Ihrem Telinfy-Konto haben
2. Überprüfen Sie, ob die DLT-Vorlagen-IDs korrekt registriert sind
3. Prüfen Sie, ob die Absendernamen in Ihrem Telinfy-Konto genehmigt sind
4. Bestätigen Sie, dass die Telefonnummern das richtige Format haben

---

Bewährte Praktiken

1. Immer zuerst einloggen – Authentifizieren Sie sich zu Beginn jeder Sitzung
2. Korrekte Vorlagen-IDs verwenden – Stellen Sie sicher, dass DLT-Vorlagen mit Ihrem Nachrichteninhalt übereinstimmen
3. Telefonformate überprüfen – Verwenden Sie 10-stellige indische Nummern oder das internationale Format mit Ländervorwahl
4. Kampagnenberichte prüfen – Überwachen Sie den Zustellstatus regelmäßig
5. Kontakte effizient verwalten – Halten Sie Telefonbuchgruppen organisiert
6. Vor Massenversand testen – Senden Sie Testnachrichten vor großen Kampagnen

---

Beispiel-Workflow

Hier ist ein vollständiger Workflow zum Versenden einer Kampagne:

1. Authentifizieren

Log me into Telinfy with username "myuser" and password "mypass"  

2. Kontaktgruppe erstellen

Create a phonebook group "Spring Sale 2024" with my customer list  

3. Kampagne planen

Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024"  
group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items.  
Shop now at example.com" using sender "RETAIL" and template "1234567890"  

4. Ergebnisse überwachen

Show me the delivery report for the Spring Sale campaign  

---

Erweiterte Funktionen

Dynamische Variablenersetzung

Verwenden Sie Excel-Dateien, um personalisierte Nachrichten in großem Umfang zu versenden:

• Excel mit Spalten hochladen: Mobile, Name, OrderID, Amount
• Variablen zuordnen: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• Vorlage: „Hallo {{1}}, Ihre Bestellung {{2}} über Rs.{{3}} ist bestätigt“

Mehrrouten-SMS

• Route 0: Werbenachrichten
• Route 1: Transaktionsnachrichten (OTPs, Benachrichtigungen)

Unicode-Unterstützung

Senden Sie Nachrichten in regionalen Sprachen, indem Sie den Unicode-Modus aktivieren.

---

Checkliste für den Einstieg

• Telinfy MCP-Server mit Ihrem KI-Assistenten verbinden
• Mit Ihren Telinfy-Anmeldeinformationen authentifizieren
• Überprüfen, ob aktive Absendernamen und DLT-Vorlagen vorhanden sind
• Kontostand und Guthaben prüfen
• Vor Massenkampagnen mit einer einzelnen SMS testen
• Organisierte Telefonbuchgruppen erstellen
• Geplante Kampagnen für optimale Zeitpunkte einrichten
• Berichte regelmäßig überwachen

---

Für detaillierte API-Spezifikationen und Parameterreferenzen lesen Sie die Telinfy-API-Dokumentation oder kontaktieren Sie Ihren Kundenbetreuer.