Mcp

Visión general

El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que conecta tus funciones a LLMs y aplicaciones de IA. Con la integración de Mintlify, puedes generar automáticamente un servidor MCP a partir de tu documentación existente o especificaciones OpenAPI, permitiendo interacciones fluidas con tu producto impulsadas por IA.

Guía de uso rápido

Cualquier documentación pública alojada en Mintlify puede ser extraída como un servidor MCP usando un simple comando:

npx mint-mcp add <your-subdomain-or-domain>

Examples:

# Using subdomain
npx mint-mcp add mintlify

# Using domain
npx mint-mcp add mintlify.com

Autenticación

Cuando ejecutes el comando, necesitarás proporcionar dos claves de API,External Admin KeyyAssistant API Key.

Estas se pueden encontrar en tuMintlify DashboardbajoSettings > API Keys.

Seleccionar clientes MCP

Después de la autenticación, elegirás qué clientes MCP habilitar para tu servidor:

Una vez configurado, tu servidor MCP está listo para usar con el comando proporcionado en la terminal.

Configurando tu servidor MCP

Ahora veamos cómo configurar tu servidor MCP.

Funcionalidad predeterminada

Todos los servidores MCP incluyen la herramientasearchpor defecto, permitiendo a los usuarios consultar información en toda tu documentación.

Agregando funciones de API

Si tienes una especificación OpenAPI, puedes exponer endpoints específicos como herramientas MCP usando la extensiónx-mcpa nivel de archivo o endpoint.

Configuración a nivel de archivo

Habilita MCP para todos los endpoints en un archivo de especificación:

{
  "openapi": "3.1.0",
  "x-mcp": {
    "enabled": true
  },
  // Other OpenAPI content
}

Configuración a nivel de endpoint

Habilita MCP solo para endpoints específicos:

{
  "paths": {
    "/api/v1/users": {
      "x-mcp": {
        "enabled": true
      },
      // Endpoint configuration
    }
  }
}

Manejo de autenticación

Si tu especificación OpenAPI define autenticación usando securitySchemes, estos métodos de autenticación se aplicarán automáticamente a tu servidor MCP.

Monitoreando tu servidor MCP

Después de publicar tus cambios, puedes ver todas las herramientas MCP disponibles en la secciónAvailable Toolsen la página del servidor MCP en tu panel de control.

Distribución

Instalación del usuario

Tus usuarios pueden instalar y usar tu servidor MCP con:

npx mint-mcp add <your-subdomain-or-domain>

Esto les proporciona un servidor MCP listo para usar que conecta tus funciones documentadas a aplicaciones de IA.