Conecta tu agente con MCP

Conecta tu agente de IA a SeeRepo y podrá leer el mapa de tu proyecto mientras trabaja: qué hace un módulo, dónde vive una parte, qué cambió desde ayer y las cifras del proyecto. Lee; con una clave a la que le permitas escribir, también hace cuatro cambios pequeños, cada uno solo después de que digas que sí. Viene en todos los planes.

Conectar con una clave de API

La dirección del servidor es:

https://seerepo.com/api/mcp

Usa Streamable HTTP, y cada petición lleva una clave de API como token Bearer.

1. Crea una clave

En Ajustes → API / MCP, ponle un nombre a la clave (como «Claude Code») y créala. Cópiala: solo se muestra una vez. Guárdala en una variable de entorno, por ejemplo en el perfil de tu terminal:

export SEEREPO_KEY="sr_…"

2. Añade SeeRepo a tu cliente

Para Claude Code:

claude mcp add --transport http seerepo https://seerepo.com/api/mcp \
  --header "Authorization: Bearer $SEEREPO_KEY"

Con claude mcp list, SeeRepo aparece como conectado.

Para Codex, en ~/.codex/config.toml (Codex y MCP):

[mcp_servers.seerepo]
url = "https://seerepo.com/api/mcp"
bearer_token_env_var = "SEEREPO_KEY"

Para Cursor, en ~/.cursor/mcp.json, o en .cursor/mcp.json dentro de un proyecto (Cursor y MCP):

{
  "mcpServers": {
    "seerepo": {
      "url": "https://seerepo.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:SEEREPO_KEY}" }
    }
  }
}

3. Pruébalo

Abre una conversación y pregunta:

¿Cómo funciona el checkout en mi proyecto y qué cambiaron mis agentes desde ayer?

El agente lista tus mapas, abre el primer nivel y sigue las rutas hasta el módulo que necesita.

4. Dile a tu agente que lo use

Un agente va a lo que ya conoce: sin decírselo, la mayoría empieza buscando en los archivos. Añade esta línea al CLAUDE.md o al AGENTS.md de tu proyecto:

SeeRepo (the MCP server named seerepo) has this repo mapped. Ask it first, before searching or opening files, and then read only what you need to confirm what it says.

Herramientas

Herramienta	Qué hace	Recibe
`list_projects`	Tus mapas y los que te compartieron, en el orden de tu panel, cada uno con su rama y el id del mapa de su segunda rama	—
`explain`	Un módulo: qué hace, sus partes con su frase de una línea y la ruta para entrar, y los módulos con los que se conecta. En `/`, además cómo corre el producto: quién entra, sus procesos, dónde viven y qué usa de verdad cada uno; y, cuando más del 30 % de sus archivos queda en cajas que el mapa no diseñó, que el mapa está a medias	`repo`, `path` (por defecto `/`)
`search`	Partes por nombre o frase en todos los módulos, y archivos por ruta	`repo`, `query`
`impact`	Qué se rompe si tocas un archivo: quién lo nombra, cuántos dependen de él, a qué páginas y procesos llega	`repo`, `path`, `name`, `to`
`what_changed`	Los commits desde una fecha, en palabras sencillas: cuándo, qué agente o persona y los módulos que tocó cada uno	`repo`, `since` (por defecto, las últimas 24 horas)
`figures`	Commits, la parte escrita con IA y por qué agentes, líneas y archivos, las últimas 24 horas, 7 y 30 días	`repo`
`pages`	Cada página de la app: su nombre, su ruta, quién entra y los estados que maneja o le faltan, por los módulos de primer nivel del mapa. Abre con lo que dice la app: cuántas pantallas y cuántas están listas. Donde SeeRepo no puede leer la puerta lo dice, en vez de «cualquiera»; una página que solo te lleva a otro sitio lo dice, con su línea; Python aún no tiene Páginas. La lista dice también qué archivos de página no cuentan como páginas y por qué, lo que está a medias, cuándo quién entra lo leyó la IA y cuánto de lo que dijo la IA se tiró por no tener una línea que lo pruebe. Pide una página por su ruta y te da todo lo suyo: qué hace, quién entra con su prueba, cada estado con la línea que lo prueba, lo que lee y su último cambio	`repo`, `page` (opcional)
`found`	Cómo ven los buscadores y la IA cada página pública, y arriba, como el aro de Visibilidad, cuántas se pueden encontrar de las que quieren salir en Google: cada señal con su etiqueta honesta y su prueba, y, una vez al día, lo que contestó el sitio publicado donde no coincide con el código; con Search Console conectado, los clics, impresiones y posición de cada página, y si Google la indexó	`repo`
`health`	Lo que vale la pena arreglar: la nota de 100 con cuánto se movió en la semana y lo que le quita cada dimensión, si se puede publicar y qué lo impide, y las tareas abiertas, cada una con los puntos que gana arreglarla (o, si su dimensión pasó su techo, por qué todavía no gana), la primera con su prompt para tu agente. Pide el prompt de otra con su número	`repo`, `task` (opcional) En un repo gratis, cuántas hay y el título de la primera.
`history`	La trayectoria del proyecto (la carpeta Trayectoria): lo que pasó en los últimos 7 días (commits, quién los escribió, dónde, cuántas veces llegó a producción y si el último push llegó, y la semana dicha en palabras), cómo se trabaja contra su costumbre y sus momentos, del más grande al más chico.
`docs`	La wiki del repo: sin página, su árbol; con la clave de una página, su versión guardada, fecha del documento, idioma y autoría, markdown completo, índice de secciones, diagrama Mermaid y fuentes enlazadas	`repo`, `page`
`prepare_ignore` · `apply_ignore`	Deja rutas fuera del mapa (código generado, experimentos, archivos de terceros), como hace Ajustes → Ignorar	`repo`, `paths` · `id`
`prepare_mark_false` · `apply_mark_false`	Dice que una tarea de Salud está mal, entera o solo algunos de sus archivos, y por qué	`repo`, `task`, `files` (opcional), `why` · `id`
`prepare_set_aside` · `apply_set_aside`	Pospone una tarea de 1 a 90 días, o la acepta como está y dice por qué	`repo`, `task`, `how` (`snooze` o `accept`), `days` o `why` · `id`
`prepare_claim` · `apply_claim`	Dice qué agente hizo commits que no firmó, cada uno por su hash entero, como lo guardó la sesión del agente: cuentan como suyos en Trayectoria y en la parte escrita con IA	`repo`, `agent`, `shas` · `id`

