{"title":"Quick Start (humano)","slug":"quick-start","category":"getting-started","summary":"Registre una cuenta, cree su primer mind, almacene una memoria — todo en 5 minutos.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":405,"read_minutes":2,"lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# Quick Start (humano)\n\nEsta guía le lleva por obtener una cuenta de Synapse, su primer Mind Key, y\nalmacenar su primera memoria. Tiempo total: ~5 minutos.\n\n## Paso 1: Registrar una cuenta\n\nAbra la API de Synapse y cree una cuenta:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nRespuesta:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> Guarde el JWT en un lugar seguro — lo necesitará para crear minds. El JWT\n> expira a los 7 días; vuelva a iniciar sesión con el mismo endpoint para\n> refrescarlo.\n\n## Paso 2: Cree su primer mind\n\nUn \"mind\" es un ámbito de memoria aislado. La mayoría de los usuarios empieza\ncon un mind, pero puede tener múltiples (p. ej. \"trabajo\", \"personal\",\n\"proyecto-x\"). Cada mind tiene su propio Mind Key único.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nRespuesta:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **Guarde el `mind_key` de inmediato.** Solo se muestra una vez y no se puede\n> recuperar después. Si lo pierde, tendrá que crear un mind nuevo.\n\n## Paso 3: Almacene su primera memoria\n\nAhora use el Mind Key para almacenar una memoria:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nRespuesta:\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## Paso 4: Recupere todas las memorias\n\nPara recuperar todo lo que ha almacenado:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nRespuesta (texto plano, optimizado para consumo por LLM):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## Paso 5: Busque memorias\n\nEncuentre memorias específicas por palabra clave:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## Paso 6: Conecte su LLM\n\nLa forma más sencilla de dar a su LLM acceso a Synapse es vía MCP:\n\n- [Configuración de Claude Desktop](/docs/mcp/claude-desktop) — config en 2 minutos\n- [Configuración de Claude Code](/docs/mcp/claude-code) — integración con terminal\n- [Configuración de Cursor](/docs/mcp/cursor) — integración con IDE\n\nTras la configuración, su LLM llamará automáticamente a `memory_recall` al\ninicio de cada sesión y persistirá nuevos hechos vía `memory_store`.\n\n## Categorías de memoria\n\nSynapse admite 8 categorías — elija la más específica:\n\n| Categoría | Caso de uso |\n|----------|----------|\n| `identity` | Nombre, rol, información de contacto |\n| `preference` | Gustos, disgustos, estilo de trabajo |\n| `fact` | Hechos verificables (detalles del proyecto, fechas) |\n| `project` | Estado del proyecto, hitos, tareas pendientes |\n| `skill` | Cosas en las que el usuario es bueno |\n| `mistake` | Errores pasados — evitar repetirlos |\n| `context` | Contexto relevante para la sesión |\n| `note` | Notas varias |\n\n## Niveles de prioridad\n\n- `low` — bueno saberlo\n- `normal` — predeterminado\n- `high` — importante\n- `critical` — nunca olvidar (identidad del usuario, información legal)\n\n## Próximos pasos\n\n- [Profundización en autenticación](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Referencia de la API de Memory](/docs/api/memory)\n- [Integración MCP](/docs/mcp/what-is-mcp)\n","content_html":"

Quick Start (humano)

\n

Esta guía le lleva por obtener una cuenta de Synapse, su primer Mind Key, y\nalmacenar su primera memoria. Tiempo total: ~5 minutos.

\n

Paso 1: Registrar una cuenta

\n

Abra la API de Synapse y cree una cuenta:

\n
curl -X POST https://synapse.schaefer.zone/register \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "email": "you@example.com",\n    "password": "your-secure-password"\n  }'

Respuesta:

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
Guarde el JWT en un lugar seguro — lo necesitará para crear minds. El JWT\nexpira a los 7 días; vuelva a iniciar sesión con el mismo endpoint para\nrefrescarlo.

Paso 2: Cree su primer mind

\n

Un "mind" es un ámbito de memoria aislado. La mayoría de los usuarios empieza\ncon un mind, pero puede tener múltiples (p. ej. "trabajo", "personal",\n"proyecto-x"). Cada mind tiene su propio Mind Key único.

\n
curl -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "My First Mind",\n    "description": "Personal assistant memory"\n  }'

Respuesta:

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**Guarde el `mind_key` de inmediato.** Solo se muestra una vez y no se puede\nrecuperar después. Si lo pierde, tendrá que crear un mind nuevo.

Paso 3: Almacene su primera memoria

\n

Ahora use el Mind Key para almacenar una memoria:

\n
curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "category": "identity",\n    "key": "user_name",\n    "content": "My name is Michael",\n    "tags": ["personal", "identity"],\n    "priority": "critical"\n  }'

Respuesta:

\n
{\n  "id": "mem_001",\n  "status": "stored",\n  "mind_id": "m_xyz789"\n}

Paso 4: Recupere todas las memorias

\n

Para recuperar todo lo que ha almacenado:

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Respuesta (texto plano, optimizado para consumo por LLM):

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

Paso 5: Busque memorias

\n

Encuentre memorias específicas por palabra clave:

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=michael"

Paso 6: Conecte su LLM

\n

La forma más sencilla de dar a su LLM acceso a Synapse es vía MCP:

\n\n

Tras la configuración, su LLM llamará automáticamente a memory_recall al\ninicio de cada sesión y persistirá nuevos hechos vía memory_store.

\n

Categorías de memoria

\n

Synapse admite 8 categorías — elija la más específica:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CategoríaCaso de uso
identityNombre, rol, información de contacto
preferenceGustos, disgustos, estilo de trabajo
factHechos verificables (detalles del proyecto, fechas)
projectEstado del proyecto, hitos, tareas pendientes
skillCosas en las que el usuario es bueno
mistakeErrores pasados — evitar repetirlos
contextContexto relevante para la sesión
noteNotas varias
\n

Niveles de prioridad

\n\n

Próximos pasos

\n\n","urls":{"html":"/docs/getting-started/quick-start","text":"/docs/getting-started/quick-start?format=text","json":"/docs/getting-started/quick-start?format=json","llm":"/docs/getting-started/quick-start?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}