§01 · MCP

MCP-Server

Fragen Sie dieses Portfolio über einen KI-Assistenten ab, statt es zu scrapen — ein öffentlicher, schreibgeschützter MCP-Server über den Projektkatalog.

Schnelleinrichtung

Wählen Sie Ihren KI-Assistenten und fügen Sie die Konfiguration unten ein.

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

Öffnen Sie Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen.
Fügen Sie die Endpunkt-URL unten ein und bestätigen Sie.
Der Server ist öffentlich — für die Verbindung ist kein Token oder Login nötig.

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 site publica um servidor MCP (Model Context Protocol) público e somente leitura sobre o mesmo catálogo que você vê em /projects, /articles e /links — assim um assistente de IA (Claude, etc.) consegue buscar e ler essas páginas direto, sem precisar raspar HTML.

#Endpoint

https://jeffersongoncalves.dev.br/mcp

Transporte HTTP (Streamable HTTP), sem autenticação — o conteúdo já é público. Limitado a 60 requisições/min por IP. Mais abaixo tem configuração pronta pra copiar de acordo com seu assistente de IA.

#Testar localmente com o MCP Inspector

php artisan mcp:inspector mcp/portfolio

#O que ele expõe

search_projects — busca projetos, artigos e links curados por texto livre (query, também casa com o stack tecnológico e os topics, não só o nome), seção (section: projects/articles/links), categoria exata (category, ex: filament_plugin, laravel_package, starter_kit), idioma do resumo (locale: pt_BR/en/es, padrão en) e um limite de resultados (limit, 1-50). Devolve uma lista em Markdown com nome, URL canônica, categoria e um resumo de uma linha por página.
get_page — busca uma página publicada pelo slug (o mesmo que search_projects devolve) e opcionalmente locale (pt_BR/en/es) pro idioma do resumo: categoria, links de saída disponíveis (GitHub, Packagist, npm, Docker Hub, docs, demo), estrelas, downloads, licença, tipo de pacote, linguagem, versões de Filament suportadas, stack e topics, além de um trecho do README em texto puro (até 3000 caracteres, HTML já sanitizado e sem marcação).
get_site_stats — números agregados de todo o portfólio: total de repos e páginas do catálogo, downloads por registro (Packagist/npm/JetBrains/Docker), estrelas, seguidores e sponsors do GitHub, contagem de pacotes por categoria, as linguagens/topics mais frequentes e os links pra apoiar o trabalho (GitHub Sponsors, Buy Me a Coffee). Sem argumentos.
Resource site://llms.txt — o mesmo mapa de páginas em texto puro servido em /llms.txt: cada página pública do site com sua URL, pensado pra um assistente descobrir o catálogo inteiro numa leitura só.

#Detalhes técnicos

As três tools são somente leitura: search_projects e get_page consultam exatamente as mesmas linhas e o mesmo escopo published() que /projects, /articles e /links usam, e get_site_stats lê o mesmo agregado cacheado dos cards de estatística do site — nada escondido, nada mutável. O servidor roda sobre Laravel MCP com transporte Streamable HTTP; sem sessão nem handshake além do próprio protocolo MCP.