Saltar al contenido principal

MCP Servers

El catálogo de MCP Servers se encuentra bajo el encabezado Hub · Catalog y se describe como "Servidores MCP prediseñados que puede conectar a agentes de Beak o a cualquier cliente compatible con MCP." Cada servidor es una implementación MCP empaquetada y lista para producción que expone una o más herramientas. Los equipos conectan un servidor a su tenant en pocos clics: el Hub almacena las credenciales, genera fragmentos de configuración del cliente y pone la conexión a disposición de los agentes y clientes compatibles con MCP de inmediato.

Tres tarjetas de estadísticas sobre la cuadrícula resumen el estado actual del catálogo:

  • Published servers — Recuento total de entradas de servidores MCP en el catálogo.
  • Total tools — Suma de todas las herramientas de todos los servidores publicados.
  • Categories — Recuento de categorías distintas en uso en el catálogo.

Búsqueda y filtro​

Una barra de búsqueda y un filtro de categorías se ubican sobre la cuadrícula de tarjetas:

  • Search the catalog — Filtra las tarjetas en tiempo real por nombre de servidor o eslogan. La entrada coincide con cadenas parciales sin distinguir mayúsculas de minúsculas.
  • Filtro de categorías — Un conjunto de botones de etiqueta, uno por cada categoría distinta presente en el catálogo. Seleccionar una categoría reduce la cuadrícula a las entradas de esa categoría únicamente. Seleccionar la misma categoría nuevamente elimina el filtro y devuelve todas las entradas.

Cada servidor MCP está representado por una tarjeta en una cuadrícula adaptable (una columna en móvil, dos en tableta, tres en pantallas anchas). La superficie de la tarjeta muestra:

  • Encabezado de categoría — La etiqueta de categoría del servidor, renderizada en el color de acento de la categoría.
  • Nombre del servidor — El identificador principal del servidor.
  • Eslogan — Una descripción de una línea de lo que hace el servidor.
  • Distintivo Connected — Se muestra solo cuando el usuario actual tiene una o más conexiones activas a este servidor. Si hay varias instancias conectadas, el distintivo muestra Connected · N.
  • Recuento de herramientas — Se muestra en la parte inferior de la tarjeta junto a la cadena de versión con el formato N tools · vX.Y.
  • Enlace View — Abre la página de detalle del servidor.

Página de detalle del servidor​

Al hacer clic en cualquier tarjeta se navega a la página de detalle del servidor. El encabezado muestra el nombre del servidor, el encabezado de categoría, el eslogan, la versión, el recuento de herramientas y el número de instancias conectadas, si existe alguna. Un enlace Back to catalog regresa a la cuadrícula.

Conectar / Agregar instancia​

El botón de acción principal en la parte superior derecha del encabezado de detalle es:

  • Connect — Se muestra cuando no hay instancias conectadas. Abre el diálogo de conexión para registrar la primera instancia.
  • Add instance — Se muestra cuando ya hay una o más instancias conectadas. Abre el mismo diálogo de conexión para registrar una instancia adicional.

Panel de conexiones​

Cuando al menos una instancia está conectada, aparece una sección Connections encima de las pestañas. Cada fila del panel muestra:

  • Una marca de verificación verde que indica que la conexión está activa.
  • Nombre de instancia — La etiqueta asignada al crear la conexión.
  • Alcance — Ya sea Shared with team (con alcance de tenant) o Just me (con alcance de usuario), más la fecha de último uso si la conexión ha sido utilizada.
  • Botón Disconnect — Elimina la conexión para esta instancia.

Pestañas de detalle​

Tres pestañas organizan el contenido de detalle del servidor:

  • Overview — Renderiza la descripción completa del servidor como markdown con formato.
  • Tools — Lista todas las herramientas expuestas por el servidor. Un campo de búsqueda en la parte superior de la lista filtra por nombre o descripción de herramienta. Cada fila de herramienta muestra el nombre de la herramienta (en monoespaciado) y su descripción.
  • Docs — Renderiza la documentación extendida del servidor como markdown con formato.

