Servidor MCP

Todos los sitios de Jamdesk incluyen un servidor MCP (Model Context Protocol) integrado. Mientras que llms.txt ofrece a las herramientas de IA una instantánea estática de tu documentación, MCP les permite buscar y consultar de forma interactiva, algo útil cuando los agentes de IA necesitan encontrar respuestas concretas en lugar de leerlo todo.

¿Qué es MCP?

El Model Context Protocol es un estándar abierto que permite a las herramientas de IA acceder a fuentes de datos externas. Tu documentación de Jamdesk expone dos herramientas a través de MCP:

Tu URL de endpoint

Tu endpoint de MCP es la URL de tu documentación con /_mcp añadido. Si tienes un dominio personalizado activo, úsalo:

Configuración rápida

claude mcp add --transport http my-docs https://docs.acme.com/_mcp

Herramientas disponibles

searchDocs

Busca en tu documentación y obtén resultados clasificados.

Parámetros:

Solicitud de ejemplo:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "searchDocs",
    "arguments": {
      "query": "authentication",
      "limit": 5
    }
  }
}

Respuesta de ejemplo:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"query\":\"authentication\",\"total\":1,\"results\":[{\"title\":\"Authentication\",\"description\":\"How to authenticate API requests\",\"url\":\"/docs/api/authentication\",\"type\":\"api\",\"score\":0.95}]}"
    }]
  }
}

getPage

Recupera el contenido completo de una página de documentación específica.

Parámetros:

Solicitud de ejemplo:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "getPage",
    "arguments": {
      "slug": "api/authentication"
    }
  }
}

Respuesta de ejemplo:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"title\":\"Authentication\",\"description\":\"How to authenticate\",\"content\":\"## Overview\\n\\nUse API keys to authenticate...\",\"url\":\"/docs/api/authentication\"}"
    }]
  }
}

Probar el endpoint

Puedes probar tu endpoint de MCP directamente con curl:

# List available tools
curl -X POST https://docs.acme.com/_mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Search for content
curl -X POST https://docs.acme.com/_mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"searchDocs","arguments":{"query":"getting started"}}}'

Cómo funciona

El endpoint de MCP utiliza un índice de búsqueda que se genera junto con tu documentación:

• Clasificación BM25 - Clasifica los resultados por relevancia
• Coincidencia difusa - Gestiona errores tipográficos (tolerancia de 1 carácter)
• Ponderación de campos - Los títulos y los encabezados de sección tienen más peso que el contenido del cuerpo
• Filtrado por tipo - Filtra los resultados por tipo de contenido (API, guía, etc.)

El índice se reconstruye con cada despliegue.

Límites de frecuencia

El endpoint de MCP tiene un límite de frecuencia de 60 solicitudes por minuto por dirección IP. Esto es suficiente para el uso normal de un asistente de IA. Si superas el límite, recibirás una respuesta 429.

Solución de problemas

curl https://docs.acme.com/_mcp

¿Qué sigue?