velog_mcp

Ein MCP-Server, mit dem Claude direkt Beiträge auf Velog schreiben und veröffentlichen kann.

Unterstützt Velog, das keine öffentliche API hat, durch GraphQL-Reverse-Engineering. Entworfen für einen Human-in-the-Loop-Workflow (Entwurf → Benutzerprüfung → Veröffentlichung), sodass der Benutzer trotz Automatisierung die volle Kontrolle behält.

Installation

npx velog_mcp_setup

Kopieren Sie im angemeldeten Zustand bei Velog die Werte für access_token und refresh_token aus den Browser-Entwicklertools unter Application → Cookies → https://velog.io.

Die Token werden unter ~/.velog-mcp.json mit 0600-Berechtigungen gespeichert. Bitte fügen Sie diese zu Ihrer .gitignore hinzu.

Related MCP server: velog-mcp

Claude CLI (Claude Code) Konfiguration

Zum Projekt hinzufügen

claude mcp add velog npx -y velog_mcp

Oder fügen Sie es direkt zur .claude/settings.json des Projekts hinzu:

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

Global hinzufügen

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

Globale Einstellungen sind in allen Projekten verfügbar.

Überprüfung

claude mcp list

Wenn der velog-Server in der Liste erscheint, ist alles bereit. Sie können ihn danach direkt im Claude Code-Chat verwenden.

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

Claude Desktop Konfiguration

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

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

Verwendung

Beitrag schreiben und veröffentlichen

나: "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: "..." }

Privat veröffentlichen

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

Tool-Liste

Authentifizierung

• access_token: ~1-2 Stunden TTL. Der Velog-Server aktualisiert ihn automatisch über Set-Cookie in der GraphQL-Antwort.

• refresh_token: ~30 Tage TTL. Bei Ablauf ist ein erneuter Aufruf von npx velog_mcp_setup erforderlich.

• Es gibt keinen separaten Refresh-Endpunkt — die Velog-Middleware übernimmt dies automatisch.

Fehlerbehandlung

Hinweise

• Entwürfe werden im Sitzungsspeicher des MCP-Serverprozesses gespeichert. Sie gehen verloren, wenn Claude Desktop neu gestartet wird.

• Um Entwürfe ohne Veröffentlichung zu speichern, verwenden Sie velog_publish_post(is_private: true).

• Bilder: Verwenden Sie die Markdown-Methode für externe URLs (![alt](url)).

Lizenz

MIT