Serveur MCP

Le serveur Model Context Protocol de seven permet à des assistants IA comme Claude Desktop, Claude Code et Cursor d'interagir directement avec l'API seven.io. Il expose les SMS, le RCS, la voix, les recherches, les contacts et la gestion de compte sous forme de plus de 40 outils répartis en 12 catégories.

Le serveur est distribué sous forme de paquet npm @seven.io/mcp et s'exécute en local via npx sur le transport stdio de MCP. Le code source se trouve sur GitHub.

Installation

npm install -g @seven.io/mcp

L'installation globale n'est pas obligatoire — npx @seven.io/mcp télécharge la dernière version à la demande lorsque le client MCP démarre le serveur.

Authentification

Le serveur prend en charge deux méthodes d'authentification. OAuth 2.0 avec PKCE est recommandé — il offre un rafraîchissement automatique des jetons, des scopes fins et stocke les jetons en sécurité dans le trousseau de votre système d'exploitation. Si les deux méthodes sont configurées, OAuth est prioritaire.

Option 1 : OAuth 2.0 (recommandé)

Exécutez la commande de connexion une seule fois. Elle ouvre votre navigateur, demande les scopes nécessaires (SMS, Voix, RCS, …) et stocke les jetons.

npx @seven.io/mcp login

Autres commandes CLI :

# Vérifier votre statut de connexion
npx @seven.io/mcp status

# Supprimer les jetons stockés
npx @seven.io/mcp logout

Option 2 : clé API (héritée)

Définissez la variable d'environnement SEVEN_API_KEY. Créez votre clé dans le tableau de bord seven.io.

export SEVEN_API_KEY="votre-cle-api"

Configurations headless ou distantes

Le flux de connexion OAuth nécessite un navigateur sur la même machine, capable d'atteindre 127.0.0.1:7177 / 9437 / 8659. Si vous exécutez le serveur MCP sur un système sans interface graphique ou via SSH sans redirection de ports, repliez-vous sur la clé API (Option 2) — cette voie ne nécessite pas de navigateur.

Démarrage rapide

Ajoutez le serveur à la configuration de votre client MCP et redémarrez le client.

Claude Desktop

Modifiez votre fichier claude_desktop_config.json :

Avec OAuth (recommandé) — exécutez d'abord npx @seven.io/mcp login :

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

Avec une clé API :

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

Claude Code

claude mcp add seven npx @seven.io/mcp

Cursor

Ajoutez le serveur au fichier .cursor/mcp.json de votre projet :

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

Outils disponibles

Le serveur fournit plus de 40 outils regroupés par fonctionnalité.

Messagerie

Compte

Recherche

Statut et journal

Numéros de téléphone

Contacts

Groupes

Sous-comptes

Webhooks

Expéditeur

Exemples

Une fois le serveur connecté, vous pouvez interroger l'assistant en langage naturel. Le client MCP choisit automatiquement le bon outil.

Envoyer un SMS :

Envoie un SMS au +49170123456789 avec le texte 'Commande expédiée — suivi sur example.com/t/abc123'.

L'assistant appelle send_sms.

Vérifier le solde :

Quel est le solde de mon compte seven.io ?

L'assistant appelle get_balance.

Recherche d'opérateur et vérification RCS :

Trouve l'opérateur du +49170123456789 et dis-moi si le numéro prend en charge RCS.

L'assistant enchaîne lookup_mnp et lookup_rcs.

Journalisation de débogage

Définissez SEVEN_LOG_FILE pour enregistrer chaque requête et réponse API dans un fichier. Utile lorsqu'un appel d'outil ne se comporte pas comme prévu.

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

Suivez ensuite le fichier de log en direct :

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

Ressources

• Dépôt GitHub
• Paquet npm
• Spécification du Model Context Protocol
• Suivi des problèmes