Plugins de agentes y CI

Scrimba Explain tiene un segundo endpoint de MCP para plugins de agentes y trabajos de CI, donde quienes ven un explicador no son los que lo pidieron:

https://scrimba.com/explain/pr/mcp

Funciona como el servidor MCP principal, con una diferencia: un explicador creado a través de él está sin listar desde el inicio. Comparte el link en un comentario de pull request o en un chat de equipo, y cualquiera que lo abra puede verlo sin necesidad de cuenta en Scrimba.

Cómo difiere de /explain/mcp

	/explain/mcp	/explain/pr/mcp
Un explicador nuevo es	Un borrador privado	Sin listar
Quién puede verlo	Quienquiera que inicie sesión y lo reclame a través del link	Cualquiera con el link, sin cuenta necesaria
Herramientas	Las tres herramientas de stream, más una herramienta de playlist	Solo las tres herramientas de stream

No hay herramienta de playlist: explicar código, una rama o un pull request requiere un único explicador. Todo lo demás es igual al servidor principal, incluyendo el mode que elige el frame del explicador y la ruta de carga para tus propias imágenes.

Conectándose

El endpoint es un servidor HTTP remoto y transmisible. No tiene paso de inicio de sesión y no requiere clave de API. Agrégalo como tu herramienta agrega servidores de MCP. Para tu propia máquina de desarrollador, el plugin Explain by Scrimba es el camino más corto; se conecta al servidor principal. En Claude Code:

claude mcp add --transport http scrimba-explain https://scrimba.com/explain/pr/mcp

En un trabajo de CI, donde no hay nadie alrededor para responder solicitudes de permisos, proporciona al agente el servidor en un archivo de configuración y autoriza las tres herramientas de antemano. Para Claude Code, guarda esto como scrimba.mcp.json:

{
  "mcpServers": {
    "scrimba": {
      "type": "http",
      "url": "https://scrimba.com/explain/pr/mcp"
    }
  }
}

Luego ejecútalo sin interfaz:

claude -p "Make a Scrimba explainer of this pull request" \
  --mcp-config scrimba.mcp.json \
  --allowedTools "mcp__scrimba__start_explainer_stream,mcp__scrimba__append_explainer_chunk,mcp__scrimba__finish_explainer_stream"

Las herramientas

Herramienta	Qué hace
start_explainer_stream	Abre un nuevo explicador y devuelve su link
append_explainer_chunk	Transmite la siguiente parte de la lección
finish_explainer_stream	Cierra la lección

El agente escribe la lección por sí mismo, luego la transmite a Scrimba. El explicador se renderiza en vivo desde el primer fragmento, así que el link es visible mientras el agente todavía está escribiendo.

El link

El link que devuelve la herramienta de inicio termina en ?claim=.... Comparte ese. Hasta que alguien lo haya abierto, el explicador permanece bloqueado, así que su URL plana no muestra nada. Después de eso, la URL plana también funciona.

Reclamación

Un explicador sin listar no le pertenece a nadie todavía. Para quedártelo, inicia sesión en Scrimba cuando lo abras y reclámalo. Solo una persona puede reclamarlo.

Esa persona se convierte en su propietaria y controla su visibilidad desde entonces. Así que piénsalo bien antes de publicar el link en algún lugar público, como un pull request en un repositorio de código abierto.

La herramienta de inicio toma una visibility opcional, que se aplica cuando un usuario con sesión iniciada reclama el explicador:

• Déjalo sin establecer, o establécelo en "unlisted", y el explicador permanece abierto a cualquiera con el link después de ser reclamado. Úsalo cuando el link se comparte con un equipo.
• Establécelo en "private" y reclamarlo lo restringe a la persona que lo reclamó.

Ver Privacidad, reclamación y compartición.

Límites

• Cada explicador puede contener hasta 10 minutos de narración. Una vez que esté lleno, se rechazan más fragmentos.
• Un stream que pasa 30 minutos sin un nuevo fragmento se finaliza automáticamente.
• Los límites sobre cuántas solicitudes, y cuántos explicadores nuevos, acepta Scrimba por minuto se aplican a todos sus endpoints de MCP en conjunto, no a cada llamador. Cuando Scrimba está ocupado, el endpoint responde con 429 y un header Retry-After, así que un trabajo de CI debería esperar ese tiempo e intentar de nuevo.

La acción Scrimba PR Explainer

La propia GitHub Action de Scrimba, scrimba/pr-explainer, usa este endpoint. En cada pull request que está listo para revisión, ejecuta Claude Code en el código, crea un explicador, y mantiene un comentario actualizado en el pull request con el link. La configuración, opciones y qué cubre el explicador están en Pull requests.