Korea Investment MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Korea Investment & Securities-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden