Socket

Agrega el servidor alojado a través de la configuración de conectores personalizados de Claude. El archivo de configuración de Developer es para servidores locales.

1. Abre Personalizar > Conectores en Claude.
2. Selecciona Agregar conector personalizado e ingresa https://mcp.socket.dev/ como la URL del servidor. En los planes Team y Enterprise, un propietario de la organización agrega el conector a través de Configuración de la organización > Conectores primero.
3. Selecciona Conectar y completa el flujo de autorización de Socket cuando se te solicite.
4. Habilita el conector para tu conversación y luego pregúntale a Claude "Verifica la puntuación de seguridad para express versión 4.18.2".

Para Claude Code, un solo comando hace todo:

claude mcp add --transport http socket-mcp https://mcp.socket.dev/

# For VS Code with GitHub Copilot
code --add-mcp '{"name":"socket-mcp","type":"http","url":"https://mcp.socket.dev/"}'

O agrégalo a .vscode/mcp.json:

{
  "servers": {
    "socket-mcp": {
      "type": "http",
      "url": "https://mcp.socket.dev/"
    }
  }
}

Cursor Settings → MCP → Add new MCP Server. Nombra socket-mcp, tipo http, URL https://mcp.socket.dev/.

{
  "mcpServers": {
    "socket-mcp": {
      "type": "http",
      "url": "https://mcp.socket.dev/"
    }
  }
}

Windsurf no admite servidores MCP de tipo http. Usa la configuración stdio de la Opción 2 a continuación, o el formulario serverUrl:

{
  "mcpServers": {
    "socket-mcp": {
      "serverUrl": "https://mcp.socket.dev/mcp"
    }
  }
}

Factory es una plataforma de ingeniería de software impulsada por IA. Instala el servidor MCP de Socket con la CLI de Factory:

droid mcp add socket https://mcp.socket.dev/ --type http

Para autoalojar con una clave API en su lugar, consulta la Opción 2 a continuación y registra el comando stdio con droid mcp add.

Alternativamente, escribe /mcp dentro del droid de Factory para gestionar servidores MCP desde una interfaz interactiva. Aprende más en la documentación de MCP de Factory.

Claude Code:

claude mcp add socket-mcp -e SOCKET_API_TOKEN="your-api-token-here" -- socket-mcp

La mayoría de los otros clientes MCP:

