Korea Investment MCP mit ChatGPT verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Korea Investment & Securities klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Korea Investment & Securities + ChatGPT

Lies koreanische und ausländische Marktdaten aus der KIS Developers Open API von Korea Investment & Securities: Kurse von Aktien und ETFs, Tages- und Minutencharts, Orderbücher, Investorenströme, die Indizes KOSPI und KOSDAQ sowie Kurse US-amerikanischer, japanischer, Hongkonger und chinesischer Aktien. Nur Lesezugriff, kein Handel.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

KIS_APP_KEY, KIS_APP_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert wenige Minuten. Du brauchst ein Wertpapierkonto bei Korea Investment & Securities (한국투자증권) und für dieses Konto den Open-API-Dienst von KIS Developers, der dir einen App Key und ein App Secret gibt.

Nur Marktdaten: Der Connector liest Kurse, Charts, Orderbücher, Investorenströme, Indizes und Stammdaten. Er kann keine Orders aufgeben, ändern oder stornieren und liest weder Kontostände noch Positionen oder Einlagen. WebSocket-Streaming, Futures und Optionen sowie Anleihehandel sind ebenfalls nicht abgedeckt.

1. Beantrage den Open-API-Dienst auf apiportal.koreainvestment.com (KIS Developers, API 신청) und wähle dein Konto für den Echthandel (실전투자).
2. Kopiere den App Key in KIS_APP_KEY und das daneben angezeigte App Secret in KIS_APP_SECRET. Der App Key besteht aus 20 bis 64 Buchstaben und Ziffern; das App Secret ist eine lange Zeichenkette von etwa 180 Zeichen: Füge es vollständig ein, ohne Leerzeichen oder Zeilenumbrüche.
3. Installiere den Connector. Prüfe die Verbindung mit korea_investment_get_stock_price und dem Code 005930 (Samsung Electronics).

Nur Keys für den Echthandel: Keys für den Simulationshandel (모의투자) funktionieren nur auf dem separaten KIS-Host openapivts.koreainvestment.com:29443, den dieser Connector nicht nutzt. Wer mit Echthandel-Keys Kurse abruft, löst damit keine Trades aus.

Tokens: Der Connector tauscht App Key und App Secret gegen ein Zugriffstoken (POST /oauth2/tokenP) und schickt es bei jedem Aufruf mit, zusammen mit den Headern, die KIS verlangt. Ein KIS-Token gilt 24 Stunden, und KIS erlaubt etwa eine Token-Anfrage pro Minute; eine erneute Anfrage innerhalb von 6 Stunden liefert dasselbe Token, und KIS schickt eventuell bei jedem neuen Token eine KakaoTalk-Nachricht. Der Connector behält das Token und holt erst kurz vor Ablauf ein neues.

Cloud und Self-Hosting funktionieren gleich: Beide nutzen deinen eigenen App Key und dein App Secret. Ein selbst gehosteter Server muss ausgehende Verbindungen zu openapi.koreainvestment.com auf Port 9443 aufbauen dürfen.

Rate-Limits und Seiten: KIS erlaubt mit Echthandel-Keys etwa 20 Aufrufe pro Sekunde und Konto; EGW00201 heißt, dass es zu viele Aufrufe waren: Mach langsamer. Chart- und Verlaufstools liefern etwa 100 Zeilen pro Aufruf, der Minutenchart bis zu 30 Kerzen: Für ältere Daten rufst du sie erneut mit einem früheren Enddatum oder einer früheren Uhrzeit auf.

Codes: Koreanische Aktien, ETFs und ETNs nutzen den sechsstelligen Kurzcode (005930 Samsung Electronics, 000660 SK hynix, 035420 NAVER, 069500 KODEX 200); ETNs bekommen ein Q davor. Kurse kommen standardmäßig von der KRX; Nextrade (NXT) oder beide zusammen gibt es auf Wunsch. Koreanische Indizes haben vier Ziffern: 0001 KOSPI, 1001 KOSDAQ, 2001 KOSPI 200. Ausländische Aktien brauchen einen Börsencode und einen Ticker, z. B. NAS + AAPL, NYS + KO, TSE + 7203, HKS + 00700. Die Codes für ausländische Indizes, Wechselkurse, Anleihen und Gold (etwa SPX oder .DJI) stehen in der Stammdatei für Auslandsindizes von KIS.

Datum, Uhrzeit und Preise: Datumsangaben sind YYYYMMDD, Uhrzeiten HHMMSS, beide in koreanischer Zeit (KST, UTC+9). Koreanische Preise sind in KRW, ausländische in der jeweiligen Landeswährung. KIS antwortet mit koreanischen Feldkürzeln wie stck_prpr (aktueller Kurs), prdy_vrss (Veränderung zum Vortagesschluss), prdy_ctrt (Veränderung in Prozent) und acml_vol (Volumen).

US-Kurse können verzögert sein: Echtzeitkurse aus den USA brauchen ein separates Abo in der KIS-App. Ohne Abo sind US-Kurse verzögert.

Häufige Fehler: Jede Antwort enthält rt_cd (0 heißt Erfolg) sowie msg_cd und msg1, die sagen, was schiefging. Ein abgelehnter App Key oder ein abgelehntes App Secret (401) heißt meist, dass ein Key unvollständig kopiert wurde oder zu einem Konto für den Simulationshandel gehört. Ein 403 heißt, dass der Open-API-Dienst für das Konto nicht aktiv ist, der App Key neu ausgestellt wurde oder ein Token weniger als eine Minute nach dem letzten angefragt wurde: Warte eine Minute und versuch es dann erneut. Ist openapi.koreainvestment.com:9443 nicht erreichbar, sind ausgehende Verbindungen zu Port 9443 blockiert.

Was der Connector liest: aktuelle Kurse koreanischer Aktien, ETFs und ETNs mit Veränderung, Volumen, Umsatz, Preisgrenzen, 52-Wochen-Spanne, KGV (PER), KBV (PBR), EPS, BPS, Marktkapitalisierung und Ausländeranteil; Tages-, Wochen-, Monats- und Jahreskerzen sowie die Minutenkerzen des aktuellen Handelstags; Time and Sales; das Orderbuch mit zehn Stufen und den erwarteten Auktionspreisen; Nettokäufe von Privatanlegern, ausländischen Investoren und Institutionen; Stammdaten koreanischer börsennotierter Produkte; Stand und Verlauf von KOSPI, KOSDAQ, KOSPI 200 und Sektorindizes; Kurse, Detailkurse, Verlauf, Orderbücher und Stammdaten von Aktien aus den USA, Japan, Hongkong, China und Vietnam; Kerzen ausländischer Indizes, Wechselkurse, Staatsanleihen und Gold-Futures.

Nur Lesezugriff: Alle 16 Tools lesen nur Marktdaten, deshalb ist bei der Installation keines deaktiviert. Marktdaten dienen nur der Information und sind keine Anlageberatung.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Korea Investment & Securities.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

Beispiel-Prompts

• „Wie steht Samsung Electronics (005930) gerade, und wie hoch sind KGV, KBV und Ausländeranteil?“
• „Zeig mir die Tageskerzen von SK hynix der letzten drei Monate und den höchsten Schlusskurs in diesem Zeitraum.“
• „Haben ausländische Investoren oder Institutionen NAVER in den letzten Handelstagen netto gekauft?“
• „Wo stehen KOSPI und KOSDAQ heute, und wie viele KOSPI-Werte steigen und wie viele fallen?“
• „Vergleiche Apple und Toyota: letzter Kurs, heutige Veränderung sowie 52-Wochen-Hoch und -Tief.“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden