Servidor MCP

El servidor Model Context Protocol de seven permite que asistentes de IA como Claude Desktop, Claude Code y Cursor interactúen directamente con la API de seven.io. Expone SMS, RCS, voz, búsquedas, contactos y gestión de cuenta como más de 40 herramientas en 12 categorías.

El servidor se distribuye como el paquete npm @seven.io/mcp y se ejecuta localmente mediante npx sobre el transporte stdio de MCP. El código fuente está disponible en GitHub.

Instalación

npm install -g @seven.io/mcp

También puede omitir la instalación global — npx @seven.io/mcp descargará la última versión bajo demanda cada vez que el cliente MCP inicie el servidor.

Autenticación

El servidor admite dos métodos de autenticación. Se recomienda OAuth 2.0 con PKCE — proporciona renovación automática de tokens, scopes detallados y almacena los tokens de forma segura en el llavero de su sistema operativo. Si ambos métodos están configurados, OAuth tiene prioridad.

Opción 1: OAuth 2.0 (recomendado)

Ejecute el comando de inicio de sesión una vez. Abrirá su navegador, solicitará los scopes necesarios (SMS, Voz, RCS, …) y guardará los tokens.

npx @seven.io/mcp login

Otros comandos CLI:

# Mostrar si está autenticado
npx @seven.io/mcp status

# Eliminar los tokens almacenados
npx @seven.io/mcp logout

Opción 2: clave API (legado)

Defina la variable de entorno SEVEN_API_KEY. Cree su clave en el panel de seven.io.

export SEVEN_API_KEY="su-clave-api"

Configuraciones headless o remotas

El flujo de inicio de sesión OAuth necesita un navegador en la misma máquina que pueda acceder a 127.0.0.1:7177 / 9437 / 8659. Si ejecuta el servidor MCP en un sistema sin interfaz gráfica o por SSH sin reenvío de puertos, recurra a la clave API (Opción 2) — ese método no requiere navegador.

Inicio rápido

Añada el servidor a la configuración de su cliente MCP y reinicie el cliente.

Claude Desktop

Edite su archivo claude_desktop_config.json:

Con OAuth (recomendado) — ejecute npx @seven.io/mcp login primero:

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

Con clave API:

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

Claude Code

claude mcp add seven npx @seven.io/mcp

Cursor

Añada el servidor al archivo .cursor/mcp.json de su proyecto:

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

Herramientas disponibles

El servidor proporciona más de 40 herramientas agrupadas por funcionalidad.

Mensajería

Cuenta

Búsqueda

Estado y libro de registro

Números de teléfono

Contactos

Grupos

Subcuentas

Webhooks

Remitente

Ejemplos

Una vez conectado el servidor, puede pedirle al asistente en lenguaje natural. El cliente MCP elige automáticamente la herramienta adecuada.

Enviar un SMS:

Envía un SMS al +49170123456789 con el texto 'Pedido enviado — sigue tu envío en example.com/t/abc123'.

El asistente llama a send_sms.

Consultar el saldo:

¿Cuál es el saldo de mi cuenta seven.io?

El asistente llama a get_balance.

Búsqueda de operador y comprobación de RCS:

Busca el operador del +49170123456789 y dime si el número admite RCS.

El asistente encadena lookup_mnp y lookup_rcs.

Registro de depuración

Defina SEVEN_LOG_FILE para registrar todas las solicitudes y respuestas de la API en un archivo. Útil cuando una llamada a una herramienta no se comporta como se espera.

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

A continuación, siga el archivo de log en directo:

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

Recursos

• Repositorio de GitHub
• Paquete npm
• Especificación del Model Context Protocol
• Seguimiento de incidencias