Tu agente de código lee
la documentación que tu equipo ya escribió.
16 herramientas, ocultadas por alcance
Cada herramienta delega en un caso de uso que el producto ya tenía, así que no hay una segunda vía de acceso ni un segundo conjunto de reglas. Una clave de solo lectura ni siquiera ve las herramientas de escritura: no se trata solo de rechazar la llamada.
readTodo lo que un agente necesita para encontrar y entender lo que tu equipo ya escribió.- list_projects
- Los proyectos que esta credencial puede leer, con recuentos y una URL que una persona puede abrir.
- list_repositories
- Los proyectos con sus repositories anidados, además de lo que la credencial puede alcanzar — así un proyecto que no se te concedió se distingue de uno que no existe.
- list_tree
- La estructura de carpetas de un repository. La forma del árbol es cómo el equipo organiza lo que sabe.
- list_documents
- El mapa del corpus: cada documento legible con su título, una línea sobre lo que cubre, su URL de lectura y su estado de revisión.
- search_docs
- Búsqueda de texto completo en cada repository accesible en una sola consulta; cada resultado lleva una URL, una uri de recurso y su estado.
- read_doc
- El markdown sin procesar de un documento tal como está guardado. Ninguna petición a GitHub ni a GitLab, así que no cuenta contra el límite de peticiones del repository.
- read_changes
- El diff entre la versión que una persona validó y el texto actual — para que un aviso de desfase se pueda atender en lugar de adivinarse.
- list_notes
- Los comentarios abiertos que dejó una persona, con el encabezado al que se refieren y si se escribieron sobre una versión anterior.
- list_artifacts
- Los artifacts escritos en un proyecto: ruta, título, versión actual y cuándo cambió por última vez.
- read_artifact
- El cuerpo actual de un artifact. La escritura no admite parches, así que revisar uno implica leerlo primero.
- list_tickets
- marketing.data.mcp-tool.list_tickets
- read_handbook
- Lee el Handbook del proyecto: lo que hace el producto hoy, aprobado por una persona, sin nada que no esté construido.
bundleCarpetas enteras, limpias y contadas, en un solo bloque de texto.- bundle_docs
- Varios documentos concatenados y limpios — sin front matter ni badges, con los enlaces reescritos — con una estimación de tokens.
write_artifactsSe concede por separado y solo alcanza el espacio de nombres de los artifacts. A una clave de solo lectura no se le muestran estas herramientas.- write_artifact
- Archiva un documento markdown en el espacio de nombres de artifacts de un proyecto, versionado, con una URL que una persona puede abrir. Nunca puede llegar a un documento del repository.
- reply_to_note
- Responde a una nota con de acuerdo, en desacuerdo, necesita aclaración o atendido. Un desacuerdo tipado es un estado del flujo de trabajo que alguien puede contar.
- report_implementation
- Indica que el trabajo ha empezado o que ya existe. Se exige una prueba, que se guarda como nota. Registra una afirmación, nunca una finalización.
Cuatro cosas que ningún tool puede hacer
Ausencias, no ajustes. No hay ninguna bandera que active ninguna de ellas, y ese es el objetivo: un permiso que un administrador puede conceder es un permiso que alguien acaba concediendo.
Ningún tool modifica un documento del repository
Ni una. Un agente escribe en el espacio de nombres de los artifacts o en ningún sitio; nada en esta superficie puede llegar a un archivo del worker de sincronización, cambiar una branch ni redirigir una raíz de documentación.
Ningún agente puede cerrar una nota
Una respuesta lleva una nota, como mucho, a «pendiente de confirmación». No hay herramienta para resolver, con ningún argumento, y ninguna respuesta cambia un estado. Solo una persona cierra un comentario.
Ningún agente puede eliminar un artifact
No hay herramienta de borrado. El trabajo de una credencial de escritura es producir, no deshacerse de aportaciones humanas — incluidos sus propios borradores anteriores, que conservan sus versiones.
Ninguna pregunta de texto libre sobre la superficie
Un agente puede hacer una pregunta que ofreció el resumen actual, y nada más. Sin ese filtro, una clave es un canal no validado y pagado por la organización hacia un modelo de terceros.
Un agente puede afirmar que un comentario está atendido. Solo una persona puede cerrarlo.
Es la frase por la que un equipo adopta el producto, y es una función con un test y no una política en un documento.
- Agente
search_docs«idempotency» en 6 repositories · 3 resultados
- 01AgenteLee lo que el equipo ya escribiósearch_docs en cada repository al que puede llegar, y luego read_doc para los que importan. Nada pegado en un prompt, nada desactualizado.
- 02AgenteArchiva lo que produjowrite_artifact deja una especificación, un plan de migración o una revisión en el proyecto junto a la documentación, versionados, con una URL que una persona puede abrir.
- 03PersonaObjeta, sobre un encabezadoUn revisor deja una nota anclada a la sección a la que se refiere. El agente la ve con list_notes, junto con la versión sobre la que se escribió.
- 04AgenteResponde, y puede discreparde acuerdo, en desacuerdo, necesita aclaración o atendido. Un desacuerdo tipado es una cola que un responsable abre el lunes; una transcripción es algo que nadie lee dos veces.
- 05PersonaLa cierra, o noEn cualquier caso, la nota espera a un humano. Es la asimetría para la que existe toda esta capa, y se impone en una sola función.
A una credencial se le puede decir qué documentos existen
Fija un estado de revisión mínimo en una clave y todo lo que quede por debajo responde 404 en cada puerta: ni filtrado, ni atenuado.
El umbral vive en la credencial y no en un argumento de herramienta, y en eso consiste todo el diseño: un filtro que pasa el agente es un filtro que un prompt puede convencerle de no pasar. También se aplica a las rutas del lector, porque un umbral que se detiene en una superficie es un umbral con una segunda puerta de entrada.
Dos consecuencias parecen errores y no lo son. Un documento que nadie ha clasificado no tiene ningún estado, así que un umbral validado sobre un corpus sin clasificar no admite nada — la consola te lo avisa antes de emitir la clave. Y rechazado no es un peldaño bajo de la escala: significa «no construyas esto», así que todo umbral por encima de borrador lo excluye en lugar de ponerlo al final.
- Pertenece a
- A la organización, nunca a quien la emitió.
- Llega a
- Exactamente un proyecto. No existe una clave para toda la organización.
- Alcances
- read, bundle, write_artifacts — elegidos al emitirla.
- Umbral de revisión
- Opcional, y se rechaza en una clave que puede escribir.
- Se guarda como
- Un hash. El valor se muestra una vez y nunca más.
- Revocación
- Surte efecto en la siguiente petición — nada guarda la comprobación en caché.
Dale a tu agente la documentación en lugar del prompt.
Las herramientas de lectura están en todos los planes, incluido Free. Con límite de peticiones, nunca medidas.
Empezar gratis