{
  "mcpServers": {
    "socket-mcp": {
      "command": "socket-mcp",
      "env": {
        "SOCKET_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Ejecuta el servidor en modo HTTP:

MCP_HTTP_MODE=true SOCKET_API_TOKEN=your-api-token socket-mcp --http

El servidor escucha en http://localhost:3000/. El endpoint MCP es / y el endpoint de salud es /health; cualquier otra ruta responde 404.

El transporte no tiene estado. Cada POST / es autónomo, sin sesión que abrir, sin encabezado Mcp-Session-Id y nada que expire, por lo que puedes poner varias instancias detrás de un balanceador de carga sin afinidad de sesión. GET y DELETE en el endpoint MCP responden 405. Los clientes escritos para el protocolo 2025, que abren con un protocolo de enlace initialize, también reciben servicio.

Variables de entorno para el modo HTTP:

Las tres variables de OAuth son un conjunto: configura las tres o ninguna. Configurar solo algunas hace que el servidor imprima Incomplete OAuth configuration for HTTP mode y salga con 1, en lugar de iniciar silenciosamente sin autenticación.

SOCKET_API_TOKEN es canónico. Estos alias se leen en orden, el primero no vacío gana: SOCKET_API_TOKEN, SOCKET_API_KEY, SOCKET_CLI_API_TOKEN, SOCKET_CLI_API_KEY, SOCKET_SECURITY_API_TOKEN, SOCKET_SECURITY_API_KEY.

SOCKET_API_TOKEN, SOCKET_API_BASE_URL y SOCKET_DEBUG también se aplican en modo stdio. Todo lo demás en la tabla es solo HTTP.

Habilitando OAuth. Establece las tres variables de OAuth para requerir un token de acceso OAuth en cada solicitud MCP:

MCP_HTTP_MODE=true \
SOCKET_OAUTH_ISSUER=https://issuer.example.com \
SOCKET_OAUTH_INTROSPECTION_CLIENT_ID=your-client-id \
SOCKET_OAUTH_INTROSPECTION_CLIENT_SECRET=your-client-secret \
socket-mcp --http

Con OAuth habilitado, cada solicitud al endpoint de MCP pasa por la introspección de tokens RFC 7662. Un token de API de Socket sin procesar se rechaza con un 401, sea cual sea su prefijo; un token sktsec_ no tiene más privilegios que cualquier otra cadena aquí. Los llamadores envían un token de acceso OAuth, y el servidor usa ese token para las llamadas a la API de Socket que realiza en su nombre. Ejecuta sin las variables de OAuth para aceptar tokens de API de Socket sin procesar en su lugar.

Al iniciar, el servidor descubre los metadatos RFC 8414 del emisor. Un emisor que lleva una ruta (https://auth.example.com/tenant1) se sondea primero en la URL well-known con la ruta insertada (https://auth.example.com/.well-known/oauth-authorization-server/tenant1), y el issuer del propio documento de metadatos debe coincidir con SOCKET_OAUTH_ISSUER byte por byte. El emisor debe estar https en un host público; un emisor de bucle local o de red privada se rechaza de plano a menos que SOCKET_DEBUG=true esté establecido para trabajo con pila local. La misma regla se aplica al introspection_endpoint que anuncian los metadatos.

Los clientes descubren cómo autenticarse a través de GET /.well-known/oauth-protected-resource (RFC 9728), que el servidor publica una vez que OAuth está activado:

{
  "resource": "https://mcp.example.com/",
  "authorization_servers": ["https://issuer.example.com"],
  "scopes_supported": ["packages:list"],
  "bearer_methods_supported": ["header"],
  "resource_name": "Socket MCP Server"
}

Una solicitud rechazada responde 401 con una cabecera WWW-Authenticate que nombra esa URL de metadatos y los ámbitos que este recurso requiere:

WWW-Authenticate: Bearer error="invalid_token", error_description="Invalid or expired token",
  resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource", scope="packages:list"

[!IMPORTANT] Validación de audiencia. Cuando una respuesta de introspección incluye una declaración aud, el servidor requiere que nombre este recurso y rechaza el token en caso contrario. Esa comprobación está siempre activada y no tiene opción de exclusión. Cuando la respuesta no incluye ningún aud, el token se acepta por defecto, porque un servidor de autorización que nunca emite la declaración fallaría en todas las solicitudes. La validación de audiencia te protege exactamente hasta donde tu servidor de autorización rellena aud; si no lo hace, no se comprueba ninguna audiencia. Establece SOCKET_OAUTH_REQUIRE_AUDIENCE=true para requerir además la presencia de la declaración, pero solo una vez que hayas confirmado que tu servidor de autorización devuelve aud en la introspección. Habilitarlo contra un servidor que omite la declaración rechaza todo el tráfico.

Añade TRUST_PROXY=true solo cuando el servidor esté desplegado detrás de un proxy inverso o balanceador de carga de confianza que normalice las cabeceras de host y protocolo reenviadas.

Configura tu cliente MCP para conectarse al servidor HTTP:

{
  "mcpServers": {
    "socket-mcp": {
      "type": "http",
      "url": "http://localhost:3000"
    }
  }
}

depscore

Consulta la API de Socket para obtener información de puntuación de dependencias. Devuelve puntuaciones de cadena de suministro, calidad, mantenimiento, vulnerabilidad y licencia por paquete.

Ecosistemas compatibles

Basado en el soporte de lenguajes de Socket. El parámetro ecosystem se asigna a tipos PURL:

packagist se acepta como alias de composer, y openvsx para el tipo PURL vscode.

Ejemplo de solicitud:

{
  "packages": [
    { "ecosystem": "npm", "depname": "express", "version": "4.18.2" },
    { "ecosystem": "pypi", "depname": "fastapi", "version": "0.100.0" }
  ]
}

Respuesta, como un único bloque de texto. Cada puntuación es un entero de 0 a 100, cuanto más alto mejor:

Dependency scores:
pkg:npm/express@4.18.2: license: 100, maintenance: 87, quality: 100, supplyChain: 97, vulnerability: 98
  Report: https://socket.dev/npm/package/express
pkg:pypi/fastapi@0.100.0: license: 100, maintenance: 100, quality: 100, supplyChain: 100, vulnerability: 100
  Report: https://socket.dev/pypi/package/fastapi

Los paquetes se devuelven en el orden en que los devuelve la API, no en el orden en que los pediste. Un paquete del que Socket no tiene registro se omite de la lista en lugar de notificarse como error, así que compara la respuesta con tu solicitud cuando falte un nombre.

organizations

Lista las organizaciones de Socket a las que pertenece el usuario autenticado. No toma parámetros. Úsala para descubrir el valor de org_slug que requieren las herramientas con ámbito de organización (alerts, threat_feed).

Esta herramienta necesita un token de API de Socket. Consulta Autenticación para herramientas con ámbito de organización a continuación.

La respuesta es el JSON de la API de Socket, claveado por id de organización. El slug es lo que quieren las otras herramientas:

{
  "organizations": {
    "1234": {
      "id": "1234",
      "name": "Acme Robotics",
      "plan": "enterprise",
      "slug": "acme-robotics"
    }
  }
}

alerts

Lista las alertas de seguridad más recientes de una organización de Socket: problemas de cadena de suministro, vulnerabilidad, calidad, licencia y mantenimiento en los paquetes monitorizados de la organización. Respaldado por GET /v0/orgs/{org_slug}/alerts. Los resultados están paginados; pasa el endCursor de la respuesta anterior como cursor para obtener la siguiente página.

threat_feed

Consulta elementos en el feed de amenazas de una organización de Socket: paquetes marcados recientemente como malware, typosquats, código ofuscado y similares. Respaldado por GET /v0/orgs/{org_slug}/threat-feed. La respuesta incluye un nextPageCursor; pásalo como cursor para avanzar de página.

package_files

Lista los archivos publicados en un paquete: un árbol de rutas de archivo, cada uno con su tamaño y hash de blob, para cualquier paquete en un ecosistema compatible. Úsalo para inspeccionar lo que envía una dependencia antes de instalarla. Pasa el hash de un archivo a package_file_contents o package_file_grep.

La salida es una línea de encabezado y un árbol. El token después de cada tamaño es el hash del blob:

pkg:npm/lodash@4.17.21 — 1054 files, 1379.3 KB
└── package/
    ├── fp/
    │   ├── __.js  43B  QlKUJ6782LHNEISw-t4uX1hyH1TCZye4ShYOMIAghheg
    │   ├── _baseConvert.js  16.0K  QpGkoQltpQn5ZeTFxYQOnk8FWp-7yyeUQtyzdZXl48nA

package_file_contents

Lee un solo archivo de un paquete. Pasa el hash impreso junto a una entrada en la salida de package_files. Devuelve hasta 1 MB de texto UTF-8; los archivos binarios devuelven solo metadatos.

package_file_grep

Busca en un solo archivo de un paquete líneas que coincidan con una expresión regular de JavaScript, devolviendo coincidencias con números de línea (estilo grep -n). Cada blob se obtiene una vez y se mantiene en una caché de todo el proceso, por lo que las lecturas y búsquedas repetidas del mismo hash omiten la red.

Requisitos previos: Node.js 24+.

1. Copia todo el directorio dist/socket-gate en tu carpeta de hooks. El socket-gate.cjs incluido es autónomo, por lo que se ejecuta sin dependencias a su lado.

   Desde una instalación publicada:

   mkdir -p ~/.claude/hooks
   cp -R node_modules/@socketsecurity/mcp/dist/socket-gate ~/.claude/hooks/
   

   Desde un checkout, compílalo primero:

   pnpm run build
   mkdir -p ~/.claude/hooks
   cp -R dist/socket-gate ~/.claude/hooks/
   

2. Añade a ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "node ~/.claude/hooks/socket-gate/socket-gate.cjs"
          }
        ]
      }
    ]
  }
}

