INTEGRAÇÕES / MODEL CONTEXT PROTOCOL

Milten MCP: auditorias web no seu assistente de IA

Conecte o Codex, Cursor ou Claude Code às suas auditorias salvas no Milten. Pelo Model Context Protocol (MCP), seu assistente pode ler as métricas de desempenho do site e obter recomendações de otimização fundamentadas nos dados do relatório.

Configurar o Milten MCP Referência das ferramentas

Milten MCP

HTTP

Como seu assistente usa uma auditoria do Milten

Encontrar a auditoria
list_audits
Ler as medições
get_audit_report
Obter um plano de otimização
get_optimization_plan

Acesso somente para leitura

Lê auditorias salvas sem iniciar novas análises, alterar projetos ou consumir tokens do Milten.

Como se conectar ao Milten MCP

O Milten MCP é executado em um servidor remoto. Adicione a URL e um token de acesso a um cliente compatível com Streamable HTTP e cabeçalhos Authorization personalizados. Não é necessário instalar um pacote do Milten localmente.

URL do servidor: https://milten.io/mcp
Autenticação: Authorization: Bearer <PAT>

O que você precisa

Você precisa de uma conta do Milten e de um token de acesso pessoal. Para ler um relatório, use uma auditoria existente dessa conta ou inicie uma nova no site do Milten.

Entrar no Milten Obter um token de acesso

Codex

Substitua <PAT> pelo segredo do token e execute todo o bloco no Bash ou Zsh. Ele adiciona o servidor e salva Authorization em http_headers no arquivo de configuração do Codex (~/.codex/config.toml por padrão). Ao executar novamente, as configurações de milten são substituídas. Reinicie o Codex. O arquivo contém o segredo: não o publique.

Terminal

codex mcp add milten --url https://milten.io/mcp &&
cat >> "${CODEX_HOME:-$HOME/.codex}/config.toml" <<'EOF'

[mcp_servers.milten.http_headers]
Authorization = "Bearer <PAT>"
EOF

Documentação do cliente ↗

Cursor

Adicione a entrada milten a mcpServers em ~/.cursor/mcp.json para usá-la em todos os projetos, ou em .cursor/mcp.json para um único projeto. Mantenha as entradas dos outros servidores.

Nos exemplos com MILTEN_MCP_TOKEN, defina o token como valor dessa variável de ambiente antes de iniciar o cliente. Reinicie-o após alterar o token. Uma variável definida no terminal não fica automaticamente disponível para um aplicativo aberto pela área de trabalho.

.cursor/mcp.json

{
  "mcpServers": {
    "milten": {
      "url": "https://milten.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MILTEN_MCP_TOKEN}"
      }
    }
  }
}

Documentação do cliente ↗

Claude Code

Adicione esta entrada ao arquivo .mcp.json do projeto. O Claude Code resolve a variável de ambiente ao iniciar; autorize o servidor do projeto quando solicitado.

.mcp.json

{
  "mcpServers": {
    "milten": {
      "type": "http",
      "url": "https://milten.io/mcp",
      "headers": {
        "Authorization": "Bearer ${MILTEN_MCP_TOKEN}"
      }
    }
  }
}

Documentação do cliente ↗

Verifique se as seis ferramentas estão disponíveis

Ative milten no cliente MCP. Devem aparecer list_audits, get_audit_report, get_optimization_plan, get_audit_section, compare_audits e get_monitoring_history. Comece com list_audits e use um auditId da resposta. Uma lista vazia é válida se ainda não houver auditorias.

Como obter um token de acesso do Milten

Você pode criar, consultar e revogar tokens de acesso pessoal (Personal Access Tokens, PAT) na sua área pessoal, em Perfil → Chaves de API. O cliente MCP envia o token no cabeçalho Authorization: Bearer. O servidor MCP não usa cookies do navegador nem login por OAuth.

Criar um token de acesso

Abra Chaves de API no seu perfil, informe um nome e um prazo de validade e clique em Criar token.

Abrir Chaves de API

Copie o segredo agora: ele é exibido apenas uma vez. Guarde-o com segurança e passe-o ao cliente usando um dos métodos acima. O id do token permanece visível na lista para revogação.

O token concede a permissão audits:read para suas próprias auditorias. name é obrigatório e aceita até 100 bytes. expiresAt deve ser uma data futura no formato RFC 3339, no máximo daqui a 366 dias.

