SYNAPSE KAYSER
v6.5.1 · Database Explorer
HTTP MCP Server Load Test API Flows AI Agent
Press any key · Presiona cualquier tecla
← Back to homepage v6.5.1 · Official Docs

Synapse Kayser
Manual & Reference

Everything you need to get the most out of Synapse Kayser — from connecting AI agents via MCP to running industrial load tests.

New in v5.0.0

🤖 MCP — AI Agent Integration

Synapse Kayser exposes an MCP (Model Context Protocol) HTTP+SSE server on port 47821. Any MCP-compatible AI agent — Claude, Cursor, Windsurf, or a custom agent — can discover and execute your saved HTTP requests, including all pre-configured headers, auth tokens, and pre-request scripts.

✅
The server starts automatically when Synapse Kayser launches. No configuration needed. Just open your collection and connect your agent.

Step 1 — Add the MCP server to Claude

You have two options:

Option A — Edit claude_desktop_config.json 
{
  "mcpServers": {
    "synapse": {
      "type": "sse",
      "url": "http://127.0.0.1:47821/sse"
    }
  }
}
Option B — Claude CLI (one command) 
claude mcp add --transport sse synapse http://127.0.0.1:47821/sse

Step 2 — Open a collection in Synapse

Go to File → Open Collection and select your .bru folder. The MCP server automatically indexes all requests — the agent can see them as soon as the collection is open.

Step 3 — Talk to your agent

Example prompts you can use right away:

"List all available requests in synapse"⧉
"Using synapse, execute the POST 'Login' request and tell me the token it returns"⧉
"With synapse, find the GET that contains /api/users in the URL and pass page=2 as a query param"⧉
"Execute the 'GetDocuments' request in synapse with id=42 as a path param"⧉
"Run the POST /api/orders with body product=book qty=3 using synapse"⧉

Available MCP Tools

list_requests
Returns all HTTP requests across every open collection, including name, method, URL, and path. The agent uses this to discover what requests are available before executing one.
execute_request
Executes a specific request by name or URL fragment. Supports overriding: query_params, path_params, headers, and body. Runs the full pre-request script and applies all configured auth and environment variables.

How the agent finds and runs requests

The execute_request tool accepts these filter parameters:

name_or_pathPartial name or file path substring (e.g. "Login", "users/list")
methodOptional filter: GET, POST, PUT, DELETE, PATCH…
url_containsOptional URL fragment filter (e.g. "/api/orders")
query_paramsObject of query params to add/override (e.g. page: "2")
path_paramsObject of path params — replaces :id or {{id}} in the URL
headersObject of headers to add/override
bodyString — replaces the request body entirely
🔒
Auth and scripts are always applied. The agent never bypasses your pre-request scripts, Bearer tokens, or environment variables. It executes exactly as if you clicked Send yourself.
New in v5.0.0

☁️ Nextcloud Sync — Multi-Profile Workspace

Connect Synapse Kayser to your own Nextcloud server and keep your entire workspace in sync across machines — collections, environment variables, and per-profile settings. No third-party cloud involved: your data lives exclusively on your Nextcloud instance.

🔒
100% self-hosted. Synapse Kayser never sends your data to any external service. Everything goes through your own Nextcloud — you control the encryption and access.

Step 1 — Connect your Nextcloud server

