EntrarEmpezar
← Level 4
Level 4· Lektion 6 von 11

MCP discovery, cómo se encuentran los servidores

Directorios, marketplaces, .well-known/mcp. Cómo funciona realmente el ecosistema MCP.

Por qué esta lección va aparte

Ya sabes qué es MCP, cómo montar servers y cómo la memoria es portable. Lo que falta: ¿dónde encuentras buenos servers? Y cuando construyas el tuyo en el Nivel 6, ¿cómo lo encuentra alguien?

Los tres directorios que cuentan

1. modelcontextprotocol.io (spec + reference servers), la web oficial de la spec, con una lista curada de servidores de referencia en github.com/modelcontextprotocol/servers. No es un directorio de listado clásico, sino la fuente a la que apuntan la spec y la propia documentación de Anthropic.

2. Claude Connectors (en Claude Desktop + claude.ai), listas integradas a partir de 2026. Instalación con un clic, OAuth pre-configurado.

3. MCPize Marketplace (mcpize.com), comercial, especializado en HTTP servers hosted.

Junto a esto hay listas de comunidad en GitHub (modelcontextprotocol/servers y awesome-mcp-servers).

El protocolo bajo el capó, RFC 9728

Durante un tiempo corrió el rumor de que existía un endpoint .well-known/mcp. No existe. Lo que la spec oficial de MCP (estado 2025-06-18) define realmente es /.well-known/oauth-protected-resource por RFC 9728, o sea OAuth Protected Resource Metadata. Ese es el mecanismo de discovery para HTTP MCP servers asegurados con OAuth 2.1.

Cuando un cliente alcanza tu dominio de MCP server, pide primero la metadata OAuth:

https://tu-dominio.com/.well-known/oauth-protected-resource

La respuesta es JSON según RFC 9728:

{
  "resource": "https://tu-dominio.com/mcp",
  "authorization_servers": [
    "https://tu-dominio.com"
  ],
  "scopes_supported": ["mcp:tools"],
  "bearer_methods_supported": ["header"]
}

El cliente ya conoce el authorization server, corre el flujo OAuth 2.1 con PKCE y luego habla con el endpoint MCP real (/mcp) usando bearer token.

La versión actual de la spec es 2025-06-18. Los drafts anteriores (2024-11-05, 2025-03-26) están obsoletos. Construir un endpoint .well-known/mcp es construir algo que ningún cliente va a pedir.

Stdio servers (npm) vs HTTP servers (discovery)

Stdio servers corren localmente con el usuario (npx -y mi-server). Discovery vía npm + docs + entrada en directorio.

HTTP servers corren centralmente. Deberían exponer .well-known/mcp para que los usuarios solo teclean el dominio.

Para publishers, dónde listar

Cuando construyas tu propio MCP server en el Nivel 6, el discovery es media batalla:

  • npm publish (10 minutos)
  • GitHub README + PR a awesome-mcp-servers (30 minutos)
  • Pull request a modelcontextprotocol/servers (PR de GitHub a la lista oficial de referencia, unos días de review)
  • MCPize Marketplace (1 hora de setup)
  • Claude Connector (submission + review de Anthropic)

Práctica, dos servers que mirar

  1. Sequential Thinking (Anthropic, stdio + npm).
  2. Brave Search MCP (stdio + npm).

Ambos tienen READMEs que ejemplifican cómo se documenta un MCP server.

Qué tienes ahora

La foto del ecosistema. Como usuario sabes dónde encontrar servers. Como futuro publisher sabes dónde poner el tuyo.

Update 2026-04-28: bundles de hooks como nueva clase de distribución

Con Claude Code v2.1.118 (hooks type: "mcp_tool", ver Lección 10), surge una nueva clase de distribución: plugins de hook-recipes. En vez de publicar un servidor MCP completo, los usuarios publican bundles de hooks pre-configurados para servidores existentes (Memory, CRM, GEO, etc.). Un claude plugin install studiomeyer-memory-hooks y el usuario tiene los 4 hooks de Memory activos sin editar settings.json a mano.

Marketplaces como studiomeyer-marketplace los listan junto a los MCP servers. Cada plugin necesita: plugin.json, README.md con check de idempotencia + nota RGPD, tests/ con smoke-test. Los cinco bundles para nuestros SaaS MCPs son recipes en la Fase 16 (/recipes/16.1-mcp-tool-hook-intro hasta 16.5-academy-hook-bundle). Copia-pega en settings.json y funcionan hoy, el packaging como plugin está en pipeline.

Fuentes

Estás leyendo sin cuenta. Login guarda tu progreso para que retomes donde lo dejaste. Iniciar sesión →
← Misma memoria, tres herramientCapstone, tu setup de memoria →