iletiMerkezi MCP-Server

Model Context Protocol-Server für die iletiMerkezi SMS-API. Ermöglicht MCP-fähigen LLM-Clients (Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code+Cline, Claude Desktop, …) das Senden von SMS, das Abfragen von Zustellberichten und die Verwaltung von Absendern/Blacklists durch Tool-Aufrufe.

iletiMerkezi ist eine türkische, BTK-lizenzierte Plattform für Massen-SMS, OTP und A2P. Die Tool-Strukturen (Eingabeschemata, Beschreibungen, Dokumentations-Links) werden aus einem kanonischen API-Manifest abgeleitet, das aus der offiziellen Endpunkt-Dokumentation erstellt wurde. Dadurch bleibt dieser Server konzeptionsbedingt stets synchron mit der Live-API.

Tools

Related MCP server: Promotexter MCP Server

Installation

Fünf Clients teilen sich dasselbe JSON-mcpServers-Schema; Claude Code und Codex CLI bieten zudem einen einzeiligen CLI-Befehl. Wählen Sie Ihren Client unten aus.

Client → Konfigurationsdatei

Gemeinsame JSON-Konfiguration (Claude Code, Cursor, Gemini CLI, VS Code+Cline, Claude Desktop)

Fügen Sie diesen Block zur entsprechenden Konfigurationsdatei hinzu:

{
  "mcpServers": {
    "iletimerkezi": {
      "command": "npx",
      "args": ["-y", "@iletimerkezi/mcp-server"],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}

Beenden Sie den Client vollständig und starten Sie ihn neu. Die 11 Tools erscheinen unter dem iletimerkezi-Server.

Claude Code — einzelner Befehl

Benutzerebene (verfügbar für alle Projekte):

claude mcp add iletimerkezi -s user \
  -e ILETIMERKEZI_API_KEY=your-api-key \
  -e ILETIMERKEZI_API_HASH=your-api-hash \
  -- npx -y @iletimerkezi/mcp-server

Schließen Sie die aktuelle Claude Code-Sitzung und starten Sie eine neue. Die Tools erscheinen als mcp__iletimerkezi__*. Entfernen mit claude mcp remove iletimerkezi -s user.

Codex CLI — TOML-Format

Über die CLI:

codex mcp add iletimerkezi \
  --env ILETIMERKEZI_API_KEY=your-api-key \
  --env ILETIMERKEZI_API_HASH=your-api-hash \
  -- npx -y @iletimerkezi/mcp-server

Oder bearbeiten Sie ~/.codex/config.toml direkt:

[mcp_servers.iletimerkezi]
command = "npx"
args = ["-y", "@iletimerkezi/mcp-server"]

[mcp_servers.iletimerkezi.env]
ILETIMERKEZI_API_KEY = "your-api-key"
ILETIMERKEZI_API_HASH = "your-api-hash"

Überprüfung

Versuchen Sie bei der ersten Verwendung get_balance und get_sender — beide sind schreibgeschützt und verbrauchen kein Guthaben.

Gehostete Clients (ChatGPT Apps, Gemini App, Claude Web Connectors)

Diese Clients erfordern Remote-MCP (HTTPS-Endpunkte) und starten keine lokalen npx-Befehle. Dieser Server wird derzeit nur im stdio-Modus (lokal) ausgeliefert. Unterstützung für gehostete Umgebungen steht auf der Roadmap.

Anmeldedaten

Beide Werte stammen aus panel.iletimerkezi.com → Settings → Security → API Access. Kopieren Sie diese unverändert — hashen Sie sie nicht selbst; das Panel stellt einen vorberechneten Hash bereit.

Sie müssen außerdem Allow API access unter Settings → Security → Access Permissions aktivieren, andernfalls gibt jeder Aufruf 401 zurück. Dies ist der häufigste Fehler bei der Einrichtung; die 401-Fehlermeldung des Servers weist auf diesen Schalter hin.

Den vollständigen Authentifizierungsvertrag finden Sie unter https://www.iletimerkezi.com/docs/api/authentication.

Wie Tool-Strukturen aktuell gehalten werden

Beim Start versucht der Server in dieser Reihenfolge:

1. Lokaler Cache unter ~/.cache/iletimerkezi-mcp/manifest.json, gültig für 24 Stunden.

2. Live-Abruf von https://www.iletimerkezi.com/api/manifest.json (5s Timeout). Bei Erfolg wird der Cache atomar aktualisiert.

3. Build-Zeit-Fallback (dist/manifest.fallback.json), das mit dem npm-Paket ausgeliefert wird — der Manifest-Snapshot zum Zeitpunkt von npm publish.

Das bedeutet, dass neue Endpunkte oder Schema-Änderungen, die im Manifest veröffentlicht werden, innerhalb von 24 Stunden an laufende Clients weitergegeben werden, ohne dass ein npm update erforderlich ist. Es gibt kein manuell geschriebenes Tool-Schema in diesem Repository — die API-Dokumentation ist die einzige Quelle der Wahrheit.

Sie können die Manifest-URL mit ILETIMERKEZI_MANIFEST_URL für Staging-/Vorschau-Umgebungen überschreiben.

Lokale Entwicklung

npm install
npm run build
npm test

Testen Sie den Server gegen die Live-API mit Anmeldedaten in Ihrer Shell:

ILETIMERKEZI_API_KEY=... ILETIMERKEZI_API_HASH=... node dist/index.js

Dies kommuniziert via MCP über stdio. Verwenden Sie einen MCP-Client zur Interaktion oder leiten Sie einen JSON-RPC-Handshake manuell für das Debugging weiter.

Referenz

• MCP-Einrichtungsanleitung: https://www.iletimerkezi.com/docs/mcp (TR) · /en/docs/mcp (EN)

• Übersicht: https://www.iletimerkezi.com/docs/api/overview

• Authentifizierung: https://www.iletimerkezi.com/docs/api/authentication

• Fehlercodes: https://www.iletimerkezi.com/docs/api/error-codes

• Manifest (maschinenlesbar): https://www.iletimerkezi.com/api/manifest.json

• Versionshinweise: CHANGELOG.md

Lizenz

MIT — siehe LICENSE.