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.

Tiene dos formas de conectar el servidor:

• Servidor hospedado (URL) - conexión directa a https://mcp.seven.io/mcp sin necesidad de instalación. Transporte Streamable HTTP, login OAuth automático en el navegador.
• Instalación local (npx) - el paquete npm @seven.io/mcp iniciado mediante npx sobre el transporte stdio de MCP. Código fuente en GitHub.

Servidor hospedado (URL)

Añada la URL https://mcp.seven.io/mcp a su cliente MCP. El servidor utiliza el transporte Streamable HTTP (no SSE) y OAuth 2.0 con PKCE mediante el descubrimiento del servidor de autorización.

Claude Code

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

Cursor

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

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

Claude Desktop

La forma más sencilla es a través de la interfaz: Ajustes → Connectors → Add custom connector, introduzca la URL https://mcp.seven.io/mcp. A continuación, Claude abre el login OAuth en su navegador.

Como alternativa, añada el fragmento a claude_desktop_config.json mediante el puente mcp-remote:

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

Autenticación

En la primera conexión, el cliente MCP detecta automáticamente el endpoint OAuth, abre el navegador, solicita los scopes necesarios (SMS, Voz, RCS, …) y almacena los tokens. No es necesario un paso de inicio de sesión manual.

Instalación local (npx)

El paquete npm @seven.io/mcp es lanzado por su cliente MCP mediante npx. No es necesaria una instalación global - npx descarga la última versión bajo demanda. Si la prefiere de todos modos:

npm install -g @seven.io/mcp

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

Claude Desktop

Edite su archivo claude_desktop_config.json:

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

Autenticación

La variante local admite dos métodos. Se recomienda OAuth 2.0 con PKCE - renovación automática de tokens, scopes detallados y almacenamiento seguro de los tokens en el llavero del sistema operativo. Si ambos métodos están configurados, OAuth tiene prioridad.

OAuth 2.0 (recomendado)

Ejecute el comando de inicio de sesión una vez. Abrirá su navegador, solicitará los scopes necesarios 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

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"

En la configuración del cliente:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"],
      "env": {
        "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 al servidor hospedado (URL) o utilice la variante con clave API - ambos métodos funcionan sin un navegador local.

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.

Precios por país:

¿Cuánto cuesta un SMS a Francia, España y Estados Unidos?

El asistente llama a get_pricing y filtra los resultados.

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.

Comprobar disponibilidad y luego enviar:

Comprueba mediante HLR si +49170123456789 está disponible. Si lo está, envía un SMS con el texto 'Reunión mañana a las 10:00'.

El asistente llama a lookup_hlr y decide en función del resultado si ejecutar send_sms.

Crear una subcuenta y transferir saldo:

Crea una subcuenta para nuestro nuevo equipo y transfiere 50 EUR de saldo allí.

El asistente encadena create_subaccount y transfer_credits.

Solución de problemas

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