Conectores
Conecta servidores MCP remotos para que las revisiones y tareas puedan comprobar lo que el código por sí solo no muestra: cómo se usa una funcionalidad, qué dicen los logs, los datos de una tabla o la documentación de una biblioteca. Los conectores están incluidos en los planes de pago.
Añadir un conector
Solo un propietario de la organización de GitHub, o el propietario de una cuenta personal, puede gestionar conectores. Configuración del espacio de trabajo → Miembros los marca como Propietario de GitHub o Propietario de la cuenta.
En el plan gratuito, también después de que termine un plan de pago, las revisiones y tareas no usan los conectores guardados, y solo puedes eliminarlos.
- Abre Configuración del espacio de trabajo → Conectores y selecciona Añadir conector.
- Introduce un nombre, el punto final HTTPS del servidor y los encabezados de la solicitud que necesita, y selecciona Cargar herramientas.
- Elige las herramientas que quieres permitir, los repositorios y dónde usar el conector.
- Selecciona Guardar conector. Las revisiones y tareas que se inicien a partir de entonces pueden usarlo.
| Campo | Qué introducir |
|---|---|
| Nombre | Qué contiene el conector, como Analítica de producción. |
| Punto final HTTPS | La dirección Streamable HTTP del servidor, como https://mcp.your-service.com/mcp. |
| Encabezados de la solicitud | Las credenciales que espera el servidor, como Authorization: Bearer <token>. Los valores se almacenan cifrados y no se vuelven a mostrar. |
| Notas para HeyDeer | Opcional: qué contiene el conector y cuándo es útil. |
Al editar un conector, deja vacío el valor de un encabezado para conservar el guardado. Si cambias el punto final, vuelve a introducir todos los valores.
Requisitos del punto final y los encabezados
- El punto final no puede incluir una cadena de consulta, un fragmento
#, un nombre de usuario o una contraseña, ni un puerto distinto de 443. - Necesita un nombre de dominio público, no una dirección IP ni un nombre terminado en
.local,.internal,.test,.invalid,.exampleolocalhost. - Un conector puede tener hasta 10 encabezados, cada uno con un valor de hasta 8192 caracteres ASCII imprimibles.
- Un espacio de trabajo puede tener hasta 50 conectores.
Herramientas
Herramientas de solo lectura muestra las herramientas que el servidor marca como de solo lectura. Todas las demás, incluidas las que el servidor no marca, están en Otras herramientas. Cuando cargas las herramientas por primera vez, solo se permiten las de solo lectura.
| Ejecución | Herramientas que puede llamar |
|---|---|
| Revisiones y Autopilot | Herramientas de solo lectura permitidas |
| Corregir con HeyDeer y menciones a @heydeer | Todas las herramientas permitidas, de solo lectura u otras |
Un agente solo puede llamar a las herramientas permitidas y decide cuándo le resulta útil una. Si cambian las herramientas del servidor, selecciona Recargar herramientas.
Dónde se usan los conectores
Un conector se aplica a todos los repositorios o a los que selecciones. Una tarea que trabaja en varios repositorios recibe los conectores de cualquiera de ellos.
De forma predeterminada, un conector solo se usa en repositorios privados, para cambios de personas con acceso de escritura. Una revisión o tarea lo excluye cuando:
- el repositorio es público o una tarea puede cambiar un repositorio público;
- el pull request proviene de un fork;
- el autor del pull request no puede escribir en el repositorio.
Elige También repositorios públicos y forks solo para conectores cuyos datos pueda ver cualquiera, como documentación pública. La página de la revisión o tarea muestra qué conectores excluyó y por qué.
Llamadas a conectores
La página de una revisión o tarea muestra cada llamada a un conector: el conector, la herramienta, cuándo se ejecutó, cuánto tardó y si falló. HeyDeer no guarda lo que se envió ni lo que se devolvió.
Las llamadas a herramientas y el texto que devuelven forman parte del trabajo, así que aumentan los créditos que consume. Si una revisión falla después de llamar a un conector, sus créditos no se devuelven. Consulta Cómo funcionan los créditos.
Privacidad y confianza
El agente nunca ve los valores de los encabezados: el sandbox de HeyDeer los añade a las solicitudes del agente al salir.
Las solicitudes pueden incluir código y contexto de la tarea, que el operador del servidor trata según sus propias políticas. Incluso una herramienta de solo lectura puede devolver datos privados, así que conecta solo servicios de confianza, usa credenciales sin más acceso del necesario, como un rol de base de datos de solo lectura, y permite solo las herramientas que necesites. Consulta Seguridad.
Si HeyDeer no puede cargar las herramientas de un conector, consulta Solución de problemas.