Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Md Log MCP

de md-logversión 1.3.1i★ 3iSe ejecuta en tu computadora
Nombre en el registrocom.md-log/md-log-mcp

Cómo instalar

What it does

md-log MCP: save/update/fetch markdown by path (stdio + remote HTTP, PAT auth).

  • Connects Se ejecuta en tu computadora
  • Account or key Needs MDLOG_PAT · 1 setting to fill in (MDLOG_API_BASE_URL)
  • Category Documentos, hojas de cálculo y oficina

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Md Log MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • MDLOG_API_BASE_URL md-log backend API base URL (must include /api/v1) · valor por defecto https://app.md-log.com/api/v1

    Las descripciones siguen en el inglés original.

  4. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  5. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "md-log": {
          "command": "npx",
          "args": [
            "-y",
            "md-log-mcp"
          ],
          "env": {
            "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
            "MDLOG_PAT": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Cierra Claude y vuelve a abrirlo

  7. Pruébalo

    Usa Md Log MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Md Log MCP o muestra una herramienta de Md Log MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Md Log MCP

Md Log MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Md Log MCP

  • Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Documentos, hojas de cálculo y oficina que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Md Log MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • MDLOG_API_BASE_URL md-log backend API base URL (must include /api/v1) · valor por defecto https://app.md-log.com/api/v1

    Las descripciones siguen en el inglés original.

  4. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  5. Pega este comando y pulsa Enter

    claude mcp add --scope user md-log --env MDLOG_API_BASE_URL=https://app.md-log.com/api/v1 --env MDLOG_PAT=your-value -- npx -y md-log-mcp

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Escribe /mcp en Claude Code

    Deberías ver Md Log MCP en la lista como conectado

  7. Pruébalo

    Usa Md Log MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Md Log MCP o muestra una herramienta de Md Log MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Md Log MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • MDLOG_API_BASE_URL md-log backend API base URL (must include /api/v1) · valor por defecto https://app.md-log.com/api/v1

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Md Log MCP, MDLOG_PAT, MDLOG_API_BASE_URL está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de Cursor en modo Agent

  7. Pruébalo

    Usa Md Log MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Md Log MCP o muestra una herramienta de Md Log MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de Md Log MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (MDLOG_API_BASE_URL) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Md Log MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • MDLOG_API_BASE_URL md-log backend API base URL (must include /api/v1) · valor por defecto https://app.md-log.com/api/v1

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Md Log MCP, MDLOG_PAT, MDLOG_API_BASE_URL está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de VS Code en modo Agent

  7. Pruébalo

    Usa Md Log MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Md Log MCP o muestra una herramienta de Md Log MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Md Log MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user md-log --env MDLOG_API_BASE_URL=https://app.md-log.com/api/v1 --env MDLOG_PAT=your-value -- npx -y md-log-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "md-log": {
      "command": "npx",
      "args": [
        "-y",
        "md-log-mcp"
      ],
      "env": {
        "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
        "MDLOG_PAT": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "md-log": {
      "command": "npx",
      "args": [
        "-y",
        "md-log-mcp"
      ],
      "env": {
        "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
        "MDLOG_PAT": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "md-log": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "md-log-mcp"
      ],
      "env": {
        "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
        "MDLOG_PAT": "your-value"
      }
    }
  }
}

Valores que debes completar

  • MDLOG_API_BASE_URL obligatorio env
    md-log backend API base URL (must include /api/v1)
  • MDLOG_PAT secreto obligatorio env
    md-log Personal Access Token (mdlog_pat_...)

Las descripciones siguen en el inglés original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
103/sem
Dominio verificado
✓ md-log.com
Conexión
Se ejecuta en tu computadora
Última versióni
1.3.1
Publicado en el registroi
8 nov 2026
Último cambio de códigoi
8 nov 2026
Creador
md-log
Paquetes
npm: md-log-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 14 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con el dominio md-log.com (el registro comprueba quién es dueño del dominio)

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Documentos, hojas de cálculo y oficinai

  • Más estrellas que el 89% de los otros 3923 servidores de esta categoría
  • Publicado en el registro más recientemente que el 79% de los otros 3923 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 3923 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Md Log MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: MDLOG_PAT

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (1.3.1) llegó al registro hace 6 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Puter MCP, XcodeBuildMCP, XcodeBuildMCP

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

de HeyPuterMuy usado★ 44,2 milActualizado hace 5 meses

Se ejecuta en la nube✓ del servicio · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

de getsentryMuy usado↓ 130,5 mil/sem paquete compartido★ 6,6 milActualizado hace 4 meses

Se ejecuta en tu computadora✓ del servicio · xcodebuildmcp.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

de cameroncookeMuy usado↓ 130,5 mil/sem paquete compartido★ 6,6 milActualizado hace 14 meses

Se ejecuta en tu computadora

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

md-log-mcp

Review the report, not the diff. An MCP server that lets your AI coding agent — Claude Code, Claude Desktop, Codex, Cursor — save its work and analysis as immutable, versioned Markdown reports into md-log, a human-in-the-loop review & archive layer for "vibe coding." You then read and stylus-annotate (S-Pen / Apple Pencil) those reports on web, phone, and tablet — every save a new immutable version.

A Model Context Protocol server — two transports, one tool set — that lets Claude Code (and other agents) save .md files — text and embedded screenshots together — straight into md-log, a human-in-the-loop review & archive layer for vibe coding. The recommended way to connect is the hosted remote endpoint (https://mcp.md-log.com/mcp, a URL + your key — no install); a local stdio (npx -y md-log-mcp) transport is the alternative. The agent writes a report by path (my-project/2026-07-07-error-report.md); missing folders are auto-created, images are uploaded and their references rewritten to asset:// links, and every save becomes an immutable new version. The same report is then readable, editable, and stylus-annotatable (S-Pen / Apple Pencil where supported) on a phone or tablet, and on the web.

md-log is a hosted service at https://app.md-log.com — you don't run any server yourself. This package is just the connector: a thin authenticated HTTP client that validates POSIX paths, orchestrates asset uploads, maps errors to stable agent codes, and forwards everything to the hosted md-log service — the single authority for auth, storage, versioning and quota. All you need is a Personal Access Token from the web app.

Stack

  • @modelcontextprotocol/sdk (TypeScript) — one McpServer (17 tools), two transports.
  • stdio transport (md-log-mcp) — JSON-RPC over stdin/stdout; the default local mode (so stdout is reserved for the protocol; logs go to stderr). PAT from env.
  • Streamable HTTP transport (md-log-mcp-http) — the remote mode: agents connect by URL with no local install; the PAT is taken per request from the Authorization header. See Remote (Streamable HTTP) mode.
  • TypeScript, bundled with tsup to ESM dist/server.js (stdio) + dist/http.js (HTTP). Runtime deps: the MCP SDK and zod (input schemas). Node's built-in fetch/http are the only network layers — no web framework.
  • PAT auth — a md-log Personal Access Token sent to the backend as Authorization: Bearer.

Requirements

  • Node 22+
  • A Personal Access Token (PAT) minted in the md-log web app (Settings → Tokens; shown once)

That's it — the md-log service itself is hosted at https://app.md-log.com; there is nothing to install or self-host.

Tools (17)

Every tool returns dual output — a human-readable content[].text and a machine-readable structuredContent — and validates the POSIX path (NFC-normalize; reject ../., control chars, empty/whitespace segments, backslashes, reserved names; enforce 255-byte name / 1024-byte path limits; require .md for files) before any backend call. All requests hit the base URL in MDLOG_API_BASE_URL (which already includes /api/v1).

ToolWhat it does
`save_markdown` ⭐The headline tool. Create or overwrite a .md by path (force last-writer-wins); missing folders auto-created. Optionally uploads embedded images first (each given as data_base64 or a local file_path) and rewrites each placeholder in the content to an asset:// link. Accepts commit_message — a recommended 1-2 line change summary shown in the version history.
upload_assetUpload one image (reserve → presigned PUT → complete) and return an asset:// reference to embed as . Provide the image as either data_base64 (inline base64) or file_path (a local file the server reads) — exactly one; with file_path, filename defaults to the basename and content_type is inferred from the extension (png/jpg/jpeg/gif/webp/avif).
append_to_markdownAppend to an existing file with optimistic concurrency (GET current → concat → conditional PUT with base_version_no). Auto-retries once on conflict, then surfaces CONFLICT. Accepts commit_message — a recommended 1-2 line change summary shown in the version history.
`edit_markdown`Change PART of a file by exact literal replacement (read → apply → conditional PUT with base_version_no; auto-retries once on conflict, re-applying every edit). Pass several changes at once as `edits: [{old_string, new_string, replace_all?}, …]` (max 50, applied in order) — they land as one write = one version = one notification; for a single change the old_string/new_string shorthand still works (never both). Each old_string must match exactly once, counting overlapping positions too ("\n\n" inside "\n\n\n" is ambiguous → detail.overlapping: true) — 0 matches or an ambiguous >1 rejects the whole call with VALIDATION (detail.reason = NO_MATCH / AMBIGUOUS_MATCH, detail.edit_index = the failing edit) and nothing is written; set replace_all:true to change every occurrence on purpose. Other detail.reasons: input shape — MIXED_INPUT, MISSING_EDIT, EMPTY_EDITS, TOO_MANY_EDITS, EMPTY_OLD_STRING, IDENTICAL_STRINGS (rejected before any read); result — NO_CHANGE (edits cancel out), DOCUMENT_TOO_LARGE (a step would pass the 25 MiB cap), TOO_MANY_REPLACEMENTS (more occurrences replaced in one call than the document cap allows), BATCH_TOO_SLOW (edits after the first stopped once the call has run 2 s — split them across calls). A match failure on the conflict retry carries detail.after_concurrent_write: true. Never creates a file (missing path → NOT_FOUND) and has no force mode — prefer it over update_markdown for any partial change.
update_markdownReplace a file's ENTIRE content. Pass expected_version for optimistic concurrency (mismatch → CONFLICT); omit it to force LWW. Passing expected_version for a path that does not exist now returns CONFLICT (detail.server_version_no = 0), not a silent create. For a partial change use edit_markdown instead. Accepts commit_message — a recommended 1-2 line change summary shown in the version history.
restore_versionRoll a file back to an earlier version_no (from list_versions): that version's content becomes a NEW current version — history is immutable, so the rollback is itself undoable. Restoring the version the file is already on is an accepted no-op. Accepts commit_message.
get_markdownRead a file's content by path (materializes inline content or a presigned content URL for large docs). Pass version (a version_no from list_versions) to read an old immutable version.
list_versionsList a file's immutable version history, newest first (version_no, commit_message, author, registered_at, size).
delete_markdownSoft-delete a file. Requires confirm:true (otherwise VALIDATION); resolves the path to a document key first.
create_foldermkdir -p — create every missing segment; already-existing folders count as success.
list_foldersReturn the full folder tree.
list_filesList the documents and immediate subfolders inside a folder path.
search_markdownSearch by TITLE (substring) + BODY full-text (current versions; whole-word match, ranked, body hits include a snippet).
move_markdownMove and/or rename a .md by path (from_path → to_path); destination folders auto-created; the document KEEPS its key, so version history and reviewers' annotations survive.
move_folderMove a folder (whole subtree) under a new parent (new_parent_path empty/omitted = root); parent auto-created; cyclic moves rejected server-side.
rename_folderRename a folder in place (descendant paths rewritten server-side).
delete_folderDelete a folder. Requires confirm:true; by default only an EMPTY folder is deleted — pass cascade:true to soft-delete the whole subtree (rm -r).
Error codes surfaced to the agent

Backend failures return { isError: true, content:[{type:"text", ...}] } with a mapped code in structuredContent.error.code:

NOT_FOUND · CONFLICT (carries the server head {server_version_no, server_checksum, …} in detail) · UNAUTHORIZED · RATE_LIMITED · QUOTA_EXCEEDED · BACKEND_UNAVAILABLE · VALIDATION · FOLDER_EXISTS (swallowed as success by create_folder) · ERROR.

Authentication

The MCP/PC lane authenticates with a Personal Access Token (mdlog_pat_…) — minted once in the web app's Settings and supplied via env. The client attaches it as Authorization: Bearer (plus X-API-Token for compatibility) on every request. The backend is the single source of truth for auth and quota.

VariableRequiredExampleNotes
MDLOG_API_BASE_URLyeshttps://app.md-log.com/api/v1The hosted service base, including /api/v1. No version suffix is appended; a trailing slash is stripped.
MDLOG_PATyesmdlog_pat_xxxxxxxxxxxxxxxxxxxxxxxxBearer PAT. Store it securely (OS keychain) — never commit it.
MDLOG_MAX_DOCUMENT_BYTESno26214400 (25 MiB)Client-side pre-flight for the backend's per-document body cap, in UTF-8 bytes (Korean is 3 bytes/char). An over-cap save fails immediately with a VALIDATION error naming the actual size, instead of an opaque backend 400. Applies to both transports. Change only against a self-hosted backend with a different cap.

The server fails fast at startup with a clear message if either var is missing or the base URL is malformed.

Build

npm install

npm run build # tsup → dist/server.js (ESM, Node 22) npm run typecheck # tsc --noEmit (optional)

Smoke test

scripts/smoke.mjs spawns the built server over stdio (MCP SDK Client + StdioClientTransport), then runs initialize → tools/list → save_markdown (a small report embedding a tiny data: PNG) → get_markdown (reads it back, checks the marker) → search_markdown — printing PASS/FAIL per step and exiting non-zero on any failure. Run it against a live backend with a real PAT:

npm run build

MDLOG_API_BASE_URL="http://localhost:8080/api/v1" \ MDLOG_PAT="mdlog_pat_xxxx" \ node scripts/smoke.mjs # or: npm run smoke

Connect a client

Mint the PAT in the web app's Settings → Tokens, store it securely, then add md-log to your MCP client. Never commit a PAT.

📄 연결 가이드 (HTML) — md-log.com/guides/customer-guide.html: 웹 앱에서 발급받은 MCP 키(PAT) 로 URL 연결(권장) 또는 npx 로컬 연결 (Claude Code · Desktop · Codex · Cursor).

Recommended — remote (URL), no install

Point your client at the hosted endpoint and pass the PAT as a Bearer header. Nothing to install — no Node.js, no `npx`. (You don't even need this package for the hosted connection.)

# Claude Code

claude mcp add --transport http md-log https://mcp.md-log.com/mcp \ --header "Authorization: Bearer mdlog_pat_xxxxxxxxxxxxxxxxxxxxxxxx"

// Cursor / Claude Desktop / any client that takes JSON — the `type` field MUST be "http"

{ "mcpServers": { "md-log": { "type

Solo se muestra el principio; lee el resto en el repo