MCP Server

Der seven Model Context Protocol-Server ermöglicht es KI-Assistenten wie Claude Desktop, Claude Code und Cursor, direkt mit der seven.io-API zu interagieren. SMS, RCS, Voice, Lookups, Kontakte und Account-Verwaltung stehen als über 40 Tools in 12 Kategorien zur Verfügung.

Der Server wird als npm-Paket @seven.io/mcp bereitgestellt und läuft lokal über npx mit dem MCP-stdio-Transport. Den Quellcode finden Sie auf GitHub.

Installation

npm install -g @seven.io/mcp

Eine globale Installation ist nicht zwingend erforderlich — npx @seven.io/mcp lädt die jeweils aktuelle Version automatisch nach, sobald der MCP-Client den Server startet.

Authentifizierung

Der Server unterstützt zwei Authentifizierungsmethoden. Empfohlen wird OAuth 2.0 mit PKCE — automatische Token-Erneuerung, feingranulare Scopes und sichere Speicherung der Tokens im Schlüsselbund Ihres Betriebssystems. Sind beide Methoden konfiguriert, hat OAuth Vorrang.

Variante 1: OAuth 2.0 (empfohlen)

Führen Sie den Login einmalig aus. Dabei öffnet sich Ihr Browser, die benötigten Scopes (SMS, Voice, RCS, …) werden angefragt und die Tokens lokal gespeichert.

npx @seven.io/mcp login

Weitere CLI-Befehle:

# Anmeldestatus anzeigen
npx @seven.io/mcp status

# Gespeicherte Tokens entfernen
npx @seven.io/mcp logout

Variante 2: API-Key (Legacy)

Setzen Sie die Umgebungsvariable SEVEN_API_KEY. Ihren Schlüssel erstellen Sie im seven.io-Dashboard.

export SEVEN_API_KEY="ihr-api-schluessel"

Headless- oder Remote-Setups

Der OAuth-Login benötigt einen Browser auf demselben Rechner, der 127.0.0.1:7177 / 9437 / 8659 erreichen kann. Läuft der MCP-Server auf einem Headless-System oder per SSH ohne Port-Forwarding, weichen Sie auf den API-Key (Variante 2) aus — dieser Weg kommt ohne Browser aus.

Schnellstart

Tragen Sie den Server in die Konfiguration Ihres MCP-Clients ein und starten Sie den Client neu.

Claude Desktop

Bearbeiten Sie die claude_desktop_config.json:

Mit OAuth (empfohlen) — vorab einmalig npx @seven.io/mcp login ausführen:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"]
    }
  }
}

Mit API-Key:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"],
      "env": {
        "SEVEN_API_KEY": "ihr-api-schluessel"
      }
    }
  }
}

Claude Code

claude mcp add seven npx @seven.io/mcp

Cursor

Tragen Sie den Server in die .cursor/mcp.json Ihres Projekts ein:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"]
    }
  }
}

Verfügbare Tools

Der Server stellt über 40 Tools bereit, gruppiert nach Funktion.

Messaging

Account

Lookup

Status & Logbuch

Rufnummern

Kontakte

Gruppen

Subaccounts

Webhooks

Absender

Beispiele

Ist der Server verbunden, lassen sich die Tools in natürlicher Sprache nutzen — der MCP-Client wählt das passende Tool automatisch aus.

SMS versenden:

Schick eine SMS an +49170123456789 mit dem Text ‚Bestellung versendet — Tracking unter example.com/t/abc123'.

Der Assistent ruft send_sms auf.

Guthaben prüfen:

Wie hoch ist mein seven.io-Guthaben?

Der Assistent ruft get_balance auf.

Carrier-Lookup und RCS-Check:

Welcher Provider gehört zu +49170123456789, und unterstützt die Nummer RCS?

Der Assistent verkettet lookup_mnp und lookup_rcs.

Debug-Logging

Mit SEVEN_LOG_FILE werden alle API-Requests und -Responses in eine Datei geschrieben. Hilfreich, wenn ein Tool-Aufruf nicht wie erwartet funktioniert.

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"],
      "env": {
        "SEVEN_API_KEY": "ihr-api-schluessel",
        "SEVEN_LOG_FILE": "/tmp/mcp-seven-debug.log"
      }
    }
  }
}

Dann live mitlesen:

tail -f /tmp/mcp-seven-debug.log

Ressourcen

• GitHub-Repository
• npm-Paket
• Model-Context-Protocol-Spezifikation
• Issue-Tracker