Documentación: conectar DeployIt a su Claude
Todo DeployIt cabe en una página: conectarse, cinco herramientas y cómo leer una respuesta.
Conectarse
Su administrador le ha dado el enlace de su empresa. Se parece a esto:
https://mcp.deployit.ai/acme/k7mq-x2pf-9tdrEn Claude
- Abra Personalizar, después Conectores, y añada un conector personalizado. En una cuenta Team o Enterprise, lo añade una vez un propietario para toda la organización, desde Configuración de la organización, después Conectores; después cada persona hace clic en «Conectar».
- Pegue el enlace. Claude abre una página de DeployIt: indique su nombre y su correo (la dirección no se verifica).
- Listo. Haga una pregunta: «¿Qué sabes de este producto?»
En Claude Code
claude mcp add --transport http deployit https://mcp.deployit.ai/acme/k7mq-x2pf-9tdrEn la primera pregunta, Claude Code abre la misma página de registro.
Conexión automática (beta, bajo petición)
Si su organización de Claude gestiona los inicios de sesión mediante su proveedor de identidad, la conexión automática puede registrarle sin escribir nada. Está en beta, bajo petición: su administrador de DeployIt nos escribe para abrirla. Su dirección queda entonces acreditada cuando el emisor es Claude o cuando su proveedor de identidad la marca como verificada; si no, sigue siendo declarada.
Para el administrador
- En la configuración de la conexión automática de su organización de Claude, rellene siempre «Tenant ID» con el identificador de su empresa en DeployIt (la parte de su enlace que sigue a mcp.deployit.ai/): solo su empresa recibe entonces sus aserciones.
- Una vez activada la conexión automática, el identificador de su empresa ya no cambia.
- Un perfil que usted haya asignado de antemano a una dirección solo se da a una dirección acreditada: el emisor es Claude, o su proveedor de identidad marca la dirección como verificada. Si no, la persona entra con «Todos».
- Una persona que usted haya retirado no vuelve por la conexión automática.
DeployIt es un servidor MCP en HTTP, con una autorización OAuth abierta a Claude (web y escritorio) y a los clientes locales como Claude Code. Los demás clientes web no pueden registrarse, y Cursor o Windsurf aún no pueden.
Una antigua dirección con clave responde «este enlace ha cambiado»: pida el enlace de su empresa a su administrador.
Las cinco herramientas
No tiene que llamarlas: el asistente elige. Ninguna modifica sus repositorios ni sus ajustes; cada llamada queda registrada en el registro de su empresa; una herramienta de su empresa que usted abra al agente actúa con sus propios derechos.
| Herramienta | Perfiles | Recibe | Devuelve |
|---|---|---|---|
| server_info | Todos | nada | El producto, sus repositorios, la frescura de la lectura y lo que abre su perfil. |
| ask_code | Todos, Desarrolladores, Dirección | una pregunta y, si hace falta, «profundizar», si su perfil lo permite | Una respuesta, su estado y lo que se consultó. De 20 a 60 segundos la primera vez; inmediato después para la misma pregunta en los mismos términos y sin contexto, mientras el código no haya cambiado. |
| recent_changes | Todos, Desarrolladores, Dirección | un número de días, de 1 a 90, 14 por defecto; si hace falta, un repositorio | Lo que llegó a la rama seguida, agrupado en entregas (por PR, o por día, módulo y tipo): fecha, tipo, título, módulos, número de commits; sin nombre de persona. Inmediato. |
| stats_schema | Dirección, Herramienta de datos | nada | Los conjuntos de estadísticas, la definición de cada medida y la hora del último cálculo. |
| stats_query | Dirección, Herramienta de datos | una consulta estructurada: conjunto de datos, periodo, filtros, agrupaciones, medidas, límite | Filas: por equipo o por desarrollador, por mes, trimestre, semestre o año. |
El servidor ofrece además tres peticiones listas para usar, para que la misma tabla vuelva idéntica de un mes a otro:
| Petición | Perfiles | Devuelve |
|---|---|---|
team_reportperiod_unit, period (opcionales) | Dirección | El seguimiento del equipo en un periodo. |
developer_profiledeveloper · period_unit, period (opcionales) | Dirección | La ficha de un desarrollador en un periodo. |
what_changeddays (opcional, 7 por defecto) | Todos, Desarrolladores, Dirección | Lo que ha cambiado en el producto. |
Leer una respuesta
Cada respuesta sobre el código lleva un estado. Él dice si puede repetirla.
- Verificado
verified - Confirmado en el código. Puede repetirlo.
- Solo en el servidor
backend_only - El producto sabe hacerlo, pero ninguna pantalla lleva a ello.
- No encontrado
not_found - Buscado sin encontrarse: muy probablemente ausente del producto. No es una prueba.
- Sin conclusión
unknown - La investigación no ha llegado a término. No la repita como un hecho; vuelva a preguntar con «profundizar», si su perfil lo permite.
Cuando DeployIt no responde
- Un administrador ha retirado su acceso.
- El tema es uno de los que su empresa ha rechazado.
- Se ha alcanzado su límite mensual de preguntas (el perfil «Todos» tiene uno por defecto).
- Su empresa ha alcanzado el volumen mensual de preguntas previsto por su plan: el contador vuelve a empezar el mes siguiente.
- El plan gratuito ha usado sus 15 preguntas de la semana: vuelven el lunes.
- Sin plan ni prueba, el perfil «Dirección» no ve las herramientas de estadísticas, y una clave de herramienta de datos recibe un rechazo.
Cada rechazo se comunica con claridad a su asistente, que se lo repite.
Las estadísticas
Hechos escritos una vez por commit integrado, actualizados cada noche. Cada fila se enlaza con sus commits.
Los conjuntos de datos
- commits
- Un commit integrado: su autor, su fecha de llegada, su PR, sus pruebas, su ticket, su módulo, su nota y sus cinco criterios.
- pull_requests
- Una PR: quién la abrió, quién la revisó (un compañero, no su autor ni un robot), en cuánto tiempo.
- reviews
- Una revisión: quién revisó qué PR, si es un compañero del autor, y su veredicto (aprobada, cambios solicitados; en GitLab, solo las aprobaciones).
- defects
- Un defecto: el commit de origen, su corrección, quién corrigió y si está «confirmado» o «por confirmar».
- people
- Una persona seguida o un agente de código: sus identidades, su rol, su tiempo de trabajo, si es un proveedor externo.
- absences
- Los periodos de ausencia declarados para una persona, para leer su actividad sin falsas caídas.
- repositories
- Los repositorios cubiertos, su rama de llegada, desde cuándo se lee su historial y la hora del último cálculo.
- module_ownership
- Quién ha escrito cada módulo en los últimos 12 meses, para ver los que dependen de una sola persona.
- person_period, team_period
- Las síntesis por desarrollador y por equipo, por mes, trimestre, semestre o año.
Las columnas de cada conjunto, la definición de cada medida y los límites se leen con la herramienta stats_schema: es la que hace fe.
Las reglas de lectura
- La nota del código es una media: siempre se entrega con el número de commits que resume.
- Un defecto se revela a posteriori: los últimos 60 días aún no están maduros, y la herramienta
stats_schemalo dice. - Un periodo cerrado todavía puede moverse (un commit llegado tarde, dos identidades unidas, un defecto descartado): cada síntesis lleva la hora de su último cálculo.
- Solo cuenta el trabajo que llega a la rama de llegada de cada repositorio, y cuenta a su llegada: un commit fechado antes pero integrado este mes cuenta para este mes. Los robots se excluyen; los agentes de código detectados se cuentan aparte; un agente no declarado cuenta como trabajo humano.
Conectar una herramienta de datos
Un almacén de datos o una herramienta de BI no se registra: presenta una clave de «Herramienta de datos», creada por un administrador y mostrada una sola vez, en una cabecera.
POST https://mcp.deployit.ai/acme
Authorization: Bearer dpk_…Llama a stats_query y sigue el cursor para leer todas las filas. Un commit puede cambiar después (un defecto se revela en 60 días): relea al menos los últimos 60 días en cada pasada. La clave no abre ninguna pregunta sobre el código.
Límites
- 120 llamadas por minuto y por persona; 600 por minuto para una clave de herramienta de datos.
- La espera se limita a un minuto; después, la investigación continúa en segundo plano: repita la misma pregunta un poco más tarde, con las mismas palabras y sin contexto.
- Plan gratuito: 15 preguntas sobre el código por semana para toda la empresa, de lunes a domingo. Una respuesta ya conocida no cuenta.
- En un plan, las preguntas están incluidas dentro de un uso normal, visible en su espacio. El perfil «Todos» tiene por defecto un límite de 40 preguntas por mes y por persona; el administrador ajusta este límite, perfil por perfil. Una vez alcanzado, las respuestas ya conocidas se siguen sirviendo.
- Una consulta de estadísticas devuelve como máximo 5000 filas (500 para el perfil Dirección) y responde en 10 segundos como máximo; por encima, siga el cursor o divida por periodo.
- La demostración responde con el perfil «Todos», sin estadísticas, y limita el número de preguntas por dirección.
Dirección de la demostración:
https://mcp.deployit.ai/demoConecte su código y haga su primera pregunta
30 días de prueba, sin tarjeta bancaria. DeployIt lee sus repositorios: ningún commit, ninguna rama, ninguna PR.