Consulta hooks/socket-gate/README.md para la referencia completa.

Este repositorio usa pnpm, y todos los comandos se ejecutan desde la raíz del repositorio. Se requiere Node.js 24+.

git clone https://github.com/SocketDev/socket-mcp.git
cd socket-mcp
pnpm install

Ejecutar desde el código fuente. No se necesita paso de compilación, porque Node 24 elimina el TypeScript por sí mismo:

export SOCKET_API_TOKEN=your_api_token_here
pnpm run server-stdio

O en modo HTTP:

pnpm run server-http

Ambos scripts leen SOCKET_API_TOKEN (con respaldo a SOCKET_API_KEY) de tu entorno. Agrega :debug a cualquiera de ellos (pnpm run server-http:debug) para establecer SOCKET_DEBUG=1 y obtener trazado por solicitud en stderr.

Nunca pongas -- antes de una ruta de prueba; eso amplía la ejecución a toda la suite. Escribe pnpm test test/repo/unit/purl.test.mts.

Para manejar un servidor en ejecución manualmente, consulta depuración con mock-client.

Endpoint de verificación de salud

Cuando se ejecuta en modo HTTP, GET /health devuelve la versión del servidor en ejecución y omite la validación de origen, lo que lo hace seguro para llamarlo desde una sonda que no envía el encabezado Origin:

