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.

Sie haben zwei Möglichkeiten, den Server einzubinden:

• Hosted-Server (URL) - direkte Anbindung an https://mcp.seven.io/mcp ohne Installation. Streamable-HTTP-Transport, OAuth-Login automatisch im Browser.
• Lokale Installation (npx) - das npm-Paket @seven.io/mcp wird per npx über den MCP-stdio-Transport gestartet. Quellcode auf GitHub.

Hosted-Server (URL)

Tragen Sie die URL https://mcp.seven.io/mcp in Ihrem MCP-Client ein. Der Server nutzt den Streamable-HTTP-Transport (kein SSE) und OAuth 2.0 mit PKCE über die Authorization-Server-Discovery.

Claude Code

claude mcp add --transport http seven https://mcp.seven.io/mcp

Cursor

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

{
  "mcpServers": {
    "seven": {
      "url": "https://mcp.seven.io/mcp"
    }
  }
}

Claude Desktop

Am einfachsten über die UI: Einstellungen → Connectors → Add custom connector, URL https://mcp.seven.io/mcp eintragen. Claude startet anschließend den OAuth-Login im Browser.

Alternativ über die claude_desktop_config.json mit der mcp-remote-Bridge:

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

Authentifizierung

Beim ersten Verbindungsaufbau erkennt der MCP-Client automatisch den OAuth-Endpoint, öffnet Ihren Browser, fragt die benötigten Scopes (SMS, Voice, RCS, …) ab und speichert die Tokens. Ein manueller Login-Schritt ist nicht nötig.

Lokale Installation (npx)

Das npm-Paket @seven.io/mcp wird vom MCP-Client per npx gestartet. Eine globale Installation ist nicht nötig - npx lädt die jeweils aktuelle Version automatisch nach. Wer es dennoch möchte:

npm install -g @seven.io/mcp

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"]
    }
  }
}

Claude Desktop

Bearbeiten Sie die claude_desktop_config.json:

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

Authentifizierung

Die lokale Variante unterstützt zwei Methoden. 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.

OAuth 2.0 (empfohlen)

Führen Sie den Login einmalig aus. Dabei öffnet sich Ihr Browser, die benötigten Scopes 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

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"

In der Client-Konfiguration:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"],
      "env": {
        "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 Hosted-Server (URL) aus oder nutzen die API-Key-Variante - beide Wege kommen ohne lokalen Browser aus.

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.

Preise nach Land:

Was kostet eine SMS nach Frankreich, Spanien und in die USA?

Der Assistent ruft get_pricing auf und filtert die Ergebnisse.

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.

Erreichbarkeit prüfen, dann senden:

Prüfe per HLR, ob +49170123456789 erreichbar ist. Wenn ja, sende eine SMS mit 'Termin morgen 10 Uhr'.

Der Assistent ruft lookup_hlr auf und entscheidet anhand des Ergebnisses, ob send_sms ausgeführt wird.

Subaccount anlegen und Guthaben übertragen:

Lege einen Subaccount für unser neues Team an und transferiere 50 Euro Guthaben dorthin.

Der Assistent verkettet create_subaccount und transfer_credits.

Fehlerbehebung

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