Consultar e revogar tokens

A lista em Chaves de API mostra o nome, a validade e o status dos tokens. Revogar encerra o acesso MCP desse token. As rotas da API continuam disponíveis com uma sessão ativa no navegador: GET retorna os metadados dos tokens sem os segredos. Para revogar um token, substitua {id} pelo identificador dele. DELETE retorna 204 e as próximas solicitações MCP com esse token são rejeitadas.

API da conta

GET /v1/personal-access-tokens/
DELETE /v1/personal-access-tokens/{id}

Ferramentas MCP: auditorias, relatórios e planos de otimização

Seu cliente MCP envia estes argumentos JSON para tools/call. Para solicitar um relatório ou plano, substitua o UUID do exemplo por um auditId de list_audits. Use o identificador da auditoria, não a URL do site.

list_audits

Retorna as auditorias do usuário autenticado. Você pode limitar a lista a um projeto.

Argumentos: Todos os campos são opcionais. projectId: UUID do projeto; page: inteiro ≥ 1 (padrão: 1); limit: inteiro de 1 a 50 (padrão: 10).
Resposta: audits contém auditId, url, operation, status e createdAt, além de projectId e error quando presentes. count é o total; page e limit descrevem a paginação. Se truncated for true, repita a solicitação com um limit menor. O status é running, completed ou failed.

list_audits · JSON

{
  "page": 1,
  "limit": 10
}

get_audit_report

Leia todas as seções salvas do relatório e um breve resumo das métricas.

Argumentos: auditId: UUID obrigatório de uma auditoria obtida com list_audits.
Resposta: audit contém os metadados; filling contém todas as seções salvas no formato {type, data}, incluindo Lighthouse, HAR, CrUX e llmAdvice. analysis acrescenta um resumo das métricas e dos problemas. trustNote identifica o conteúdo do site como dados não confiáveis. O limite padrão dos dados de resposta é 1 MiB; se for excedido, retorna um erro em vez de um relatório truncado.

get_audit_report · JSON

{
  "auditId": "123e4567-e89b-42d3-a456-426614174000"
}

get_optimization_plan

Leia o plano llmAdvice salvo que aparece no relatório. O MCP não gera novas recomendações nem chama um LLM.

Argumentos: auditId: UUID obrigatório; focus: all (padrão), lcp, inp, cls ou backend; limit: inteiro de 1 a 25 (padrão: 10).
Resposta: plan contém source, summary, recommendations e truncated. A ordem e os campos são preservados: priority (critical, medium ou low), metrics, metricSavings, title, resources, evidence, action, effect e verification. focus filtra por metrics; backend corresponde a TTFB. Se limit encurtar a lista, truncated será true. Planos de texto antigos aparecem em output sem filtros. Se não houver plano salvo, consulte diagnostic.

get_optimization_plan · JSON

{
  "auditId": "123e4567-e89b-42d3-a456-426614174000",
  "focus": "lcp",
  "limit": 3
}

get_audit_section

Lê a última seção salva do relatório. Arrays grandes podem ser consultados por páginas.

Argumentos: auditId e section são obrigatórios. section é um type de filling, como har. path é um JSON Pointer opcional, como /log/entries. Para arrays: offset a partir de 0, limit de 1–200 (padrão 50). Omita a paginação para outros dados.
Resposta: data preserva os campos originais e null. Arrays incluem total, nextOffset e truncated; siga nextOffset até truncated ser false. Se a resposta for grande demais, escolha um path mais específico ou reduza limit.

get_audit_section · JSON

{
  "auditId": "123e4567-e89b-42d3-a456-426614174000",
  "section": "har",
  "path": "/log/entries",
  "limit": 20
}

compare_audits

Compara duas auditorias próprias da mesma URL e tipo: medições, problemas por limites e recomendações salvas.

Argumentos: baselineAuditId identifica a auditoria inicial e candidateAuditId a posterior. Obtenha os dois UUIDs em list_audits. Métricas de laboratório são aceitas para basic, inp e ttfb.
Resposta: delta = candidate − baseline; valores ausentes são null. Verifique comparable e warnings. findings inclui added, resolved, persisting e uncompared. As recomendações correspondem pelo title exato; os dois planos salvos são incluídos.

