Skip to content
This page has been auto-translated and may contain errors.View in English

Plugins de agente e CI ​

Scrimba Explain tem um segundo endpoint MCP para plugins de agente e jobs de CI, onde quem assiste a um explicador não é quem pediu:

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

Funciona como o servidor MCP principal, com uma diferença: um explicador criado por ele é não listado desde o começo. Poste o link em um comentário de pull request ou em um chat de equipe, e qualquer pessoa que abra consegue assistir, sem precisar de conta Scrimba.

Como difere de /explain/mcp ​

/explain/mcp/explain/pr/mcp
Um novo explicador éUm rascunho privadoNão listado
Quem consegue assistirQuem entra e o reclama pelo linkQualquer pessoa com o link, sem conta
FerramentasAs três ferramentas de stream, mais uma ferramenta de playlistSó as três ferramentas de stream

Não há ferramenta de playlist: explicar código, uma branch ou um pull request leva um explicador. Tudo o mais é igual ao servidor principal, incluindo o mode que escolhe o frame do explicador e a rota de upload para suas próprias imagens.

Conectando ​

O endpoint é um servidor HTTP streamable remoto. Não tem etapa de login e não precisa de chave de API. Adicione da forma que sua ferramenta adiciona servidores MCP. Para a máquina própria de um desenvolvedor, o plugin Explain by Scrimba é o caminho mais curto; ele conecta ao servidor principal. No Claude Code:

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

Em um job de CI, onde ninguém está por perto para responder prompts de permissão, passe o servidor ao agente em um arquivo de config e permita as três ferramentas de antemão. Para Claude Code, salve isto como scrimba.mcp.json:

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

Depois execute sem interface:

bash
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"

As ferramentas ​

FerramentaO que faz
start_explainer_streamAbre um novo explicador e devolve seu link
append_explainer_chunkFaz stream da próxima parte da aula para ele
finish_explainer_streamFecha a aula

O agente escreve a aula, depois faz stream dela para Scrimba. O explicador renderiza ao vivo desde o primeiro chunk, então o link é assistível enquanto o agente ainda está escrevendo.

O link que a ferramenta start retorna termina em ?claim=.... Compartilhe esse. Até alguém abrir, o explicador fica bloqueado, então sua URL simples mostra nada. Depois disso, a URL simples funciona também.

Reclamação ​

Um explicador não listado não pertence a ninguém ainda. Para guardá-lo, entre no Scrimba quando abrir e o reclame. Só uma pessoa consegue reclamá-lo.

Essa pessoa vira seu dono e controla sua visibilidade a partir daí. Então pense duas vezes antes de postar o link em algum lugar público, como um pull request em um repositório aberto.

A ferramenta start aceita um visibility opcional, que se aplica quando um usuário conectado reclama o explicador:

  • Deixe desconfigurado, ou configure como "unlisted", e o explicador fica aberto a qualquer pessoa com o link depois de reclamado. Use isso quando o link é compartilhado com uma equipe.
  • Configure como "private" e reclamar o restringe à pessoa que o reclamou.

Veja Privacidade, reclamação e compartilhamento.

Limites ​

  • Cada explicador pode ter até 10 minutos de narração. Quando está cheio, chunks adicionais são recusados.
  • Um stream que fica 30 minutos sem um chunk novo é finalizado automaticamente.
  • Os limites de quantas requisições, e quantos novos explicadores, Scrimba aceita por minuto se aplicam a todos seus endpoints MCP juntos, não a cada chamador. Quando Scrimba está ocupado, o endpoint responde 429 com um header Retry-After, então um job de CI deve esperar esse tempo e tentar de novo.

A ação Scrimba PR Explainer ​

A própria GitHub Action de Scrimba, scrimba/pr-explainer, usa este endpoint. Em cada pull request que está pronto para revisão, ela executa Claude Code no código, constrói um explicador e mantém um comentário no pull request atualizado com o link. Setup, opções e o que o explicador cobre estão em Pull requests.