criar-mcp-precedente

criar-mcp-precedente

<quando_usar> Use quando: - Usuário quer criar MCP para tribunal sem API documentada - Precisa fazer scraping de página de jurisprudência - Quer descobrir sintaxe booleana de um tribunal - Tribunal usa JSF/AJAX ou formulários complexos

### 0.1 Coletar URL do tribunal
Solicitar ao usuário a URL da página de busca de jurisprudência.

### 0.2 Perguntar localização do MCP
Usar AskUserQuestion:
```
Onde deseja criar o MCP?

1. Projeto atual (.claude/mcp-servers/[nome]/)
   → Disponível apenas neste projeto

2. Global (~/.claude/mcp-servers/[nome]/)
   → Disponível em todos os projetos

3. Diretório customizado
   → Informar caminho
```

Em qualquer opção, o arquivo pode viver onde o usuário preferir — o que ativa o MCP
é o REGISTRO no `.mcp.json` da raiz do projeto, com caminho ABSOLUTO do server.py
(ver Fase 3.4). NÃO registrar em settings.json: config de MCP ali é padrão antigo
e quebra silenciosamente (o servidor simplesmente não aparece).

### 0.3 Analisar tipo de API
Usar WebFetch na URL para detectar:

**Sinais de API REST aberta (→ recomendar mcp-builder):**
- Documentação Swagger/OpenAPI visível
- Endpoints /api/v1/ retornando JSON puro
- Headers CORS permissivos
- Sem ViewState/CSRF tokens

**Sinais de scraping necessário (→ continuar):**
- Formulários JSF (javax.faces.ViewState)
- AJAX com tokens CSRF
- Respostas em HTML/XML parcial
- Session cookies obrigatórios

**Sinais de bloqueio insuperável (→ abortar ou Chrome MCP):**
- reCAPTCHA v3 invisível (script google.com/recaptcha com `size=invisible`)
- reCAPTCHA v2 (checkbox "Não sou um robô")
- hCaptcha ou outros CAPTCHAs comportamentais
- Cloudflare Bot Protection

### 0.4 Decisão de roteamento

**Se API REST aberta detectada:**
```
"Detectei uma API REST documentada. Recomendo usar a skill mcp-builder.

Repositório: https://github.com/anthropics/anthropic-tools

Deseja que eu instale a mcp-builder?"
```

**Se CAPTCHA por requisição detectado (reCAPTCHA v3/v2, hCaptcha):**
```
"Este portal exige um token de CAPTCHA a cada busca — bloqueio insuperável
para um MCP server em Python puro.

Opções:
1. SKILL via Chrome MCP (rota comprovada) — em vez de MCP server, criar uma
   skill que roda a busca DENTRO do navegador real: o CAPTCHA gera o token
   normalmente porque há um Chrome de verdade. Modelo vivo:
   .claude/skills/jurisprudencia-eleitoral (SJUR/TSE, hCaptcha invisível,
   token de uso único por requisição, hcaptcha.reset() + retry).
2. Endpoints parcialmente abertos — antes de desistir, verificar se PARTE da
   superfície dispensa CAPTCHA (no TSE, o download do inteiro teor em PDF é
   aberto: só a busca é protegida). Um MCP híbrido pode cobrir a parte aberta.
3. Desistir — portal inviável.

O CAPTCHA comportamental analisa mouse, teclado e tempo, e gera tokens que
não podem ser replicados programaticamente."
```