compare_audits · JSON

{
  "baselineAuditId": "123e4567-e89b-42d3-a456-426614174000",
  "candidateAuditId": "e6723288-f28c-4b62-8a4e-7dc395958c0c"
}

get_monitoring_history

Retorna as medições salvas da sua página monitorada, das mais recentes para as mais antigas. Não inicia verificações.

Argumentos: monitoringUnitId é obrigatório: UUID Core da página monitorada (coreMonitoringUnitId), não auditId. dateFrom e dateTo são limites inclusivos RFC 3339; padrão dos últimos 30 dias. page começa em 1, limit de 1–50 (padrão 20).
Resposta: results inclui datas, métricas, dispositivo, região e affectedAlert. A resposta inclui count e hasMore. Reutilize dateFrom e dateTo nas páginas seguintes. Zeros antigos podem indicar dados ausentes; INP é uma medição de laboratório, não CrUX p75.

get_monitoring_history · JSON

{
  "monitoringUnitId": "e09aa948-a541-4404-bcdc-9e5621c11891",
  "page": 1,
  "limit": 20
}

Exemplos de solicitações ao assistente de IA

Após conectar, envie estas mensagens no chat do assistente. Ele chama as ferramentas MCP e explica os resultados; as mensagens não são comandos separados do servidor.

Mostre minhas auditorias do Milten e encontre a última auditoria concluída de example.com.
Leia esse relatório. Quais métricas indicam carregamento lento? Inclua os valores e as unidades.
Obtenha um plano de otimização com foco em LCP. Se o relatório justificar, sugira até três alterações e explique como verificar o resultado de cada uma.

Quais dados a conexão pode acessar

O token identifica sua conta, por isso userId não é um argumento das ferramentas. O filtro por projeto apenas restringe sua própria lista de auditorias; ele não dá acesso às auditorias de outros usuários. O MCP lê dados salvos e não pode iniciar uma análise. Trate o texto de um site auditado como dados do relatório, nunca como instruções para o agente.

Solução de problemas de conexão e uso do MCP

404 / HTML em vez de JSON

Confirme se o endpoint MCP está habilitado no seu ambiente. Use exatamente /mcp, sem barra no final nem prefixo de idioma. A página de documentação tem outra URL.

401 unauthorized

Verifique Authorization: Bearer e o segredo do token. Se o Codex exibir failed (0 tools), repita a configuração com um token válido e reinicie o Codex. Substitua tokens expirados ou revogados. O login por OAuth não é compatível.

403 origin forbidden

Para um cliente no navegador, seu origin deve ser permitido pelo servidor MCP. Informe ao Milten o nome do cliente e seu origin, sem enviar o token.

429 rate limit exceeded

Reduza a frequência das solicitações e tente novamente mais tarde. O limite padrão do servidor é de 60 solicitações por minuto por token; ele pode variar conforme o ambiente.

audit not found / invalid arguments

Use um UUID de auditoria da sua própria resposta de list_audits. Tanto uma auditoria inexistente quanto a de outro usuário retornam audit not found. Confira os valores de paginação, focus e limit.

Métricas ou recomendações vazias

Verifique audit.status e diagnostic. O relatório pode não ter métricas compatíveis ou llmAdvice salvo. A lista também pode estar vazia se nenhuma recomendação corresponder a focus. Isso não confirma que o site esteja livre de problemas.

503 / temporarily unavailable

O serviço de autenticação ou de auditorias está temporariamente indisponível. Tente novamente mais tarde e entre em contato com o suporte se o erro persistir.

Como se conectar ao Milten MCP

URL do servidor

https://milten.io/mcp

Autenticação

Authorization: Bearer <PAT>

O que você precisa

Você precisa de uma conta do Milten e de um token de acesso pessoal. Para ler um relatório, use uma auditoria existente dessa conta ou inicie uma nova no site do Milten.

Entrar no Milten Obter um token de acesso

Codex

Terminal

codex mcp add milten --url https://milten.io/mcp &&
cat >> "${CODEX_HOME:-$HOME/.codex}/config.toml" <<'EOF'

[mcp_servers.milten.http_headers]
Authorization = "Bearer <PAT>"
EOF

Documentação do cliente ↗

Cursor

Adicione a entrada milten a mcpServers em ~/.cursor/mcp.json para usá-la em todos os projetos, ou em .cursor/mcp.json para um único projeto. Mantenha as entradas dos outros servidores.

.cursor/mcp.json

{
  "mcpServers": {
    "milten": {
      "url": "https://milten.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MILTEN_MCP_TOKEN}"
      }
    }
  }
}

Documentação do cliente ↗

Claude Code

Adicione esta entrada ao arquivo .mcp.json do projeto. O Claude Code resolve a variável de ambiente ao iniciar; autorize o servidor do projeto quando solicitado.

.mcp.json

{
  "mcpServers": {
    "milten": {
      "type": "http",
      "url": "https://milten.io/mcp",
      "headers": {
        "Authorization": "Bearer ${MILTEN_MCP_TOKEN}"
      }
    }
  }
}

Documentação do cliente ↗

Verifique se as seis ferramentas estão disponíveis

Como obter um token de acesso do Milten

Criar um token de acesso

Abra Chaves de API no seu perfil, informe um nome e um prazo de validade e clique em Criar token.

Abrir Chaves de API

Copie o segredo agora: ele é exibido apenas uma vez. Guarde-o com segurança e passe-o ao cliente usando um dos métodos acima. O id do token permanece visível na lista para revogação.

Consultar e revogar tokens

API da conta

GET /v1/personal-access-tokens/
DELETE /v1/personal-access-tokens/{id}

Ferramentas MCP: auditorias, relatórios e planos de otimização

list_audits

Retorna as auditorias do usuário autenticado. Você pode limitar a lista a um projeto.

Argumentos: Todos os campos são opcionais. projectId: UUID do projeto; page: inteiro ≥ 1 (padrão: 1); limit: inteiro de 1 a 50 (padrão: 10).
Resposta: audits contém auditId, url, operation, status e createdAt, além de projectId e error quando presentes. count é o total; page e limit descrevem a paginação. Se truncated for true, repita a solicitação com um limit menor. O status é running, completed ou failed.

list_audits · JSON

{
  "page": 1,
  "limit": 10
}

get_audit_report

Leia todas as seções salvas do relatório e um breve resumo das métricas.

Argumentos: auditId: UUID obrigatório de uma auditoria obtida com list_audits.
Resposta: audit contém os metadados; filling contém todas as seções salvas no formato {type, data}, incluindo Lighthouse, HAR, CrUX e llmAdvice. analysis acrescenta um resumo das métricas e dos problemas. trustNote identifica o conteúdo do site como dados não confiáveis. O limite padrão dos dados de resposta é 1 MiB; se for excedido, retorna um erro em vez de um relatório truncado.

get_audit_report · JSON

{
  "auditId": "123e4567-e89b-42d3-a456-426614174000"
}

get_optimization_plan

Leia o plano llmAdvice salvo que aparece no relatório. O MCP não gera novas recomendações nem chama um LLM.

Argumentos: auditId: UUID obrigatório; focus: all (padrão), lcp, inp, cls ou backend; limit: inteiro de 1 a 25 (padrão: 10).
Resposta: plan contém source, summary, recommendations e truncated. A ordem e os campos são preservados: priority (critical, medium ou low), metrics, metricSavings, title, resources, evidence, action, effect e verification. focus filtra por metrics; backend corresponde a TTFB. Se limit encurtar a lista, truncated será true. Planos de texto antigos aparecem em output sem filtros. Se não houver plano salvo, consulte diagnostic.

get_optimization_plan · JSON

{
  "auditId": "123e4567-e89b-42d3-a456-426614174000",
  "focus": "lcp",
  "limit": 3
}

get_audit_section

Lê a última seção salva do relatório. Arrays grandes podem ser consultados por páginas.

Argumentos: auditId e section são obrigatórios. section é um type de filling, como har. path é um JSON Pointer opcional, como /log/entries. Para arrays: offset a partir de 0, limit de 1–200 (padrão 50). Omita a paginação para outros dados.
Resposta: data preserva os campos originais e null. Arrays incluem total, nextOffset e truncated; siga nextOffset até truncated ser false. Se a resposta for grande demais, escolha um path mais específico ou reduza limit.

get_audit_section · JSON

{
  "auditId": "123e4567-e89b-42d3-a456-426614174000",
  "section": "har",
  "path": "/log/entries",
  "limit": 20
}

