Ir al contenido principal
RepoMap Docs

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 repomap

Configuració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

  1. Ve a repomap.app/dashboard
  2. Navega a Settings → API Tokens
  3. Crea un nuevo token con el nombre "MCP"
  4. 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.md

list_snapshots

Lista las snapshots disponibles para el proyecto.

Claude: ¿Qué snapshots tengo?
→ Llama a list_snapshots()
→ Devuelve lista de snapshots con fechas

get_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 momento

Uso 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.ts

Solución de problemas

El servidor no inicia

Verifica que repomap está en tu PATH:

which repomap
repomap --version

Error de autenticación

Verifica que tu token es válido:

REPOMAP_TOKEN=tu-token repomap mcp --test

Claude no encuentra las herramientas

Reinicia Claude Code después de modificar settings.json.