Diálogo de conexión​

El diálogo de conexión se abre al hacer clic en Connect o Add instance. Recopila los datos necesarios para registrar una instancia de backend:

Sección de instancia​

  • Name — Una etiqueta corta (hasta 80 caracteres) que distingue este backend de otras conexiones al mismo servidor. Ejemplos mostrados en el marcador de posición: Prod, Sandbox, Team A.

Sección de alcance​

  • Just me — La conexión es privada para el usuario actual. Solo los agentes de ese usuario pueden utilizarla.
  • Share with my team — La conexión se comparte en todo el tenant. Visible solo para administradores del tenant; los usuarios regulares ven la opción deshabilitada.

Nota: Un tercer tipo de conexión es propiedad de una identidad de agente en lugar de una persona. Se crea para el agente a través de la API de conexiones interna del Hub, no desde este diálogo, y cada tools/call sobre ella se autoriza contra los alcances del agente antes de que el Hub la reenvíe — una llamada rechazada devuelve un error JSON-RPC con el motivo. Consulte Governing an Agent from Any Platform.

Sección de configuración​

Los campos no confidenciales requeridos por el servidor se recopilan aquí. Cada campo muestra una etiqueta y una marca opcional si no es obligatorio.

Sección de credenciales​

Los campos confidenciales (claves API, tokens, contraseñas) requeridos por el servidor se recopilan aquí. Cada campo tiene un interruptor mostrar/ocultar para que los valores puedan verificarse antes de enviarlos.

Fragmentos post-conexión​

Tras una conexión exitosa, el diálogo pasa a un panel de fragmentos con dos secciones:

  • Hub-routed access — La ruta predeterminada: el cliente envía solicitudes al Hub Gateway, que las redirige al servidor MCP utilizando las credenciales almacenadas. Se muestra un token de portador (revelado una sola vez; cópielo antes de cerrar). Los fragmentos de configuración del cliente están disponibles en pestañas: Claude Desktop, Cursor, curl y Studio.
  • Standalone access — Una ruta alternativa para clientes que se comunican directamente con el servidor MCP (implementaciones adjuntas al cliente, en las instalaciones del cliente o servidores en su propio hostname). Aquí se muestran una clave API independiente y la ruta del endpoint MCP. La clave API puede pasarse como x-api-key, api-key o Authorization: Bearer ….

Nota: El token de portador y la clave API independiente se muestran una sola vez. Cópielos antes de cerrar el diálogo; no se pueden recuperar tras cerrarlo. Para obtener nuevas credenciales, desconecte y vuelva a conectar la instancia.

Mejores prácticas​

  • Asigne nombres descriptivos a las instancias (p. ej., Prod, EU-West, Sandbox) para que los compañeros de equipo puedan distinguirlas en el panel de conexiones sin necesidad de abrir la página de detalle del servidor.
  • Use el alcance Just me mientras prueba una nueva conexión; promuévala a Share with my team (solo administradores) una vez validada la configuración.
  • Si su cliente se comunica directamente con el servidor MCP en lugar de hacerlo a través del Hub Gateway, utilice las credenciales de Standalone access del panel de fragmentos.
  • La pestaña Tools es útil para verificar que las capacidades esperadas estén disponibles antes de integrar el servidor en un flujo de trabajo de agente.
  • Para rotar credenciales es necesario desconectar y volver a conectar una instancia; el nombre de la instancia puede reutilizarse.

Páginas relacionadas​

  • Overview — Página de inicio de Beak Hub y resumen del catálogo.
  • Agents — Explore agentes prediseñados que consumen herramientas de servidores MCP.
  • Agent Suites — Paquetes que incluyen servidores MCP junto con agentes y habilidades.
  • Tenants & API Keys — Registre tenants y gestione las claves API con las que se autentican sus servicios.