repo es el id del repo, o owner/name como en GitHub. task es el número de una tarea en la lista de health, o su clave. Las diez primeras herramientas solo leen; las ocho últimas son los cambios de abajo.

Cómo es una respuesta

Texto corto que lee un agente, con la ruta para bajar un nivel. Nunca tu código. Las respuestas van en inglés, como todo lo que genera SeeRepo:

Checkout (/checkout) in ana/tienda
Takes the payment.
Inside: ana/tienda › Checkout

Parts (2):
- Pricing page [screen]: Where the plans are picked. (app/pricing/page.tsx)
- Stripe webhook [action]: Turns the plan on once Stripe confirms. (app/api/stripe/route.ts)
Comes from:
- Engine (uses, 2) → /engine

Next: search by name, or what_changed to see what moved.

Cambios, con tu sí

Cuatro cambios y ninguno más: ignorar rutas, marcar un hallazgo como falso, apartar una tarea y reclamar commits para el agente que los hizo sin firmarlos. Todo lo demás (pagos, claves, compartir, borrar un repo) se queda en la web.

Una clave lee, salvo que la dejes escribir. Enciende la escritura al crear la clave, o después, en Ajustes → API / MCP. Si la apagas, lo que dejó a medias ya no se aplica.
Dos pasos. prepare_… no cambia nada: dice lo que va a pasar y da un id. Tu cliente te pregunta, y apply_… con ese id, dentro de 5 minutos, lo hace. El mismo id aplicado dos veces lo hace una sola vez.
Nunca la seguridad. No se ignora una ruta que tape un secreto, un .env con valores o un hallazgo de seguridad abierto, y los hallazgos de seguridad no se marcan como falsos ni se apartan. Un agente que escribe puede estar siguiendo algo escrito en el código que leyó.
Una firma manda. Un commit que ya trae la firma de un agente se queda con ella aunque lo reclames.
Con límites. Nunca más de la mitad de los archivos de tu producto fuera del mapa (eso se hace en Ajustes), hasta 100 rutas ignoradas y 20 cambios al día por proyecto.
Cada uno anotado, cada uno se deshace. Quién lo hizo, por dónde y cuándo, en Ajustes → API / MCP, donde lo deshaces. La API también lo deshace.
Lo marcado sigue a la vista. Salud lo enseña aparte con su marca, y no quita puntos. Tu página pública también lo enseña, sin el porqué ni quién.

Un hallazgo que marcas como falso nos dice dónde se equivocó el motor: miramos cada uno, y el arreglo llega a todos los proyectos.

Cómo se limita el acceso

Solo tus mapas. La clave lee lo que lee tu cuenta: tus repos y los que te compartieron. El repo de cualquier otra persona responde como no encontrado.
Lee, salvo que digas otra cosa. Una clave escribe solo si la dejas, y cada cambio espera tu sí.
Tu plan manda. Un repo gratis se lee como en la app: entero hasta 300 mil líneas escritas, sin lo que hacen sus partes salvo su muestra; por encima, solo su primer nivel, con un 402 al entrar.
60 peticiones por minuto por clave.
Revoca una clave en Ajustes → API / MCP y deja de funcionar al momento.

La misma clave sirve para la API y la CLI.