Documentación Oficial de MCP en Español
  1. Conceptos
Documentación Oficial de MCP en Español
  • Empezar
    • Introducción
    • Servidores de ejemplo
    • Clientes de ejemplo
    • Inicio rápido
      • Para desarrolladores de servidores
      • Para desarrolladores de clientes
      • Para usuarios de Claude Desktop
  • Tutoriales
    • Construyendo MCP con LLMs
    • Depuración
    • Inspector
  • Conceptos
    • Arquitectura central
    • Recursos
    • Indicaciones
    • Herramientas
    • Muestreo
    • Raíces
    • Transportes
  • Desarrollo
    • Qué hay de nuevo
    • Hoja de ruta
    • Contribuyendo
  1. Conceptos

Transportes

Aquí está la traducción al español del contenido en formato Markdown:
Aprenda sobre los mecanismos de comunicación de MCP
Los transportes en el Model Context Protocol (MCP) proporcionan la base para la comunicación entre clientes y servidores. Un transporte maneja la mecánica subyacente de cómo se envían y reciben los mensajes.

Formato de Mensaje#

MCP utiliza JSON-RPC 2.0 como su formato de transmisión. La capa de transporte es responsable de convertir los mensajes del protocolo MCP al formato JSON-RPC para su transmisión y de convertir los mensajes JSON-RPC recibidos de nuevo a mensajes del protocolo MCP.
Hay tres tipos de mensajes JSON-RPC utilizados:

Solicitudes#

Respuestas#

Notificaciones#

Tipos de Transporte Integrados#

MCP incluye dos implementaciones de transporte estándar:

Entrada/Salida Estándar (stdio)#

El transporte stdio permite la comunicación a través de flujos de entrada y salida estándar. Esto es particularmente útil para integraciones locales y herramientas de línea de comandos.
Use stdio cuando:
Construya herramientas de línea de comandos
Implemente integraciones locales
Necesite una comunicación de proceso simple
Trabaje con scripts de shell
TypeScript (Servidor)

Eventos Enviados por el Servidor (SSE)#

El transporte SSE permite la transmisión de servidor a cliente con solicitudes HTTP POST para la comunicación de cliente a servidor.
Use SSE cuando:
Solo se necesita transmisión de servidor a cliente
Trabaje con redes restringidas
Implemente actualizaciones simples
TypeScript (Servidor)

Transportes Personalizados#

MCP facilita la implementación de transportes personalizados para necesidades específicas. Cualquier implementación de transporte solo necesita ajustarse a la interfaz de Transporte:
Puede implementar transportes personalizados para:
Protocolos de red personalizados
Canales de comunicación especializados
Integración con sistemas existentes
Optimización del rendimiento
TypeScript
Python
Tenga en cuenta que, si bien los servidores MCP a menudo se implementan con asyncio, recomendamos implementar interfaces de bajo nivel como los transportes con anyio para una compatibilidad más amplia.

Manejo de Errores#

Las implementaciones de transporte deben manejar varios escenarios de error:
1.
Errores de conexión
2.
Errores de análisis de mensajes
3.
Errores de protocolo
4.
Tiempos de espera de la red
5.
Limpieza de recursos
Ejemplo de manejo de errores:
TypeScript
Python
Tenga en cuenta que, si bien los servidores MCP a menudo se implementan con asyncio, recomendamos implementar interfaces de bajo nivel como los transportes con anyio para una compatibilidad más amplia.

Mejores Prácticas#

Al implementar o usar el transporte MCP:
1.
Maneje el ciclo de vida de la conexión correctamente
2.
Implemente un manejo de errores adecuado
3.
Limpie los recursos al cerrar la conexión
4.
Use tiempos de espera apropiados
5.
Valide los mensajes antes de enviarlos
6.
Registre los eventos de transporte para la depuración
7.
Implemente la lógica de reconexión cuando sea apropiado
8.
Maneje la contrapresión en las colas de mensajes
9.
Supervise el estado de la conexión
10.
Implemente medidas de seguridad adecuadas

Consideraciones de Seguridad#

Al implementar el transporte:

Autenticación y Autorización#

Implemente mecanismos de autenticación adecuados
Valide las credenciales del cliente
Use un manejo seguro de tokens
Implemente comprobaciones de autorización

Seguridad de Datos#

Use TLS para el transporte de red
Cifre los datos confidenciales
Valide la integridad del mensaje
Implemente límites de tamaño de mensaje
Limpie los datos de entrada

Seguridad de la Red#

Implemente la limitación de velocidad
Use tiempos de espera apropiados
Maneje escenarios de denegación de servicio
Supervise patrones inusuales
Implemente reglas de firewall adecuadas

Depuración del Transporte#

Consejos para depurar problemas de transporte:
1.
Habilite el registro de depuración
2.
Supervise el flujo de mensajes
3.
Verifique los estados de conexión
4.
Valide los formatos de mensaje
5.
Pruebe escenarios de error
6.
Use herramientas de análisis de red
7.
Implemente comprobaciones de estado
8.
Supervise el uso de recursos
9.
Pruebe casos extremos
10.
Use un seguimiento de errores adecuado
Previous
Raíces
Next
Qué hay de nuevo
Built with