MCP Server
RepoMap incluye un servidor MCP (Model Context Protocol) que permite a Claude Code acceder a tu mapa de repositorio directamente desde la sesión de chat.
¿Qué es MCP?
MCP es el protocolo de Anthropic para que los modelos de lenguaje interactúen con herramientas y fuentes de datos externas. Con el MCP server de RepoMap, Claude puede:
- Leer el mapa de tu repositorio en tiempo real
- Consultar el estado de sincronización
- Acceder a snapshots históricas
Instalación
El servidor MCP se instala junto con el CLI:
npm install -g repomapConfiguración en Claude Code
Agrega la siguiente configuración a tu settings.json de Claude Code:
{
"mcpServers": {
"repomap": {
"command": "repomap",
"args": ["mcp"],
"env": {
"REPOMAP_TOKEN": "tu-token-aqui"
}
}
}
}Obtener tu token
- Ve a repomap.app/dashboard
- Navega a Settings → API Tokens
- Crea un nuevo token con el nombre "MCP"
- Copia el token y pégalo en la configuración
Herramientas disponibles
Una vez configurado, Claude Code tendrá acceso a estas herramientas:
get_repo_context
Obtiene el contexto completo del repositorio actual.
Claude: Muéstrame el contexto del repositorio
→ Llama a get_repo_context()
→ Devuelve el contenido del CLAUDE.mdlist_snapshots
Lista las snapshots disponibles para el proyecto.
Claude: ¿Qué snapshots tengo?
→ Llama a list_snapshots()
→ Devuelve lista de snapshots con fechasget_snapshot
Obtiene el contenido de una snapshot específica.
Claude: Muéstrame el snapshot pre-refactor
→ Llama a get_snapshot("pre-refactor")
→ Devuelve el CLAUDE.md en ese momentoUso en Claude Code
Una vez configurado, puedes referenciar el contexto en tus conversaciones:
tú: Analiza el código teniendo en cuenta el contexto del repo
Claude: [usa get_repo_context() automáticamente]O explícitamente:
tú: Usa repomap para obtener el contexto y luego revisa auth.tsSolución de problemas
El servidor no inicia
Verifica que repomap está en tu PATH:
which repomap
repomap --versionError de autenticación
Verifica que tu token es válido:
REPOMAP_TOKEN=tu-token repomap mcp --testClaude no encuentra las herramientas
Reinicia Claude Code después de modificar settings.json.