Configura MemoryGraph con la aplicacion Claude Desktop. Elige entre MemoryGraph Cloud (servicio gestionado, sin configuracion) o MemoryGraph Local (auto-alojado, control total).

Requisitos Previos

• Aplicacion Claude Desktop instalada

Opcion 1: MemoryGraph Cloud (Recomendado)

La forma mas facil de empezar. No requiere instalacion - solo configura tu clave API.

Paso 1: Obtener Tu Clave API

Registrate en memorygraph.dev/signup y copia tu clave API desde el panel de control.

Paso 2: Abrir Configuracion de Claude Desktop

Abre el archivo de configuracion de Claude Desktop:

Paso 3: Agregar Configuracion MCP

Agrega la siguiente configuracion JSON:

{
  "mcpServers": {
    "memorygraph": {
      "command": "npx",
      "args": ["-y", "@memorygraph/mcp-client"],
      "env": {
        "MEMORYGRAPH_API_KEY": "tu-clave-api-aqui"
      }
    }
  }
}

Paso 4: Reiniciar Claude Desktop

Cierra y vuelve a abrir Claude Desktop para que los cambios surtan efecto.

Opcion 2: MemoryGraph Local (Auto-alojado)

Ejecuta MemoryGraph completamente en tu maquina. Tus datos permanecen locales.

Requisitos Adicionales

• Python 3.10 o superior
• pipx instalado (pip install pipx)

Paso 1: Instalar MemoryGraph

pipx install memorygraphMCP

Paso 2: Encontrar la Ruta de memorygraph

# Obtener la ruta completa a memorygraph
which memorygraph

# Ejemplo de salida:
# /Users/tunombre/.local/bin/memorygraph

Paso 3: Abrir Configuracion de Claude Desktop

Abre el archivo de configuracion de Claude Desktop (ver rutas en la tabla anterior).

Paso 4: Agregar Configuracion MCP

Agrega la siguiente configuracion JSON (reemplaza la ruta con tu ruta real):

{
  "mcpServers": {
    "memorygraph": {
      "command": "/Users/tunombre/.local/bin/memorygraph",
      "args": []
    }
  }
}

Paso 5: Reiniciar Claude Desktop

Cierra y vuelve a abrir Claude Desktop para que los cambios surtan efecto.

Verificar Conexion

En Claude Desktop, deberias ver un icono de herramientas indicando que los servidores MCP estan conectados. Pide a Claude que liste las herramientas disponibles - deberias ver herramientas de memorygraph como store_memory, recall_memories, y search_memories.

Importante: Agregar Directivas de Memoria

MemoryGraph no almacenara memorias automaticamente. Necesitas indicarle a Claude cuando y que recordar agregando instrucciones a tu conversacion o configuracion del proyecto.

Agregar a las Instrucciones de Tu Proyecto

En Claude Desktop, ve a la configuracion de tu proyecto y agrega directivas de memoria. Aqui hay un ejemplo minimo:

## Protocolo de Memoria

### Antes de Comenzar a Trabajar
Usa `recall_memories` para verificar contexto pasado relevante.

### Cuando Almacenar Memorias
Almacena memorias cuando:
- Corrijas un bug → guarda el problema + solucion
- Tomes decisiones de arquitectura → guarda la justificacion
- Descubras patrones reutilizables → guarda con ejemplos

Siempre incluye etiquetas, importancia (0-1), y relaciones.

→ Guia Completa del Protocolo de Memoria con directivas y ejemplos completos.

Configuracion Avanzada (Solo Local)

Con Variables de Entorno

{
  "mcpServers": {
    "memorygraph": {
      "command": "/Users/tunombre/.local/bin/memorygraph",
      "args": [],
      "env": {
        "MEMORYGRAPH_DATA_DIR": "/ruta/a/datos/personalizado",
        "MEMORYGRAPH_LOG_LEVEL": "DEBUG"
      }
    }
  }
}

Solucion de Problemas

El Servidor MCP No Aparece

• Verifica que la ruta del comando sea correcta y absoluta (para configuracion local)
• Comprueba que memorygraph funciona manualmente: /ruta/a/memorygraph --health
• Verifica que tu clave API sea correcta (para configuracion cloud)
• Reinicia Claude Desktop completamente (cierra desde la barra de menu)

Consulta la Guia de Solucion de Problemas completa para mas soluciones.