§01 · MCP

Servidor MCP

Consulta este portafolio desde un asistente de IA en vez de rasparlo — un servidor MCP público y de solo lectura sobre el catálogo de proyectos.

Configuración rápida

Elige tu asistente de IA y copia la configuración de abajo.

claude mcp add --transport http portfolio https://jeffersongoncalves.dev.br/mcp

Abre Configuración → Conectores → Agregar conector personalizado.
Pega la URL del endpoint de abajo y confirma.
El servidor es público — no hace falta token ni login para autorizar la conexión.

https://jeffersongoncalves.dev.br/mcp

.cursor/mcp.json

{
  "mcpServers": {
    "portfolio": {
      "url": "https://jeffersongoncalves.dev.br/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "portfolio": {
      "type": "http",
      "url": "https://jeffersongoncalves.dev.br/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.portfolio]
url = "https://jeffersongoncalves.dev.br/mcp"

~/.gemini/settings.json

{
  "mcpServers": {
    "portfolio": {
      "httpUrl": "https://jeffersongoncalves.dev.br/mcp"
    }
  }
}

Este sitio publica un servidor MCP (Model Context Protocol) público y de solo lectura sobre el mismo catálogo que ves en /projects, /articles y /links — así un asistente de IA (Claude, etc.) puede buscar y leer estas páginas directamente, sin scraping de HTML.

#Endpoint

https://jeffersongoncalves.dev.br/mcp

Transporte HTTP (Streamable HTTP), sin autenticación — el contenido ya es público. Limitado a 60 solicitudes/min por IP. Más abajo hay configuración lista para copiar según tu asistente de IA.

#Probarlo localmente con el MCP Inspector

php artisan mcp:inspector mcp/portfolio

#Qué expone

search_projects — busca proyectos, artículos y links curados por texto (query, también coincide contra el stack tecnológico y los topics, no solo el nombre), sección (section: projects/articles/links), categoría exacta (category, p. ej. filament_plugin, laravel_package, starter_kit), idioma del resumen (locale: pt_BR/en/es, por defecto en) y un límite de resultados (limit, 1-50). Devuelve una lista en Markdown con nombre, URL canónica, categoría y un resumen de una línea.
get_page — trae una página publicada por su slug (el mismo que devuelve search_projects) y opcionalmente locale (pt_BR/en/es) para el idioma del resumen: categoría, enlaces salientes disponibles (GitHub, Packagist, npm, Docker Hub, docs, demo), estrellas, descargas, licencia, tipo de paquete, lenguaje, versiones de Filament soportadas, stack y topics, más un extracto del README en texto plano (hasta 3000 caracteres, HTML ya saneado y sin marcado).
get_site_stats — números agregados de todo el portafolio: repos, total de páginas del catálogo, descargas por registro (Packagist/npm/JetBrains/Docker), estrellas, seguidores y sponsors de GitHub, conteo de paquetes por categoría, los lenguajes/topics más frecuentes y los enlaces para apoyar el trabajo (GitHub Sponsors, Buy Me a Coffee). Sin argumentos.
Resource site://llms.txt — el mismo mapa de página en texto plano que sirve /llms.txt: cada página pública del sitio con su URL, pensado para que un asistente descubra el catálogo completo de una sola vez.

#Notas técnicas

Las tres tools son de solo lectura y consultan las mismas filas y el mismo scope published() que usan /projects, /articles y /links (get_site_stats lee el mismo agregado cacheado que las tarjetas de estadísticas del sitio) — no hay contenido oculto ni mutaciones posibles. El servidor corre sobre Laravel MCP con transporte Streamable HTTP; no requiere sesión ni handshake adicional más allá del propio protocolo MCP.