BetaDrop MCP

Referencia del servidor MCP

@betadrop/mcp expone BetaDrop a cualquier cliente que hable el Protocolo de Contexto de Modelos (Claude Code, Claude Desktop, Cursor, VS Code con Copilot) como diez herramientas que un asistente puede invocar. Se ejecuta localmente a través de stdio y utiliza las mismas credenciales que la CLI. La descripción general de MCP cubre la configuración por editor con más detalle; esta página es la superficie de herramientas.

Configurar un cliente

No hay nada que instalar de antemano. npx obtiene el paquete en la primera ejecución. Node 18 o superior es el único requisito. En Claude Code, un solo comando lo registra para cada proyecto:

claude mcp add betadrop -s user -- npx -y @betadrop/mcp

Cualquier otro cliente es el mismo servidor descrito en el archivo de configuración de ese cliente. Claude Desktop y Cursor usan un objeto mcpServers; VS Code usa servers con una entrada por lo demás idéntica:

{
  "mcpServers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"]
    }
  }
}

Reinicia o actualiza el cliente después; los servidores MCP se descubren al iniciar.

Autenticación

El servidor resuelve las credenciales exactamente de la misma manera que la CLI, lo que te da tres opciones en orden decreciente de cuánto deberían gustarte.

• Ya has iniciado sesión con la CLI. No hay nada que hacer. Ambos leen el mismo archivo de credenciales, por lo que una máquina donde se haya ejecutado betadrop login ya está autenticada aquí. Esta es la opción sin secreto en ningún archivo de configuración.
• Pídele al asistente que inicie sesión. Llama a betadrop_login con un token. Valida el token contra el servidor antes de guardarlo y escribe en la misma configuración compartida. Hacer esto una vez también inicia sesión en la CLI.
• Una variable de entorno en la configuración. BETADROP_TOKEN se lee del entorno del servidor y tiene prioridad sobre la credencial almacenada. Funciona, pero significa un token en texto plano en un archivo de configuración del editor — vale la pena evitarlo a menos que las otras dos opciones sean imposibles.

Token en la configuración del cliente (último recurso)

{
  "mcpServers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"],
      "env": { "BETADROP_TOKEN": "bd_live_xxxxxxxx" }
    }
  }
}

Los tokens provienen de Configuración → Desarrollador → Tokens de API en el panel de control, o de betadrop_token_create a continuación. De cualquier manera, el valor en texto plano se muestra exactamente una vez.

Herramientas

Diez herramientas. Los argumentos obligatorios están marcados; todo lo demás es opcional. En la práctica no las llamas por nombre. Le pides al asistente el resultado y él elige. Saber qué existe es lo que te impide pedir algo que no existe.

Herramienta	Argumentos	Qué hace
betadrop_whoami	Ninguno	Informa el estado de autenticación, la cuenta activa y el servidor con el que está hablando.
betadrop_login	token (obligatorio), apiUrl	Valida un token de API contra el servidor y lo guarda en el archivo de credenciales compartido de la CLI.
betadrop_logout	Ninguno	Revoca el token activo en el servidor y borra las credenciales locales.
betadrop_publish	filePath (obligatorio), name, version, buildNumber, bundleId, notes, expiryType, expiryTimeDays, expiryDownloadLimit, expiryDeviceLimit	Publica un .ipa o .apk. filePath debe ser absoluto. Consulta la nota de caducidad a continuación.
betadrop_list_builds	platform, status, page, perPage	Lista compilaciones recientes. platform es ios o android; status es uno de active, expired, disabled, deprecated o latest. La paginación predeterminada es de 20 por página, máximo 100.
betadrop_list_expired_builds	platform, page, perPage	Solo compilaciones caducadas, con el motivo de caducidad. Un atajo para la herramienta anterior con status: expired.
betadrop_token_list	Ninguno	Lista los tokens de API activos de la cuenta.
betadrop_token_create	name (obligatorio), abilities, expiresInDays	Crea un token. abilities es cualquiera de publish, read o * y el valor predeterminado es *; expiresInDays es 1–365, y omitirlo significa sin caducidad. El valor en texto plano se devuelve una vez.
betadrop_token_delete	tokenId (obligatorio)	Revoca un token por su id, como lo lista betadrop_token_list.
betadrop_help	Ninguno	Una referencia rápida integrada: la lista de herramientas, sus entradas y ejemplos de indicaciones. Útil cuando el asistente necesita un recordatorio de lo que puede hacer.

Argumentos de caducidad en publish

betadrop_publish es la única herramienta que puede establecer la caducidad de una compilación en el momento de la carga, y sus cuatro argumentos de caducidad funcionan juntos en lugar de de forma independiente. expiryType elige la estrategia y los argumentos numéricos proporcionan el umbral que esa estrategia necesita.

expiryType	Requiere
none	Nada. La compilación no caduca según su propio cronograma.
time	expiryTimeDays. Caduca después de N días.
downloads	expiryDownloadLimit. Caduca después de N descargas.
devices	expiryDeviceLimit. Caduca después de N dispositivos únicos.
combined	Cualquier combinación de los tres límites numéricos. El que se alcance primero finaliza la compilación.

El límite de retención de tu plan sigue aplicándose. Estos argumentos eligen una vida más corta que el máximo, nunca una más larga. Los límites de dispositivos y descargas son la razón por la que vale la pena usar esta herramienta en lugar de la CLI para una compilación sensible: ninguno tiene un equivalente a la bandera publish.

Notas

• Rutas absolutas. betadrop_publish toma una filePath absoluta. Un servidor MCP no necesariamente comparte un directorio de trabajo con tu editor, por lo que una ruta relativa es ambigua en lugar de conveniente.
• Misma validación que la CLI. La extensión debe ser .ipa o .apk y el archivo debe ser realmente un archivo ZIP — ambos se verifican localmente antes de cargar cualquier cosa.
• Se ejecuta en tu máquina. El servidor es un proceso local que habla stdio con tu cliente. El archivo de compilación nunca pasa por el asistente; se lee del disco y se carga directamente.
• Las herramientas de tokens son reales. betadrop_token_create y betadrop_token_delete crean y revocan credenciales en vivo. Eso es conveniente y también es una razón para leer lo que un asistente propone antes de aprobarlo.