velog_mcp

Un servidor MCP que permite a Claude escribir y publicar posts directamente en Velog.

Soporta Velog, que no tiene una API pública, mediante ingeniería inversa de GraphQL. Está diseñado con un flujo de trabajo de "humano en el bucle" (borrador → revisión del usuario → publicación), lo que permite la automatización mientras el usuario mantiene el control total.

Instalación

npx velog_mcp_setup

Inicia sesión en Velog, abre las herramientas de desarrollador del navegador (DevTools) → Application → Cookies → https://velog.io y copia los valores de access_token y refresh_token.

Los tokens se guardarán en ~/.velog-mcp.json con permisos 0600. Asegúrate de añadirlo a tu .gitignore.

Related MCP server: velog-mcp

Configuración de Claude CLI (Claude Code)

Añadir al proyecto

claude mcp add velog npx -y velog_mcp

O añádelo directamente al archivo .claude/settings.json de tu proyecto:

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog_mcp"]
    }
  }
}

Añadir globalmente

claude mcp add --scope global velog npx -y velog_mcp

La configuración global está disponible en todos los proyectos.

Verificación

claude mcp list

Si el servidor velog aparece en la lista, está listo. Puedes usarlo directamente en la conversación de Claude Code.

나: "React 훅에 대한 글 써줘"
Claude: (velog_draft_post 호출 → 검토 후 발행)

Configuración de Claude Desktop

Añádelo a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog_mcp"]
    }
  }
}

Uso

Escribir y publicar un post

나: "React 19 concurrent features에 대한 글 써줘"

Claude: velog_draft_post 호출
→ { draft_id: "abc123", title: "React 19 Concurrent Features 정리", body_preview: "..." }

나: "좋아, 발행해"

Claude: velog_publish_post(draft_id: "abc123") 호출
→ { url: "https://velog.io/@username/react-19-...", post_id: "..." }

Publicación privada

나: "이 글 비공개로 발행해줘"
Claude: velog_publish_post(draft_id: "abc123", is_private: true)

Lista de herramientas

Autenticación

• access_token: TTL de ~1-2 horas. El servidor de Velog lo renueva automáticamente mediante Set-Cookie en la respuesta GraphQL.

• refresh_token: TTL de ~30 días. Si caduca, es necesario volver a ejecutar npx velog_mcp_setup.

• No hay un endpoint de refresco separado: el middleware de Velog lo gestiona automáticamente.

Manejo de errores

Notas importantes

• Los borradores se guardan en la memoria de sesión del proceso del servidor MCP. Se pierden al reiniciar Claude Desktop.

• Para guardar sin publicar, usa velog_publish_post(is_private: true) para guardar como privado.

• Imágenes: Usa el formato de referencia de URL externa de Markdown (![alt](url)).

Licencia

MIT