Servidor MCP de docs
Cada sitio público de docs expone su propio servidor MCP de sólo lectura en <URL del sitio>/mcp. Un agente de IA conectado puede buscar en tus docs, leer una página como Markdown y listar todas las páginas, que es como los agentes de código de tus clientes responden preguntas sobre tu producto con tu documentación real.
Es un servidor distinto al de Servidor MCP. Aquél es para tu equipo: pide una llave de API y trabaja sobre tu workspace de Jotly. Éste es público, no pide llave y sólo lee docs publicadas.
La URL del servidor
Agrega /mcp a la dirección del sitio. Funciona en todas las formas en que se puede publicar un sitio:
| Sitio | Servidor MCP |
|---|---|
| Dirección de Jotly | https://jotly.si/b/acme/docs/mcp |
| Dominio propio | https://ayuda.acme.com/docs/mcp |
| Subdirectorio | https://acme.com/docs/mcp |
Si abres la URL en un navegador ves una página corta que explica cómo conectarse. Una petición de JSON regresa la URL, las herramientas y los enlaces para conectar.
Conecta un cliente
No hace falta llave ni cabecera. Cambia la URL por la de tu sitio.
En Claude Code, ejecuta:
claude mcp add --transport http acme-docs https://acme.com/docs/mcpEn Claude Desktop, abre Ajustes, luego Conectores, pulsa Agregar conector personalizado y pega la URL.
En Cursor, agrega el servidor a .cursor/mcp.json:
{ "mcpServers": { "acme-docs": { "url": "https://acme.com/docs/mcp" } }}En VS Code, agrégalo a .vscode/mcp.json:
{ "servers": { "acme-docs": { "type": "http", "url": "https://acme.com/docs/mcp" } }}Tus lectores no tienen que copiar nada de esto. Si agregas MCP en Diseño, Configurar, Acciones de página, el menú de la página muestra Copiar URL del servidor MCP, Conectar a Cursor, Conectar a VS Code y Conectar a Claude (que copia el comando de Claude Code).
Herramientas
| Herramienta | Qué hace |
|---|---|
search_docs | Busca en el sitio. Recibe query (hasta 200 caracteres) y limit (de 1 a 10, 5 por omisión). Regresa el título, la sección, la ruta, la URL absoluta y un fragmento de cada resultado. |
get_page | Regresa una página en Markdown, con su título y su URL. Recibe la ruta (/guias/webhooks), la misma ruta con .md o con un #ancla, o la URL completa. |
list_pages | Regresa todas las páginas, agrupadas por sección. Es el mismo índice de llms.txt. |
Cuando un cliente se conecta, el servidor manda el nombre del sitio e instrucciones que explican qué documenta el sitio y cuándo usar cada herramienta.
Pruébalo a mano:
curl -s -X POST "https://acme.com/docs/mcp" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Qué puede ver
El servidor siempre lee como un visitante anónimo. Nunca usa una cookie, una sesión del panel, un token del widget ni un enlace compartido, ni siquiera para tu propio equipo.
- Sólo sirve un sitio cuando es público, está publicado y el interruptor Servidor MCP está encendido.
- Expone las mismas páginas que
llms.txt: publicadas, en el menú y sin regla “Visible para”. Los bloques condicionales salen en su versión pública. - Los sitios privados, con enlaces compartidos, autenticados, sin publicar o apagados responden con el mismo 404, así que la respuesta nunca revela que un sitio existe.
Límites: 60 peticiones por minuto por red, 600 por minuto por sitio, lotes de hasta 10 mensajes y cuerpos de hasta 64 KB. No admite transmisión (SSE).
Enciéndelo o apágalo
En Docs, Ajustes, AI & MCP, la sección “For agents” tiene el interruptor MCP server (encendido por omisión), la URL con un botón de copiar y fragmentos listos para Claude Code, Claude Desktop, Cursor y VS Code.
Ver también API y MCP