compare_audits

Compara duas auditorias próprias da mesma URL e tipo: medições, problemas por limites e recomendações salvas.

Argumentos: baselineAuditId identifica a auditoria inicial e candidateAuditId a posterior. Obtenha os dois UUIDs em list_audits. Métricas de laboratório são aceitas para basic, inp e ttfb.
Resposta: delta = candidate − baseline; valores ausentes são null. Verifique comparable e warnings. findings inclui added, resolved, persisting e uncompared. As recomendações correspondem pelo title exato; os dois planos salvos são incluídos.

compare_audits · JSON

{
  "baselineAuditId": "123e4567-e89b-42d3-a456-426614174000",
  "candidateAuditId": "e6723288-f28c-4b62-8a4e-7dc395958c0c"
}

get_monitoring_history

Retorna as medições salvas da sua página monitorada, das mais recentes para as mais antigas. Não inicia verificações.

Argumentos: monitoringUnitId é obrigatório: UUID Core da página monitorada (coreMonitoringUnitId), não auditId. dateFrom e dateTo são limites inclusivos RFC 3339; padrão dos últimos 30 dias. page começa em 1, limit de 1–50 (padrão 20).
Resposta: results inclui datas, métricas, dispositivo, região e affectedAlert. A resposta inclui count e hasMore. Reutilize dateFrom e dateTo nas páginas seguintes. Zeros antigos podem indicar dados ausentes; INP é uma medição de laboratório, não CrUX p75.

get_monitoring_history · JSON

{
  "monitoringUnitId": "e09aa948-a541-4404-bcdc-9e5621c11891",
  "page": 1,
  "limit": 20
}

Exemplos de solicitações ao assistente de IA

Após conectar, envie estas mensagens no chat do assistente. Ele chama as ferramentas MCP e explica os resultados; as mensagens não são comandos separados do servidor.

Mostre minhas auditorias do Milten e encontre a última auditoria concluída de example.com.

Leia esse relatório. Quais métricas indicam carregamento lento? Inclua os valores e as unidades.

Obtenha um plano de otimização com foco em LCP. Se o relatório justificar, sugira até três alterações e explique como verificar o resultado de cada uma.

Quais dados a conexão pode acessar

Solução de problemas de conexão e uso do MCP

404 / HTML em vez de JSON

Confirme se o endpoint MCP está habilitado no seu ambiente. Use exatamente /mcp, sem barra no final nem prefixo de idioma. A página de documentação tem outra URL.

401 unauthorized

403 origin forbidden

Para um cliente no navegador, seu origin deve ser permitido pelo servidor MCP. Informe ao Milten o nome do cliente e seu origin, sem enviar o token.

429 rate limit exceeded

Reduza a frequência das solicitações e tente novamente mais tarde. O limite padrão do servidor é de 60 solicitações por minuto por token; ele pode variar conforme o ambiente.

audit not found / invalid arguments

Métricas ou recomendações vazias

503 / temporarily unavailable

O serviço de autenticação ou de auditorias está temporariamente indisponível. Tente novamente mais tarde e entre em contato com o suporte se o erro persistir.

Milten MCP: auditorias web no seu assistente de IA

Como se conectar ao Milten MCP

O que você precisa

Verifique se as seis ferramentas estão disponíveis

Como obter um token de acesso do Milten

Criar um token de acesso

Ferramentas MCP: auditorias, relatórios e planos de otimização

list_audits

get_audit_report

get_optimization_plan

get_audit_section

compare_audits

get_monitoring_history

Exemplos de solicitações ao assistente de IA

Quais dados a conexão pode acessar

Solução de problemas de conexão e uso do MCP

Usamos cookies

Milten MCP: auditorias web no seu assistente de IA

Como se conectar ao Milten MCP

O que você precisa

Verifique se as seis ferramentas estão disponíveis

Como obter um token de acesso do Milten

Criar um token de acesso

Ferramentas MCP: auditorias, relatórios e planos de otimização

list_audits

get_audit_report

get_optimization_plan

get_audit_section

compare_audits

get_monitoring_history

Exemplos de solicitações ao assistente de IA

Quais dados a conexão pode acessar

Solução de problemas de conexão e uso do MCP

Usamos cookies