{
  "status": "healthy",
  "service": "socket-mcp",
  "version": "0.0.20",
  "timestamp": "2026-07-29T01:50:30.394Z"
}

Adecuado para sondas de liveness/readiness de Kubernetes, verificaciones de salud de Docker y balanceadores de carga.

Solución de problemas

P: El servidor público no responde - Verifica la URL https://mcp.socket.dev/, confirma la configuración de tu cliente MCP, reinicia tu cliente MCP.

P: Se recibe un error 403 Forbidden: Invalid origin, o el conector nunca abre una pantalla de OAuth - El servidor acepta encabezados Origin del cliente cuando el Host de la solicitud coincide con el despliegue alojado. Confirma que tu cliente usa https://mcp.socket.dev/ y sigue sus pasos de configuración anteriores. Una respuesta persistente de Invalid origin requiere verificar que el despliegue alojado incluya la corrección.

P: El servidor local no se inicia - Asegúrate de que Node.js 24+ esté instalado, verifica que SOCKET_API_TOKEN esté configurado, confirma que el token de API tenga permiso de packages:list. En modo stdio, un token faltante es fatal: el servidor imprime SOCKET_API_TOKEN environment variable is required in stdio mode y sale con 1.

P: El servidor sale con Incomplete OAuth configuration for HTTP mode - SOCKET_OAUTH_ISSUER, SOCKET_OAUTH_INTROSPECTION_CLIENT_ID y SOCKET_OAUTH_INTROSPECTION_CLIENT_SECRET deben estar todos configurados o todos sin configurar.

P: Se reciben errores de autenticación con el servidor local - Verifica que tu clave de API sea válida, asegura el alcance de packages:list, regenérala si es necesario. Si la herramienta que falló fue organizations, alerts, threat_feed o package_files en un despliegue HTTP, el servidor se niega a responder con el token del operador por diseño; envía el tuyo en un encabezado Authorization: Bearer.

P: El asistente de IA no encuentra la herramienta depscore - Reinicia tu cliente MCP después de los cambios de configuración, verifica que la configuración esté guardada, comprueba que el servidor esté en ejecución. tools/list anuncia una caché pública de una hora, por lo que un cliente que almacena en caché la lista de herramientas puede necesitar un reinicio para detectar una herramienta recién agregada.

Obtener ayuda

• 📖 Documentación de Socket
• 🐛 Reportar problemas
• 💬 Soporte de la comunidad