Un host de agente puede necesitar una conexión que pueda configurar. Un desarrollador de aplicaciones puede necesitar una biblioteca para importar en su código. Esos requisitos llevan a superficies de integración distintas.
¿Qué ofrece cada uno a quien lo consume?
Un servidor MCP proporciona una interfaz de protocolo; un SDK proporciona funciones y tipos para un lenguaje de programación.
La guía de arquitectura de MCP describe servidores que exponen capacidades a clientes conectados. Un servidor puede ejecutarse como proceso local o proporcionar un endpoint remoto.
| Interfaz | Consumidor | Qué usa el consumidor | Responsabilidad de ejecución |
|---|---|---|---|
| Servidor MCP | Un cliente MCP en un host de agente o aplicación | Solicitudes de protocolo y capacidades descubiertas | Alguien ejecuta el proceso del servidor o el servicio remoto |
| API SDK | Código de aplicación | Métodos de biblioteca que llaman a un API | La aplicación ejecuta la biblioteca y gestiona su integración |
| MCP SDK | Código que implementa un cliente o servidor MCP | Tipos de protocolo y utilidades de implementación | La aplicación sigue ejecutando el cliente o servidor resultante |
Un paquete SDK no se convierte en un servidor en ejecución solo porque lo instales.
¿Puede un servidor usar un SDK?
Sí. Un desarrollador puede usar un SDK de protocolo para implementar un servidor MCP y luego usar otra biblioteca cliente dentro de sus handlers.
La documentación de MCP SDK describe bibliotecas para construir clientes y servidores. Aquí, SDK identifica código usado para implementar el protocolo.
Un API SDK tiene un objetivo diferente: llama a la API de un servicio. Un servidor de pedidos hipotético podría exponer una herramienta de estado de pedido cuyo handler use un API SDK para obtener el pedido.
La interfaz externa MCP y la llamada interna API tienen contratos separados. Soportar una operación API no la expone automáticamente como herramienta MCP.
¿Qué responsabilidades permanecen en mi aplicación?
Tu aplicación sigue decidiendo qué operaciones solicitar. También decide cómo manejar sus resultados.
Con un API SDK, tu código selecciona un método y proporciona sus argumentos. Con MCP, el host enruta las solicitudes a través de un cliente hacia las capacidades expuestas del servidor.
La arquitectura de MCP deja el uso del contexto de modelo por parte del host fuera del alcance del protocolo. Una conexión de herramienta no decide tus reglas de negocio, política de autorización ni criterios de finalización.
Para una consulta de pedido, recibir el estado solicitado puede completar la tarea. Para enviar un mensaje, el envío y la entrega posterior son resultados distintos.
¿Cómo elijo una integración Bird?
Puedes conectar un host de agente compatible al servidor MCP de Bird, o integrar código de aplicación mediante un cliente API.
Para la vía de biblioteca, la decisión de Bird SDK cubre la elección entre un SDK y HTTP directo. Para la vía de herramientas, el inventario Bird de tu cliente proporciona los nombres de herramientas disponibles y los esquemas de entrada.
Compara la operación que necesitas en la interfaz que piensas usar. La presencia de una operación en una interfaz no garantiza su presencia en otra.
- Usa la conexión MCP cuando tu host necesite descubrir e invocar herramientas Bird.
- Usa un cliente API cuando tu código de aplicación seleccione e invoque las operaciones del servicio.
- Usa un MCP SDK cuando estés implementando el cliente o servidor de protocolo en sí.