Ncloud

Name: Ncloud
Author: sjk4425

von sjk4425Version 2.2.0i★ 2iLäuft auf deinem Computer

Name in der Registryio.github.sjk4425/ncloud

So installierst du es

What it does

MCP server for Naver Cloud Platform (Ncloud) — Public, Government and Financial zones

Connects Läuft auf deinem Computer
Account or key Needs NCLOUD_ACCESS_KEY, NCLOUD_SECRET_KEY
Category Buchhaltung, Finanzen & Steuern

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

2/2 Prüfungen bestanden · Läuft auf deinem Computer

Zuerst: Welche KI nutzt du?

ClaudeWeb · App · HandyChatGPTWebClaude CodeTerminalCursorCode-EditorVS CodeCode-EditorAndereAndere Apps

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Ncloud registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Einstellungsdatei der Claude-Desktop-App öffnen
SettingsDeveloperEdit Config
Erledigt

Diese Einstellungen einfügen und speichern

{
  "mcpServers": {
    "ncloud": {
      "command": "npx",
      "args": [
        "-y",
        "ncloud-mcp-server"
      ],
      "env": {
        "NCLOUD_ACCESS_KEY": "your-value",
        "NCLOUD_SECRET_KEY": "your-value",
        "NCLOUD_ZONE": "your-value",
        "NCLOUD_REGION": "your-value",
        "NCLOUD_TOOL_GROUPS": "your-value",
        "NCLOUD_RESPONSE_PRUNE": "your-value",
        "NCLOUD_TIMEOUT_MS": "your-value",
        "NCLOUD_LANG": "your-value",
        "NCLOUD_RESPONSE_MAXBYTES": "your-value"
      }
    }
  }
}

Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

Erledigt

Claude beenden und neu öffnen
Erledigt
Ausprobieren
Nutze Ncloud und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude sagt, dass es Ncloud nutzt, oder ein Werkzeug von Ncloud in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Ncloud noch nicht verbinden

Ncloud läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Ncloud verbinden kann

Schritte für Claude →Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Schritte für Claude Code →Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Schritte für Cursor →Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Schritte für VS Code →Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Buchhaltung, Finanzen & Steuern, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Finance Toolkit✓ ChatGPT
SolidInvoice✓ ChatGPT
Finlab AI✓ ChatGPT

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Ncloud registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Erledigt

Diesen Befehl einfügen und Enter drücken

claude mcp add --scope user ncloud --env NCLOUD_ACCESS_KEY=your-value --env NCLOUD_SECRET_KEY=your-value --env NCLOUD_ZONE=your-value --env NCLOUD_REGION=your-value --env NCLOUD_TOOL_GROUPS=your-value --env NCLOUD_RESPONSE_PRUNE=your-value --env NCLOUD_TIMEOUT_MS=your-value --env NCLOUD_LANG=your-value --env NCLOUD_RESPONSE_MAXBYTES=your-value -- npx -y ncloud-mcp-server

Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

Erledigt

