GERANIUM · MCP Y API

Tu archivo, también
desde una conversación.

Consulta una historia, añade un documento o conecta personas y recuerdos con un agente al que hayas dado acceso.

01 / TU ARCHIVO

Primero, entra en tu familia.

Tu familia ya usa Geranium

Pide a alguien de la familia que te invite desde Configuración (como editor, si quieres que tu agente añada cosas). Abre el enlace del correo y crea tu cuenta desde ahí: entrarás directamente en su archivo.

Empiezas uno nuevo

Crea tu cuenta; justo después le pondrás nombre al archivo de tu familia. Luego podrás invitar a quien quieras.

Crear mi archivo

02 / CONECTAR

Dale acceso a tu agente.

Añade Geranium como conector con esta dirección. En Claude (web o escritorio): Ajustes → Conectores → Añadir conector personalizado.
Se abrirá Geranium: entra con tu cuenta, elige tu familia y pulsa Autorizar conexión.
Vuelve a tu agente y pídele «Comprueba mi archivo». Si no encuentra Geranium, reinícialo.
El acceso dura 30 días y puedes quitarlo cuando quieras en Configuración → Agentes.

Dirección del conector: https://gerani.top/mcp

Por defecto el agente puede consultar y añadir. Eliminar es un permiso aparte. Nunca hace falta pegar tu contraseña en el chat.

Codex

codex mcp add geranium --url https://gerani.top/mcp

Codex abrirá Geranium para autorizar. Si después no ve las herramientas, reinicia Codex.

Claude Code

claude mcp add --transport http geranium https://gerani.top/mcp

Después, ejecuta /mcp y elige geranium para autorizar.

Clave manual para scripts · Codex · config.toml

[mcp_servers.geranium]
url = "https://gerani.top/mcp"
bearer_token_env_var = "GERANIUM_MCP_TOKEN"

Clave manual para scripts · Claude Code · .mcp.json

{
  "mcpServers": {
    "geranium": {
      "type": "http",
      "url": "https://gerani.top/mcp",
      "headers": {
        "Authorization": "Bearer ${GERANIUM_MCP_TOKEN}"
      }
    }
  }
}

03 / EMPEZAR

Comprueba la conexión.

Una vez conectado, puedes empezar con este mensaje:

Lee el resumen de Geranium. Dime a qué familia tienes acceso y qué puedes hacer. Consulta la guía si vamos a aportar o editar. Después te diré qué quiero consultar o añadir; busca coincidencias antes de crear y comprueba el resultado.

La guía llega desde Geranium: tu agente no necesita conocer este proyecto ni tener el historial de nuestras conversaciones. Puedes empezar por una persona, un relato, un documento, una grabación, un lugar o cualquier otro recuerdo.

Comprobar acceso desde una terminal

curl --fail-with-body 'https://gerani.top/api/summary' \
  -H "Authorization: Bearer $GERANIUM_MCP_TOKEN"

Qué está disponible.

Búsqueda, consulta, creación, edición, relaciones, originales, retratos, propuestas revisables y recuperación de cambios. El árbol, el mapa y la cronología consultan el mismo archivo.

Al aportar documentos, el agente añade su transcripción y contexto. La web extrae texto automáticamente de PDF e imágenes. Para subir archivos, el cliente debe poder acceder a sus bytes reales.