Saltar al contenido principal
El Model Context Protocol (MCP) es un estándar de código abierto para conectar aplicaciones de IA a sistemas externos. Topsort proporciona un servidor MCP a través de Mintlify que brinda a los asistentes de IA acceso directo a nuestra documentación completa de API, permitiéndoles proporcionar información precisa y actualizada sobre nuestras APIs.
Piensa en MCP como un puerto USB-C para aplicaciones de IA. Así como USB-C proporciona una forma estandarizada de conectar dispositivos, MCP proporciona una forma estandarizada de conectar aplicaciones de IA a fuentes de datos externas como nuestra documentación de API.

Qué Puedes Hacer

Al conectarte al servidor MCP de Topsort, los asistentes de IA pueden:
  • Acceder a la documentación completa de API - Consultar detalles de endpoints, parámetros, esquemas de solicitud/respuesta y ejemplos
  • Obtener orientación precisa de integración - Recibir ejemplos de código e instrucciones de implementación actualizadas
  • Solucionar problemas más rápido - Referenciar rápidamente códigos de error, límites de tasa y métodos de autenticación
  • Mantenerse actualizado - Acceder siempre a la documentación de API más reciente sin actualizaciones manuales

Inicio Rápido

Nuestro servidor MCP está disponible en:
https://api.docs.topsort.com/mcp
El servidor MCP es de acceso público y no requiere autenticación. Sin embargo, necesitarás claves de API para usar realmente la API de Topsort en tus aplicaciones.

Guías de Integración

VS Code con GitHub Copilot

GitHub Copilot soporta servidores MCP tanto en el agente de codificación como en la interfaz de chat.

Requisitos Previos

  • VS Code versión 1.95.0 o posterior
  • Extensión GitHub Copilot instalada y activada
  • Extensión GitHub Copilot Chat instalada

Configuración

1

Abre la Configuración de VS Code

Presiona Cmd+, (Mac) o Ctrl+, (Windows/Linux) para abrir Configuración.
2

Navega a la Configuración MCP

Busca “MCP” en la barra de búsqueda de configuración, o navega a Extensions > GitHub Copilot > MCP.
3

Agrega el Servidor MCP de Topsort

Haz clic en Edit in settings.json y agrega:
{
  "github.copilot.chat.mcp.servers": {
    "topsort": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp"
    }
  }
}
4

Recarga VS Code

Presiona Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux), escribe “Developer: Reload Window” y presiona Enter.

ChatGPT

ChatGPT soporta servidores MCP remotos para suscriptores Plus y Team.
1

Abre la Configuración de ChatGPT

Navega a chat.openai.com y haz clic en el ícono de tu perfil, luego selecciona Settings.
2

Accede a Conexiones

Haz clic en Connections o Integrations en la barra lateral de configuración.
3

Agrega el Servidor MCP

Haz clic en Add Connection e ingresa: - Name: Topsort API Documentation
  • Server URL: https://api.docs.topsort.com/mcp - Transport Type: http

Claude Desktop

Claude Desktop proporciona soporte completo de MCP local.
1

Abre la Configuración de Claude Desktop

  • macOS: Haz clic en Claude en la barra de menú → Settings
  • Windows: Haz clic en FileSettings
2

Navega a la Pestaña de Desarrollador

Haz clic en la pestaña Developer en la barra lateral izquierda.
3

Edita la Configuración MCP

Haz clic en Edit Config y agrega:
{
  "mcpServers": {
    "topsort-api": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp",
      "description": "Topsort API Documentation"
    }
  }
}
4

Reinicia Claude Desktop

Guarda la configuración y reinicia Claude Desktop.

Otros Clientes MCP

Cursor

Agrega a tu configuración de Cursor:
{
  "mcp": {
    "servers": {
      "topsort": {
        "type": "http",
        "url": "https://api.docs.topsort.com/mcp"
      }
    }
  }
}

Windsurf Editor

Configura en ~/.windsurf/mcp.json:
{
  "servers": {
    "topsort": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp"
    }
  }
}

Continue

Agrega a ~/.continue/config.json:
{
  "mcpServers": {
    "topsort": {
      "transport": {
        "type": "http",
        "url": "https://api.docs.topsort.com/mcp"
      }
    }
  }
}

Cline

Configura en ~/Documents/Cline/MCP/config.json:
{
  "topsort": {
    "type": "http",
    "url": "https://api.docs.topsort.com/mcp"
  }
}

Solución de Problemas

Problemas de Conexión

  • Verifica que la URL sea correcta: https://api.docs.topsort.com/mcp
  • Verifica tu conexión a internet
  • Reinicia la aplicación cliente MCP
  • Revisa los registros específicos del cliente para mensajes de error

El Servidor No Responde

  • Verifica que el tipo de transporte esté configurado en http
  • Verifica si tu firewall o VPN está bloqueando la conexión
  • Consulta nuestra página de estado para ver si hay interrupciones del servicio
Aunque el servidor MCP en sí no requiere autenticación, aún necesitarás claves de API válidas para usar realmente la API de Topsort en tus aplicaciones. Nunca compartas tus claves de API en conversaciones o las confirmes en control de versiones.

Más Información

¿Necesitas ayuda con tu integración de Topsort?

Habla con nosotros, el equipo de ingeniería de integraciones.Contáctanos a través de tu canal de mensajería dedicado o en support@topsort.com.Si aún no eres cliente, agenda una demo con nuestro equipo de ventas.