Open Settings → Cloud Sync inside Synapse Kayser. Enter your Nextcloud URL (e.g. https://cloud.myserver.com), your username, and an app password (generate one in Nextcloud → Settings → Security → App passwords).

💡
Use an app password, not your main Nextcloud password. It can be revoked at any time without changing your login credentials.

Step 2 — Create profiles

In Settings → Profiles, click New Profile and give it a name — for example: Work, Personal, or Client Acme. Each profile is an isolated workspace with its own:

Collections
Separate .bru folders per profile — no mixing of client APIs.
Environment variables
Each profile carries its own baseUrl, tokens, secrets, and env files.
Settings
Theme, language, active database connections — all per-profile.
Cloud path
Each profile syncs to its own folder inside your Nextcloud (e.g. /Synapse/Work/).

Step 3 — Switch profiles

Click the profile selector in the top bar. Switching takes under a second — Synapse loads the profile's collections and variables instantly from the local cache, then verifies sync state with Nextcloud in the background.

Step 4 — Sync across machines

Open Synapse Kayser on a second machine, connect to the same Nextcloud server, and select the same profile. All collections, env vars, and settings are pulled automatically. Changes made on machine A appear on machine B after the next sync cycle.

✅
Conflict resolution: if the same file is modified on two machines before a sync, Synapse keeps both versions and asks you which one to use — no silent overwrites.
New in v5.0.0

⬜ Split Panel

Work on two requests at the same time with a VS Code-style split panel.

1
Drag a tab to the right edge of the window — a drop zone appears. Release the tab there to split the workspace.
2
Use the ≫ button in the left panel header to move all tabs to the right panel, or ≪ to move them back.
3
When a panel has no more tabs, it collapses automatically back to single-panel mode.

🌐 HTTP Requests

Synapse Kayser supports the full HTTP request lifecycle. Each request lives in a .bru file inside your collection folder.

Auth types
Bearer token, Basic auth, OAuth 2.0, API Key (header or query param), Digest.
Body types
JSON, Form-urlencoded, Multipart, Raw text, XML, GraphQL.
Pre-request scripts
JavaScript executed before each request — set dynamic headers, compute signatures, extract tokens from previous responses.
Assertions
Post-response checks on status, body, headers, or response time. Pass/fail shown inline.
Environment variables
Use {{baseUrl}} syntax anywhere. Switch between dev, staging, prod with one click.
Collection scripts
A global pre-request script that runs before every request in the collection. Perfect for shared auth logic.
⏹ Cancel Request
While a request is in flight, a Cancel button appears in the URL bar. Click it to abort immediately.

🔗 Chained API Flows

Connect multiple HTTP requests into a visual flow. The output of one step automatically feeds the next — no copy/paste, no manual token transfer.

1
Open a collection → click New Flow in the sidebar.
2
Add steps by dragging requests from the collection sidebar into the flow canvas.
3
Use $response.body.token syntax in subsequent steps to reference previous responses.
4
Click Run Flow — Kayser executes every step in order and shows a timeline.

⚡ Load Testing

Industrial-grade load testing with RAM Guard to prevent system crashes.

Worker pools
Configure exactly how many concurrent workers hit your endpoint. Scale from 1 to thousands.
RAM Guard
Monitors system memory in real time. Auto-stops the test if usage reaches a critical threshold.
Live metrics
Track p50/p95/p99 latencies, req/s throughput, and error rates on a live dashboard while the test runs.
PDF reports
Export a professional report with AI-powered audit, bottleneck detection, and persistent notes.

🗄 Database Manager

Connect to PostgreSQL, MySQL, SQL Server, MongoDB, and Redis — all in one panel. Query, edit, and export without leaving Synapse Kayser.

Multi-engine
PostgreSQL · MySQL · SQL Server · MongoDB · Redis — switch between them with a tab click.
Inline editing
Double-click any cell to edit it in place. Insert, delete, and duplicate rows — DBeaver-style.
SQL autocomplete
Live schema-aware completion: keywords, table names, and column names from your connected database.
Multiple connections
Keep several databases open at once — each in its own tab with independent query history.

📁 Bruno Collections

Synapse Kayser reads and writes .bru and bruno.yml files natively. Your collections stay on disk, in your Git repo, exactly where they belong.

💡
100% Bruno-compatible. Open any folder that works in Bruno and it will work in Synapse Kayser — auth, headers, scripts, and env vars mapped with full fidelity.
1
File → Open Collection — select the folder that contains your .bru files.
2
Edit requests visually. All changes are saved back to the .bru file immediately.
3
Use Import Postman to convert a Postman JSON v2.1 export to Bruno format automatically.
← Volver al inicio v6.5.1 · Documentación oficial

Synapse Kayser
Manual y Referencia

Todo lo que necesitas para sacarle el máximo a Synapse Kayser — desde conectar agentes IA con MCP hasta ejecutar pruebas de carga industriales.

Nuevo en v5.0.0

🤖 MCP — Integración con Agentes IA

Synapse Kayser expone un servidor MCP (Model Context Protocol) HTTP+SSE en el puerto 47821. Cualquier agente IA compatible con MCP — Claude, Cursor, Windsurf o un agente propio — puede descubrir y ejecutar tus peticiones HTTP guardadas, incluyendo todos los headers, tokens de auth y scripts de pre-petición.

✅
El servidor arranca automáticamente al iniciar Synapse Kayser. Sin configuración. Solo abre tu colección y conecta tu agente.

Paso 1 — Agrega el servidor MCP a Claude

Tienes dos opciones:

Opción A — Edita claude_desktop_config.json 
{
  "mcpServers": {
    "synapse": {
      "type": "sse",
      "url": "http://127.0.0.1:47821/sse"
    }
  }
}
Opción B — Claude CLI (un solo comando) 
claude mcp add --transport sse synapse http://127.0.0.1:47821/sse

Paso 2 — Abre una colección en Synapse

Ve a Archivo → Abrir Colección y selecciona tu carpeta .bru. El servidor MCP indexa todos los requests automáticamente — el agente los ve en cuanto la colección está abierta.

Paso 3 — Habla con tu agente

Ejemplos de prompts que puedes usar de inmediato:

"Lista todos los requests disponibles en synapse"⧉
"Con synapse, ejecuta el request POST 'Login' y dime el token que retorna"⧉
"Con synapse, encuentra el GET que tiene /api/users en la URL y pásale page=2 como query param"⧉
"Ejecuta el request 'GetDocuments' en synapse con id=42 como path param"⧉
"Corre el POST /api/orders con body product=book qty=3 usando synapse"⧉

Herramientas MCP disponibles

list_requests
Retorna todos los requests HTTP de todas las colecciones abiertas, incluyendo nombre, método, URL y ruta. El agente usa esto para descubrir qué requests están disponibles antes de ejecutar uno.
execute_request
Ejecuta un request específico por nombre o fragmento de URL. Permite sobreescribir: query_params, path_params, headers y body. Ejecuta el script de pre-petición y aplica toda la auth y variables de entorno configuradas.

Cómo el agente encuentra y ejecuta requests

La herramienta execute_request acepta estos parámetros de filtro:

name_or_pathNombre parcial o fragmento de ruta (ej. "Login", "users/list")
methodFiltro opcional: GET, POST, PUT, DELETE, PATCH…
url_containsFragmento de URL para filtrar (ej. "/api/orders")
query_paramsObjeto de query params a agregar/sobreescribir (ej. page: "2")
path_paramsObjeto de path params — reemplaza :id o {{id}} en la URL
headersObjeto de headers a agregar/sobreescribir
bodyString — reemplaza el cuerpo del request por completo
🔒
Auth y scripts siempre se aplican. El agente nunca omite tus scripts de pre-petición, tokens Bearer ni variables de entorno. Ejecuta exactamente como si hicieras clic en Enviar tú mismo.
Nuevo en v5.0.0

☁️ Nextcloud Sync — Espacio Multi-Perfil

Conecta Synapse Kayser a tu propio servidor Nextcloud y mantén todo tu espacio de trabajo sincronizado entre máquinas — colecciones, variables de entorno y configuración por perfil. Sin nubes de terceros: tus datos viven exclusivamente en tu instancia de Nextcloud.

🔒
100% autoalojado. Synapse Kayser nunca envía tus datos a ningún servicio externo. Todo pasa por tu Nextcloud — tú controlas el cifrado y el acceso.

Paso 1 — Conecta tu servidor Nextcloud

Abre Configuración → Sincronización en la nube dentro de Synapse Kayser. Ingresa la URL de tu Nextcloud (ej. https://cloud.miserv.com), tu usuario y una contraseña de aplicación (créala en Nextcloud → Configuración → Seguridad → Contraseñas de app).

💡
Usa una contraseña de aplicación, no tu contraseña principal de Nextcloud. Se puede revocar en cualquier momento sin cambiar tus credenciales de acceso.

Paso 2 — Crea perfiles

En Configuración → Perfiles, haz clic en Nuevo Perfil y ponle un nombre — por ejemplo: Trabajo, Personal o Cliente Acme. Cada perfil es un espacio de trabajo aislado con su propio:

Colecciones
Carpetas .bru separadas por perfil — sin mezclar APIs de diferentes clientes.
Variables de entorno
Cada perfil tiene su propio baseUrl, tokens, secretos y archivos de entorno.
Configuración
Tema, idioma, conexiones de bases de datos activas — todo por perfil.
Ruta en la nube
Cada perfil sincroniza en su propia carpeta dentro de Nextcloud (ej. /Synapse/Trabajo/).

Paso 3 — Cambia de perfil

Haz clic en el selector de perfiles en la barra superior. El cambio tarda menos de un segundo — Synapse carga las colecciones y variables del perfil instantáneamente desde caché local, luego verifica el estado de sincronización con Nextcloud en segundo plano.

Paso 4 — Sincroniza entre máquinas

Abre Synapse Kayser en una segunda máquina, conéctate al mismo servidor Nextcloud y selecciona el mismo perfil. Todas las colecciones, variables y configuración se descargan automáticamente. Los cambios hechos en la máquina A aparecen en la máquina B después del siguiente ciclo de sincronización.

✅
Resolución de conflictos: si el mismo archivo fue modificado en dos máquinas antes de sincronizar, Synapse guarda ambas versiones y te pregunta cuál usar — sin sobreescrituras silenciosas.
Nuevo en v5.0.0

⬜ Panel Dividido

Trabaja en dos requests al mismo tiempo con un panel dividido estilo VS Code.

1
Arrastra una pestaña al borde derecho de la ventana — aparece una zona de soltar. Suéltala ahí para dividir el espacio de trabajo.
2
Usa el botón ≫ en el encabezado del panel izquierdo para mover todas las pestañas al panel derecho, o ≪ para devolverlas.
3
Cuando un panel queda sin pestañas, se colapsa automáticamente de vuelta al modo de panel único.

🌐 Peticiones HTTP

Synapse Kayser soporta el ciclo completo de peticiones HTTP. Cada request vive en un archivo .bru dentro de tu carpeta de colección.

Tipos de auth
Bearer token, Basic auth, OAuth 2.0, API Key (header o query param), Digest.
Tipos de body
JSON, Form-urlencoded, Multipart, Texto raw, XML, GraphQL.
Scripts de pre-petición
JavaScript ejecutado antes de cada request — establece headers dinámicos, calcula firmas, extrae tokens de respuestas anteriores.
Aserciones
Verificaciones post-respuesta sobre status, body, headers o tiempo de respuesta. Resultado pass/fail mostrado en línea.
Variables de entorno
Usa la sintaxis {{baseUrl}} en cualquier parte. Cambia entre dev, staging y prod con un clic.
Scripts de colección
Un script global de pre-petición que corre antes de cada request de la colección. Perfecto para lógica de auth compartida.
⏹ Cancelar Request
Mientras un request está en vuelo, aparece un botón Cancelar en la barra de URL. Haz clic para abortar inmediatamente.

🔗 API Flows Encadenados

Conecta múltiples peticiones HTTP en un flujo visual. La salida de un paso alimenta automáticamente el siguiente — sin copiar y pegar, sin transferir tokens manualmente.

1
Abre una colección → haz clic en Nuevo Flow en el panel lateral.
2
Agrega pasos arrastrando requests desde el panel lateral al canvas del flow.
3
Usa la sintaxis $response.body.token en pasos siguientes para referenciar respuestas anteriores.
4
Haz clic en Ejecutar Flow — Kayser ejecuta cada paso en orden y muestra una línea de tiempo.

⚡ Pruebas de Carga

Pruebas de carga de nivel industrial con RAM Guard para prevenir bloqueos del sistema.

Pools de workers
Configura exactamente cuántos workers concurrentes golpean tu endpoint. Escala de 1 a miles.
RAM Guard
Monitorea la memoria del sistema en tiempo real. Detiene el test automáticamente si el uso llega a un umbral crítico.
Métricas en vivo
Sigue latencias p50/p95/p99, throughput req/s y tasas de error en un dashboard en tiempo real mientras corre el test.
Reportes PDF
Exporta un reporte profesional con auditoría por IA, detección de cuellos de botella y notas persistentes.

🗄 Gestor de Bases de Datos

Conéctate a PostgreSQL, MySQL, SQL Server, MongoDB y Redis — todo en un panel. Consulta, edita y exporta sin salir de Synapse Kayser.

Multi-motor
PostgreSQL · MySQL · SQL Server · MongoDB · Redis — cambia entre ellos con un clic en la pestaña.
Edición inline
Doble clic en cualquier celda para editarla en su lugar. Inserta, elimina y duplica filas — estilo DBeaver.
Autocompletado SQL
Completado en vivo con conciencia de esquema: palabras clave, nombres de tablas y columnas de tu base de datos conectada.
Múltiples conexiones
Mantén varias bases de datos abiertas a la vez — cada una en su propia pestaña con historial de consultas independiente.

📁 Colecciones Bruno

Synapse Kayser lee y escribe archivos .bru y bruno.yml de forma nativa. Tus colecciones permanecen en disco, en tu repositorio Git, exactamente donde deben estar.

💡
100% compatible con Bruno. Abre cualquier carpeta que funcione en Bruno y funcionará en Synapse Kayser — auth, headers, scripts y variables mapeadas con total fidelidad.
1
Archivo → Abrir Colección — selecciona la carpeta que contiene tus archivos .bru.
2
Edita los requests visualmente. Todos los cambios se guardan de vuelta al archivo .bru inmediatamente.
3
Usa Importar Postman para convertir un export JSON v2.1 de Postman al formato Bruno automáticamente.