/mcp in Claude Code eingeben
Ncloud sollte in der Liste als verbunden erscheinen
Erledigt
Ausprobieren
Nutze Ncloud und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude Code sagt, dass es Ncloud nutzt, oder ein Werkzeug von Ncloud in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Ncloud registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button Cursor öffnen
In Cursor öffnen
Cursor fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Ncloud ist NCLOUD_ACCESS_KEY, NCLOUD_SECRET_KEY, NCLOUD_ZONE, NCLOUD_REGION, NCLOUD_TOOL_GROUPS, NCLOUD_RESPONSE_PRUNE, NCLOUD_TIMEOUT_MS, NCLOUD_LANG, NCLOUD_RESPONSE_MAXBYTES leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in Cursor im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Ncloud und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Cursor sagt, dass es Ncloud nutzt, oder ein Werkzeug von Ncloud in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Ncloud (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Ncloud registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button VS Code öffnen
In VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Ncloud ist NCLOUD_ACCESS_KEY, NCLOUD_SECRET_KEY, NCLOUD_ZONE, NCLOUD_REGION, NCLOUD_TOOL_GROUPS, NCLOUD_RESPONSE_PRUNE, NCLOUD_TIMEOUT_MS, NCLOUD_LANG, NCLOUD_RESPONSE_MAXBYTES leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in VS Code im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Ncloud und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn VS Code sagt, dass es Ncloud nutzt, oder ein Werkzeug von Ncloud in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Ncloud nutzen💬 Diskussion →

Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user ncloud --env NCLOUD_ACCESS_KEY=your-value --env NCLOUD_SECRET_KEY=your-value --env NCLOUD_ZONE=your-value --env NCLOUD_REGION=your-value --env NCLOUD_TOOL_GROUPS=your-value --env NCLOUD_RESPONSE_PRUNE=your-value --env NCLOUD_TIMEOUT_MS=your-value --env NCLOUD_LANG=your-value --env NCLOUD_RESPONSE_MAXBYTES=your-value -- npx -y ncloud-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ncloud": {
      "command": "npx",
      "args": [
        "-y",
        "ncloud-mcp-server"
      ],
      "env": {
        "NCLOUD_ACCESS_KEY": "your-value",
        "NCLOUD_SECRET_KEY": "your-value",
        "NCLOUD_ZONE": "your-value",
        "NCLOUD_REGION": "your-value",
        "NCLOUD_TOOL_GROUPS": "your-value",
        "NCLOUD_RESPONSE_PRUNE": "your-value",
        "NCLOUD_TIMEOUT_MS": "your-value",
        "NCLOUD_LANG": "your-value",
        "NCLOUD_RESPONSE_MAXBYTES": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ncloud": {
      "command": "npx",
      "args": [
        "-y",
        "ncloud-mcp-server"
      ],
      "env": {
        "NCLOUD_ACCESS_KEY": "your-value",
        "NCLOUD_SECRET_KEY": "your-value",
        "NCLOUD_ZONE": "your-value",
        "NCLOUD_REGION": "your-value",
        "NCLOUD_TOOL_GROUPS": "your-value",
        "NCLOUD_RESPONSE_PRUNE": "your-value",
        "NCLOUD_TIMEOUT_MS": "your-value",
        "NCLOUD_LANG": "your-value",
        "NCLOUD_RESPONSE_MAXBYTES": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ncloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ncloud-mcp-server"
      ],
      "env": {
        "NCLOUD_ACCESS_KEY": "your-value",
        "NCLOUD_SECRET_KEY": "your-value",
        "NCLOUD_ZONE": "your-value",
        "NCLOUD_REGION": "your-value",
        "NCLOUD_TOOL_GROUPS": "your-value",
        "NCLOUD_RESPONSE_PRUNE": "your-value",
        "NCLOUD_TIMEOUT_MS": "your-value",
        "NCLOUD_LANG": "your-value",
        "NCLOUD_RESPONSE_MAXBYTES": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

NCLOUD_ACCESS_KEY geheim erforderlich env
Ncloud API Access Key
NCLOUD_SECRET_KEY geheim erforderlich env
Ncloud API Secret Key
NCLOUD_ZONE env
Zone: 'pub' (default, Public zone), 'gov' (Government zone) or 'fin' (Financial zone). Selects the API gateways, regions and service catalogue; credentials must be issued by that zone's console. Any…
NCLOUD_REGION env
Ncloud region code. Public zone: KR, JPN, SGN, USWN, DEN. Government zone: KR (KR-CENTRAL), KRS (KR-SOUTH). Financial zone: FKR. Default KR (FKR in the Financial zone).
NCLOUD_TOOL_GROUPS env
Comma-separated tool groups to load at startup, e.g. 'compute,network,billing' or 'all,-billing'. Unset = all groups. Include the 'dynamic' keyword to start with the core set (common+compute+network+…
NCLOUD_RESPONSE_PRUNE env
Set to '1' to strip empty values (null/""/[]/{}) from responses globally.
NCLOUD_TIMEOUT_MS env
API request timeout in milliseconds (default 30000). HTTP 429 is always auto-retried up to 2 times; read-only query tools also retry 503/504 and network errors.
NCLOUD_LANG env
Language for client error messages: 'en' for English, otherwise/unset is Korean (default).
NCLOUD_RESPONSE_MAXBYTES env
Opt-in response-size guard for read-only tools. When set to a positive byte threshold, large read-only responses are truncated item-by-item to stay under it, adding 'truncated'/'suggestedPageSize' re…

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sterne i: 2
Downloads pro Wochei: 203/Wo.
Lizenz i: Keine Lizenz angegeben
Verbindung: Läuft auf deinem Computer
Transport: stdio
Neueste Versioni: 2.2.0
Kategoriei: Buchhaltung, Finanzen & Steuern
In der Registry veröffentlichti: 10. Nov. 2026
Code zuletzt geänderti: 10. Nov. 2026
Entwickler: sjk4425
Pakete: npm: ncloud-mcp-server
Repo: sjk4425/ncloud-mcp-server
Registry-Status: Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 12. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto sjk4425 bestätigt, dem das Repo gehört
✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vorgestern
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Mit Google anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Mit Google anmelden, um zu bewerten

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

Mehr Sterne als 92 % der anderen 3154 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 90 % der anderen 3154 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 3154 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Ncloud sicher?

Er hat 2 von 2 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: NCLOUD_ACCESS_KEY, NCLOUD_SECRET_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vorgestern geändert, und die neueste Version (2.2.0) kam vorgestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: CCXT, Finance Toolkit, AKQuant

Andere in derselben Kategorie

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

CCXT

Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets

von ccxtWeit verbreitet↓ 667/Wo.★ 44.863 Sterne des ganzen ReposAktualisiert vor 2 Monaten

Läuft auf deinem Computer

Installieren

Finance Toolkit

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

von JerBoumaWeit verbreitet↓ 15.624/Wo.★ 5519Aktualisiert vor 3 Tagen

Computer oder Cloud

Installieren

AKQuant

Write and backtest trading strategies with AKQuant: API lookup, strategy checks, backtest runs

von akfamilyWeit verbreitet↓ 3280/Wo.★ 2590Aktualisiert heute

Läuft auf deinem Computer

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Ncloud MCP Server

English

Naver Cloud Platform(Ncloud) 인프라를 AI 어시스턴트에서 직접 관리할 수 있는 Model Context Protocol (MCP) 서버입니다.

민간존(Public)·공공존(Government)·금융존(Financial)을 하나의 서버로 지원합니다. NCLOUD_ZONE=gov 또는 NCLOUD_ZONE=fin 한 줄로 해당 존의 API 게이트웨이·리전·서비스 카탈로그로 전환되며, 미설정 시 민간존입니다 → 존 선택.

주요 기능

Ncloud의 60개 이상 서비스, 1,000개 이상 API 도구를 MCP 프로토콜로 제공합니다.

카테고리	서비스
Compute	Server, Block Storage, Snapshot, Public IP, Init Script, Login Key, Placement Group, Fabric Cluster ⓕ, Auto Scaling, Cloud Functions
Networking	VPC, Subnet, ACG, Network ACL, NAT Gateway, Route Table, VPC Peering, Network Interface, Load Balancer, Target Group, Global DNS, Global Traffic Manager ⓕ
Database	Cloud DB for MySQL, PostgreSQL, MSSQL, MongoDB, Cache (Redis/Valkey), Cloud DB Serverless (MySQL) 🅿
Storage	Object Storage (S3 호환), Ncloud Storage (S3 호환) ⓕ, NAS, Archive Storage (Swift 호환) ⓕ
Containers	Ncloud Kubernetes Service (NKS), Container Registry
Security	Certificate Manager (2.0은 민간존 전용·메인 계정 키 필요), Private CA ⓕ, KMS (금융존은 암·복호화 6종만), Security Monitoring ⓕ, Secret Manager 🅿
Monitoring	Cloud Insight, Log Analytics
Management & Governance	Activity Tracer, Cloud Advisor 🅿, Resource Manager, Sub Account, Web service Monitoring System (WMS), STS(호출자 식별)
DevTools	SourceCommit, SourceBuild, SourceDeploy, SourcePipeline
Analytics	Search Engine Service, Cloud Hadoop, Cloud Data Streaming Service, Data Stream 🅿, Data Catalog 🅿, Data Forest 🅿, Data Flow 🅿, Data Query 🅿, Datafence 🅿, Cloud Data Box 🅿
Media	VOD Station, Live Station ⓖ, One Click Multi DRM ⓕ
Content Delivery (CDN)	Global Edge ⓕ, CDN+ (금융존 전용)
Application	API Gateway, SENS (SMS/알림톡/브랜드메시지/Mail 🅿, 프로젝트), Cloud Outbound Mailer(민간존: 레거시 '27-12까지 / 공공존·금융존: 정식)
Billing	Billing (요금/가격 조회, 비용·사용량, 할인)

ℹ️ 각 카테고리는 NCLOUD_TOOL_GROUPS의 그룹 key와 1:1로 대응합니다. 도구 일부만 로딩하려면 아래 도구 그룹 선택 표를 참고하세요.

🅿 = 민간존 전용(공공존·금융존 API 가이드에 없음) · ⓖ = 공공존 미제공 · ⓕ = 금융존 미제공. 존별 세부 차이는 존 선택의 표를 참고하세요.

모든 도구에 MCP 표준 tool annotations(readOnlyHint/destructiveHint/idempotentHint)이 부여되어, 지원 클라이언트에서 조회 도구 자동 승인·파괴적 도구 확인 UX를 적용할 수 있습니다. 파괴적 도구의 confirm 파라미터 게이트는 그대로 유지됩니다(이중 방어).

사전 요구사항

Node.js 20 이상
Ncloud API 인증키 (포털에서 발급)

참고 사항

민간존(Public)·공공존(Government)·금융존(Financial) 을 지원합니다. NCLOUD_ZONE으로 선택하며, 인증키는 반드시 해당 존 콘솔에서 발급한 것을 써야 합니다.
API 스펙은 민간존 API 가이드, 공공존 API 가이드, 금융존 API 가이드를 기반으로 작성되었으며, 존별 엔드포인트·리전·오퍼레이션 차이는 세 가이드를 대조해 반영했습니다.
민간존 한국(KR) 리전 위주로 실계정 테스트되었습니다. 공공존·금융존 지원은 각 존의 공식 API 가이드 대조와 단위 테스트로 검증되었으며 아직 실계정으로 확인되지 않았습니다 — 공공존·금융존에서 문제가 있으면 이슈로 알려 주세요. 다른 리전·존에서는 일부 API의 동작이 다를 수 있습니다.

설치

npx (권장 — 설치 불필요)

별도 설치 없이 npx로 바로 실행할 수 있습니다:

npx -y ncloud-mcp-server

MCP 클라이언트 설정 방법은 아래 MCP 클라이언트 설정 섹션을 참고하세요.

소스에서 빌드

# 저장소 클론

git clone https://github.com/sjk4425/ncloud-mcp-server.git cd ncloud-mcp-server

의존성 설치 및 빌드

npm install npm run build

환경 변수

변수	필수	설명	기본값
`NCLOUD_ACCESS_KEY`	✅	Ncloud API Access Key	-
`NCLOUD_SECRET_KEY`	✅	Ncloud API Secret Key	-
`NCLOUD_ZONE`	-	존 선택. `pub`(민간존), `gov`(공공존), `fin`(금융존). 잘못된 값이면 시작을 중단 (자세히는 아래 존 선택)	`pub`
`NCLOUD_REGION`	-	리전 코드. 민간존 `KR`/`JPN`/`SGN`/`USWN`/`DEN`, 공공존 `KR`(수도권)/`KRS`(남부권), 금융존 `FKR`	`KR` (금융존 `FKR`)
`NCLOUD_API_URL`	-	기본 API 게이트웨이 override(존 기본값을 덮어씀)	민간존 `https://ncloud.apigw.ntruss.com` / 공공존 `https://ncloud.apigw.gov-ntruss.com` / 금융존 `https://fin-ncloud.apigw.fin-ntruss.com`
`NCLOUD_ARCHIVE_PROJECT_ID`	-	Archive Storage 프로젝트 ID	-
`NCLOUD_ARCHIVE_DOMAIN_ID`	-	Archive Storage 도메인 ID	-
`NCLOUD_SENS_SERVICE_ID`	-	SENS 채널 공통 기본 serviceId(NRN, 예 `ncp:sms:kr:…`). 채널별 변수 `NCLOUD_SENS_SMS_SERVICE_ID` / `NCLOUD_SENS_ALIMTALK_SERVICE_ID` / `NCLOUD_SENS_BRANDMESSAGE_SERVICE_ID`(미설정 시 알림톡 값 사용) / `NCLOUD_SENS_MAIL_SERVICE_ID`가 우선. 모든 SENS 도구는 `serviceId` 파라미터로 호출별 override 가능하며, NRN은 `ncloud_sens_list_projects`로 조회	-
`NCLOUD_OBJECT_STORAGE_ENDPOINT`	-	Object Storage 호스트 덮어쓰기(서명 리전은 존 기본값 유지). 금융존 기본값은 VPC 내부 전용 Private 호스트 `kr.object.private.fin-ncloudstorage.com`이므로, 금융존 밖(인터넷 경로가 있는 곳)에서 쓸 때는 `kr.object.fin-ncloudstorage.com`으로 지정	존별 기본값
`NCLOUD_STORAGE_ADDRESSING`	-	Ncloud Storage(`ncloud_ncs_*`) 버킷 주소 방식. 기본은 공식 문서의 virtual-hosted(`https://{bucket}.kr.ncloudstorage.com/`), `path`면 이전 방식(`https://kr.ncloudstorage.com/{bucket}/`)으로 되돌림. Ncloud Storage는 KR 단일 리전이라 `NCLOUD_REGION`과 무관	virtual-hosted
`NCLOUD_TOOL_GROUPS`	-	시작 시 로딩할 도구 그룹 선택. 미설정 시 전체 ON. `dynamic`을 포함하면 핵심 그룹만 켜고 세션 중 확장 허용(그 외 값은 잠금) (자세히는 아래 도구 그룹 선택 참조)	전체
`NCLOUD_RESPONSE_PRUNE`	-	`1`이면 응답에서 빈 값(`null`/`""`/`[]`/`{}`)을 전역 제거	`0`
`NCLOUD_TIMEOUT_MS`	-	API 요청 타임아웃(밀리초). 초과 시 호출이 중단되고 안내 메시지를 반환 (HTTP 429는 항상 최대 2회 자동 재시도, 조회 도구는 503/504·네트워크 오류도 재시도)	`30000`
`NCLOUD_LANG`	-	클라이언트 에러 메시지 언어. `en`이면 영문, 그 외/미설정이면 한국어	`ko`
`NCLOUD_RESPONSE_MAXBYTES`	-	옵트인 응답 크기 가드(바이트). 양수면 조회 도구의 대형 응답을 항목 단위로 잘라 임계 이하로 만들고 `truncated`/`suggestedPageSize` 힌트를 덧붙임. 미설정/0이면 가드 OFF(응답 무변경)	-

존 선택 (민간존 / 공공존 / 금융존)

하나의 패키지로 세 존을 지원합니다. NCLOUD_ZONE만 바꾸면 API 게이트웨이 도메인, 리전 카탈로그, 존별 서비스 카탈로그, 일부 서비스의 API 버전·경로·필드 차이까지 서버가 알아서 맞춥니다. 도구 이름과 파라미터는 세 존에서 동일하므로 프롬프트를 바꿀 필요가 없습니다.

	민간존 (`pub`, 기본값)	공공존 (`gov`)	금융존 (`fin`)
인증키 발급	민간존 콘솔	공공존 콘솔	금융존 콘솔
기본 게이트웨이	`ncloud.apigw.ntruss.com`	`ncloud.apigw.gov-ntruss.com`	`fin-ncloud.apigw.fin-ntruss.com`
리전 (`NCLOUD_REGION`)	`KR`, `JPN`, `SGN`, `USWN`, `DEN`	`KR`(수도권), `KRS`(남부권)	`FKR`
API 가이드	https://api.ncloud-docs.com/docs/home	https://api-gov.ncloud-docs.com/docs	https://api-fin.ncloud-docs.com/docs/api-overview
도구 수 (전 그룹)	1,300	1,007	862

도구 수는 NCLOUD_ARCHIVE_PROJECT_ID/NCLOUD_ARCHIVE_DOMAIN_ID 미설정 기준입니다. 설정하면 Archive Storage 도구 10개가 민간존·공공존에 추가됩니다.

⚠️ 인증키는 존별로 별개입니다. 민간존 키로 공공존·금융존을 호출하면(또는 그 반대) 인증 오류가 납니다. NCLOUD_ZONE에 pub/gov/fin 외의 값을 주면 다른 존으로 조용히 가지 않도록 서버가 시작 시 종료합니다.

🔑 계정·키 관련 주의 (2.0.0)

- Certificate Manager 2.0 (ncloud_cm2_*, 민간존)은 메인 계정 Access Key로만 호출됩니다(Ncloud 기술지원 확인). 서브 계정 키는 2.0 엔드포인트가 HTTP 403으로 거부하며, 이때 서버는 호출자 정보와 함께 안내문을 돌려주고 조회·외부 인증서 등록은 어떤 키로든 되는 1.0 도구(ncloud_list_certificates, ncloud_register_external_certificate)를 안내합니다.

- Secret Manager (ncloud_secret_*, 민간존)은 시크릿을 암호화한 KMS 키 종류에 따라 호스트가 다릅니다. 모든 도구의 keyIsolation 파라미터로 고릅니다 — global(기본, secretmanager.apigw.ntruss.com) / regional(KMS 리전 격리 키, ocapi-kr.ncloud.com/secretmanager; 일본 리전은 격리 키만). 격리 키 호스트는 서버 시작 시 리전(NCLOUD_REGION)으로 정해집니다.

- Cloud DB Serverless (ncloud_serverless_*, 민간존)도 메인 계정 Access Key로만 호출됩니다. 서브 계정 키는 API가 HTTP 403 sub account is not supported yet로 거부하며(2026-10-02 재확인, NCP_ADMINISTRATOR 서브 계정), 서버는 그 403에 메인 계정 키를 쓰라는 안내를 덧붙입니다. 같은 키로 Cloud DB for MySQL 등 다른 DB 도구는 정상 동작합니다.

- 현재 키가 메인 계정인지 서브 계정인지는 ncloud_get_caller_identity(STS, 세 존)로 확인할 수 있습니다.

공공존 설정 예시

"mcpServers": { "ncloud-gov": { "command": "npx", "args": ["-y", "ncloud-mcp-server"], "env": { "NCLOUD_ZONE": "gov", "NCLOUD_ACCESS_KEY": "your-gov-access-key", "NCLOUD_SECRET_KEY": "your-gov-secret-key", "NCLOUD_REGION": "KR" } } } }

금융존은 "NCLOUD_ZONE": "fin", "NCLOUD_REGION": "FKR"(생략 가능 — 금융존 기본값)에 금융존 콘솔에서 발급한 키를 넣으면 됩니다. 여러 존을 동시에 쓰려면 위처럼 이름이 다른 서버 항목을 여러 개(ncloud, ncloud-gov, ncloud-fin) 등록하면 됩니다.

존별 차이 (공식 가이드 대조, 2026-09-30 기준)

구분	내용
민간존 전용 서비스	Cloud DB Serverless, Cloud Advisor, Live Station(금융존은 제공), Data Stream/Catalog/Forest/Flow/Query, Datafence, Cloud Data Box, Secret Manager, Certificate Manager 2.0, SENS Mail 채널
민간존 전용 오퍼레이션	LB 리스너 인증서(SNI) 3종(금융존은 제공), NKS kubeconfig 재발급, VOD Station 채널 수정(금융존은 제공), DRM 정책 복제, SES/CDSS의 KVM(G3) 생성·스펙 조회 계열, KMS 키 생성의 `protectionType`
공공존 전용 오퍼레이션	Cloud DB for Cache 사용자(ACL) 관리 4종, Certificate Manager 사설 인증서 발급(`issuePrivate`), Cloud Outbound Mailer 발송·조회 5종(금융존도 제공; 민간존은 SENS Mail로 대체)
금융존 미제공 서비스	Global Traffic Manager, Ncloud Storage, Archive Storage, Cloud DB Serverless, Fabric Cluster, NKS Add-on Manager, Cloud Advisor, Data*, One Click Multi DRM, Global Edge(금융존 `cdn` 그룹은 CDN+ 5종), Private CA, Security Monitoring, KMS API 2.0(키 관리·ACL·토큰)
금융존 전용 오퍼레이션	Cloud Insight Metric Export 6종, Cloud Log Analytics 서버 로그 수집 해제(`ncloud_delete_server_log_collection`)
같은 서비스, 다른 API	Cloud Functions: 민간존·금융존 API v2.1(`/ncf/api/v2`; 금융존은 VPC 전용, `platform` 쿼리 없음) / 공공존 API v2.0(`/api/v2`, Classic 전용, cron·github 트리거만). Object Storage: 공공존 `kr`/`krs.object.gov-ncloudstorage.com`(서명 리전 `gov-standard`/`gov2-standard`), 금융존 `kr.object.fin-ncloudstorage.com`(`fin-standard`). NKS·NCR·SES·CDSS·Log Analytics: 리전이 경로에 들어가며(민간존 `sgn`/`jpn`, 공공존 `krs`, 금융존 `fkr`) 서버가 활성 리전으로 조립. NKS 금융존 경로 접두 `/nks/v2`(다른 존 `/vnks/v2`). Live Station 금융존: 민간존 호스트에 경로 접두 `/api/fin-v2`. KMS 금융존: v1 게이트웨이(`kms.apigw.fin-ntruss.com`)의 암·복호화 6종만
호스트가 규칙(`*.apigw.gov-ntruss.com`)과 다른 공공존 서비스	Container Registry `gov-ncr`, Private CA `privateca`, VOD Station `vod-station`, KMS `ocapi.gov-ncloud.com`, Ncloud Storage/Object Storage/Archive `*.gov-ncloudstorage.com`
호스트가 규칙(`*.apigw.fin-ntruss.com`)과 다른 금융존 서비스	기본 게이트웨이 `fin-ncloud`, SES `fin-vpcsearchengine`, CDSS `fin-clouddatastreamingservice`, Billing `billingapi.apigw-pub`, SourceDeploy/SourcePipeline(`vpc` 접두 없음), Live Station(민간존 호스트), Object Storage `kr.object.fin-ncloudstorage.com`
이식하지 않은 서비스	민간·공공존의 CDN+, Global CDN (민간은 종료, 공공은 2026-12-31 종료 예정 — Global Edge 사용). 금융존은 Global Edge가 없어 CDN+ 5종을 등록

해당 존에서 제공되지 않는 도구는 등록 자체가 되지 않으므로 도구 목록에 나타나지 않습니다. ncloud_get_current_region으로 현재 서버가 묶인 존과 사용 가능한 리전을 확인할 수 있습니다.

MCP 클라이언트 설정

npx 사용 (권장)

mcp.json (또는 해당 클라이언트의 MCP 설정 파일)에 추가:

"mcpServers": { "ncloud": { "command": "npx", "args": ["-y", "ncloud-mcp-server"], "env": { "NCLOUD_ACCESS_KEY": "your-access-key", "NCLOUD_SECRET_KEY": "your-secret-key", "NCLOUD_REGION": "KR" } } } }

소스 빌드 사용

"mcpServers": { "ncloud": { "command": "node", "args": ["path/to/ncloud-mcp-server/dist/index.js"], "env": { "NCLOUD_ACCESS_KEY": "your-access-key", "NCLOUD_SECRET_KEY": "your-secret-key", "NCLOUD_REGION": "KR" } } } }

도구 그룹 선택 (선택)

기본 설정만으로 전체 도구(약 1,000개)가 모두 동작합니다. 그냥 다 쓰고 싶다면 이 변수를 설정하지 마세요 — 미설정이 곧 "전체 ON"이며 기존과 동일하게 동작합니다. 아래는 *시작 컨텍스트를 가볍게 하거나(권장: dynamic), 도구를 일부만 켜고 싶을 때*만 보면 됩니다.

왜 필요한가요? 전체 ON이면 도구 정의만으로 세션 컨텍스트를 크게 점유합니다(tools/list ≈ 694KB / 약 177k 토큰). NCLOUD_TOOL_GROUPS로 필요한 그룹만 켜면 AI가 한 번에 보는 도구 수가 줄어 토큰 비용이 절감되고 도구

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Ncloud

What it does

Installation

Node.js installieren

Bei Ncloud registrieren und Schlüssel erstellen

Einstellungsdatei der Claude-Desktop-App öffnen

Diese Einstellungen einfügen und speichern

Claude beenden und neu öffnen

Ausprobieren

Das kannst du stattdessen tun

Node.js installieren

Bei Ncloud registrieren und Schlüssel erstellen

Terminal öffnen

Diesen Befehl einfügen und Enter drücken

/mcp in Claude Code eingeben

Ausprobieren

Node.js installieren

Bei Ncloud registrieren und Schlüssel erstellen

Mit diesem Button Cursor öffnen

Schlüssel eintragen

KI-Chat in Cursor im Agent-Modus öffnen

Ausprobieren

Node.js installieren

Bei Ncloud registrieren und Schlüssel erstellen

Mit diesem Button VS Code öffnen

Schlüssel eintragen

KI-Chat in VS Code im Agent-Modus öffnen

Ausprobieren

Auf deinem Computer installiert

Werte, die du selbst einträgst

Auf einen Blick

Welche Apps ihn nutzen können

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Diskussion

Nutzerbewertungen

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

Häufige Fragen

Andere in derselben Kategorie

CCXT

Finance Toolkit

AKQuant

README vom Entwickler

Ncloud MCP Server

주요 기능

사전 요구사항

참고 사항

설치

npx (권장 — 설치 불필요)

소스에서 빌드

의존성 설치 및 빌드

환경 변수

존 선택 (민간존 / 공공존 / 금융존)

MCP 클라이언트 설정

npx 사용 (권장)

소스 빌드 사용

도구 그룹 선택 (선택)