# Conectar HiPanda Memento con su IA (MCP)

Memento de HiPanda guarda sus documentos, notas y enlaces, organizados por proyecto. No tiene chat: su propia IA (Claude, ChatGPT, Codex, OpenCode) le pregunta a Memento por MCP, recibe los fragmentos más relevantes y escribe la respuesta citando el documento original.

## Datos del servidor

- Dirección del servidor MCP: `https://memento.hipanda.io/mcp`
- Nombre recomendado del servidor: `hipanda-memento`
- Transporte: HTTP (Streamable HTTP), remoto.
- Autenticación: OAuth 2.1 con inicio de sesión de HiPanda (Google o correo y contraseña). No se usan claves ni tokens manuales.

## Antes de empezar

- Una cuenta de HiPanda con el rol **Memento**. Si no lo tiene, pídaselo a un administrador.
- Un asistente que admita servidores MCP remotos con inicio de sesión: Claude Code, Claude (web y escritorio), ChatGPT, Codex u OpenCode.

## Instalación

### Claude Code

1. En la terminal:

   ```bash
   claude mcp add -s user --transport http hipanda-memento https://memento.hipanda.io/mcp
   ```

   `-s user` deja el servidor disponible en todas las carpetas. Sin esa opción solo queda en la carpeta donde se agregó.
2. Abra Claude Code, escriba `/mcp`, elija `hipanda-memento` y pulse **Authenticate**.
3. Inicie sesión en la página "Conectar con HiPanda Memento" que se abre en el navegador.
4. Pruebe: "¿Qué proyectos tengo en mi Memento?".

### Claude (web y escritorio)

1. Vaya a Personalizar → Conectores.
2. Pulse "+ Agregar" → "Agregar conector personalizado".
3. Nombre: `HiPanda Memento`. URL: `https://memento.hipanda.io/mcp`. Pulse "Continuar" y luego "Agregar".
4. Inicie sesión con su cuenta de HiPanda cuando Claude se lo pida.
5. En cada conversación, actívelo desde el botón "+" → Conectores.

El plan gratuito de Claude permite un solo conector personalizado. En planes Team y Enterprise, un propietario debe agregarlo primero en la configuración de la organización.

### ChatGPT

1. En ChatGPT web, abra Configuración → Apps (en algunas cuentas aparece como Conectores o Plugins) → Configuración avanzada y active el modo desarrollador si se lo pide.
2. Cree una app MCP: nombre `HiPanda Memento`, URL `https://memento.hipanda.io/mcp`, autenticación OAuth.
3. Inicie sesión con su cuenta de HiPanda y active la app en la conversación.

Para guardar documentos y notas desde ChatGPT se necesita ChatGPT Business, Enterprise o Edu; en otros planes solo se puede consultar. En espacios de trabajo, un administrador debe crear y publicar la app. Solo funciona en la versión web. Los nombres de los menús de ChatGPT cambian con frecuencia.

### Codex

1. En la terminal:

   ```bash
   codex mcp add hipanda-memento --url https://memento.hipanda.io/mcp
   ```

2. Si no se abre el navegador para iniciar sesión:

   ```bash
   codex mcp login hipanda-memento
   ```

3. Alternativa: agregue esto a `~/.codex/config.toml` y luego ejecute `codex mcp login hipanda-memento`:

   ```toml
   [mcp_servers.hipanda-memento]
   url = "https://memento.hipanda.io/mcp"
   ```

4. Revise la conexión con `codex mcp list`.

### OpenCode

1. Agregue esto a `opencode.json` (global en `~/.config/opencode/opencode.json` o en su proyecto):

   ```json
   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "hipanda-memento": {
         "type": "remote",
         "url": "https://memento.hipanda.io/mcp"
       }
     }
   }
   ```

2. Inicie sesión: `opencode mcp auth hipanda-memento`.
3. Revise la conexión con `opencode mcp list`.

## Primer inicio de sesión

Al conectar, se abre la página "Conectar con HiPanda Memento". Inicie sesión con Google o con correo y contraseña. Si su cuenta no tiene el rol Memento, verá el mensaje "Tu cuenta no tiene acceso a Memento de HiPanda" y no se concede el acceso. Si le quitan el rol, el acceso se corta en máximo una hora.

## Qué puede hacer

| Herramienta | Para qué sirve |
|---|---|
| `list_projects` | Ver sus proyectos. |
| `create_project` | Crear un proyecto, solo cuando usted lo pide. |
| `set_project` | Fijar el proyecto activo de la conversación. |
| `add_note` | Guardar una nota en markdown. Su IA puede leer una imagen o un archivo que usted le comparta y guardarlo ya estructurado. |
| `add_document` | Subir un archivo (PDF, Word, Excel, PowerPoint, imagen, texto) cuando su IA tiene el archivo. |
| `add_url` | Guardar un enlace. |
| `search` | Buscar en el contenido. Cada resultado trae el fragmento, la página y el enlace al documento original para citarlo. |
| `agenda` | Ver las fechas mencionadas en lo guardado dentro de un rango, en orden cronológico. |
| `list_documents` | Listar lo guardado por fecha de subida o por fecha del documento ("¿qué subí esta semana?"). |
| `get_document` | Ver el resumen, los fragmentos y el enlace al original de un documento. |
| `related` | Ver documentos relacionados por tags o enlaces. |
| `browse` | Ver los tags y los documentos recientes de un proyecto. |
| `forget` | Borrar un documento y todo lo que salió de él, solo cuando usted lo pide. |

Memento es una memoria, no un gestor de tareas: guarda lo que usted le da para responder y recordar. Las fechas que aparecen en lo guardado se registran como fechas mencionadas, sin estado de pendiente o hecho.

Todo lo creado por MCP aparece en la aplicación web de HiPanda (Memento), y lo creado en la web aparece por MCP.

## Enlaces a los documentos originales

Los enlaces que entrega Memento llevan a `https://app.hipanda.io/memento/documents/<id>/original`. Son permanentes y privados: piden iniciar sesión en HiPanda y, al entrar, abren el documento en la página citada.

## Problemas frecuentes

- **No se abre el inicio de sesión.** Claude Code: escriba `/mcp` y elija `hipanda-memento`. Codex: `codex mcp login hipanda-memento`. OpenCode: `opencode mcp auth hipanda-memento`. Claude y ChatGPT: desconecte y vuelva a conectar la app.
- **"Tu cuenta no tiene acceso a Memento de HiPanda".** Pida a un administrador el rol Memento y vuelva a conectar.
- **Las herramientas nuevas no aparecen.** Reconecte el servidor (en Claude Code: `/mcp` → Reconnect).
- **Quiero desconectarlo.** Claude Code: `claude mcp remove hipanda-memento`. Codex: `codex mcp remove hipanda-memento`. OpenCode: `opencode mcp logout hipanda-memento`. Claude: Personalizar → Conectores → quitar. ChatGPT: elimine la app en Configuración.