MCP Server

Cada sitio de Jamdesk incluye 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 — útil cuando los agentes de IA necesitan encontrar respuestas específicas 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:

Configuración rápida

claude mcp add --transport http my-docs https://my-project.jamdesk.app/_mcp

Herramientas disponibles

searchDocs

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

Parámetros:

Ejemplo de solicitud:

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

Ejemplo de respuesta:

{
  "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:

Ejemplo de solicitud:

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

Ejemplo de respuesta:

{
  "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\"}"
    }]
  }
}

Prueba del endpoint

Puedes probar tu endpoint MCP directamente con curl:

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

# Search for content
curl -X POST https://my-project.jamdesk.app/_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 MCP utiliza un índice de búsqueda construido junto con tu documentación:

• Ranking BM25 - Ordena los resultados por relevancia
• Coincidencia difusa - Maneja errores tipográficos (tolerancia de 1 carácter)
• Potenciación de campos - Los títulos y encabezados de sección tienen mayor 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 velocidad

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

Solución de problemas

curl https://my-project.jamdesk.app/_mcp

¿Qué sigue?