Collegare Korea Investment MCP a Claude

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Korea Investment & Securities, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Korea Investment & Securities + Claude

Leggi i dati di mercato coreani ed esteri dalla KIS Developers Open API di Korea Investment & Securities: quotazioni di azioni ed ETF, grafici giornalieri e al minuto, book di negoziazione, flussi per tipo di investitore, gli indici KOSPI e KOSDAQ e i prezzi di azioni statunitensi, giapponesi, di Hong Kong e cinesi. Sola lettura, nessuna operatività.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

KIS_APP_KEY, KIS_APP_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede pochi minuti. Ti servono un conto titoli presso Korea Investment & Securities (한국투자증권) e, per quel conto, il servizio Open API di KIS Developers, che ti fornisce un App Key e un App Secret.

Solo dati di mercato: il connettore legge quotazioni, grafici, book di negoziazione, flussi per tipo di investitore, indici e anagrafiche. Non può inserire, modificare o annullare ordini e non legge saldi, posizioni o depositi del conto. Non copre nemmeno lo streaming WebSocket, futures e opzioni e la negoziazione di obbligazioni.

1. Richiedi il servizio Open API su apiportal.koreainvestment.com (KIS Developers, API 신청) e scegli il tuo conto per il trading reale (실전투자).
2. Copia l'App Key in KIS_APP_KEY e l'App Secret, mostrato accanto, in KIS_APP_SECRET. L'App Key è composto da 20 a 64 lettere e cifre; l'App Secret è una stringa lunga, di circa 180 caratteri: incollalo per intero, senza spazi né a capo.
3. Installa il connettore. Verifica la connessione con korea_investment_get_stock_price e il codice 005930 (Samsung Electronics).

Solo chiavi per il trading reale: le chiavi del trading simulato (모의투자) funzionano solo sull'host separato di KIS openapivts.koreainvestment.com:29443, che questo connettore non usa. Leggere quotazioni con chiavi reali non esegue alcuna operazione.

Token: il connettore scambia App Key e App Secret con un token di accesso (POST /oauth2/tokenP) e lo invia a ogni chiamata, insieme agli header richiesti da KIS. Un token KIS dura 24 ore e KIS consente circa una richiesta di token al minuto; una nuova richiesta entro 6 ore restituisce lo stesso token, e KIS può inviare un avviso su KakaoTalk per ogni nuovo token. Il connettore conserva il token e ne chiede uno nuovo solo poco prima della scadenza.

Cloud e self-hosting funzionano allo stesso modo: entrambi usano il tuo App Key e il tuo App Secret. Un server self-hosted deve poter aprire connessioni in uscita verso openapi.koreainvestment.com sulla porta 9443.

Limiti di richieste e paginazione: con chiavi reali KIS consente circa 20 chiamate al secondo per conto; EGW00201 vuol dire troppe chiamate: rallenta. I tool di grafici e storico restituiscono circa 100 righe per chiamata, il grafico al minuto fino a 30 barre: per dati più vecchi richiamali con una data o un orario di fine precedente.

Codici: azioni, ETF ed ETN coreani usano il codice breve a sei cifre (005930 Samsung Electronics, 000660 SK hynix, 035420 NAVER, 069500 KODEX 200); gli ETN hanno una Q davanti. Le quotazioni arrivano da KRX per impostazione predefinita; su richiesta da Nextrade (NXT) o da entrambi combinati. Gli indici coreani hanno quattro cifre: 0001 KOSPI, 1001 KOSDAQ, 2001 KOSPI 200. Le azioni estere richiedono un codice di borsa e un ticker, ad esempio NAS + AAPL, NYS + KO, TSE + 7203, HKS + 00700. I codici di indici esteri, tassi di cambio, obbligazioni e oro (come SPX o .DJI) sono nel file anagrafico degli indici esteri di KIS.

Date, orari e prezzi: le date sono YYYYMMDD e gli orari HHMMSS, entrambi in ora coreana (KST, UTC+9). I prezzi coreani sono in KRW, quelli esteri nella valuta locale. KIS risponde con abbreviazioni coreane dei campi, come stck_prpr (prezzo attuale), prdy_vrss (variazione rispetto alla chiusura precedente), prdy_ctrt (variazione percentuale) e acml_vol (volume).

Le quotazioni USA possono essere ritardate: i prezzi USA in tempo reale richiedono un abbonamento separato nell'app KIS. Senza, i prezzi USA sono ritardati.

Errori frequenti: ogni risposta contiene rt_cd (0 vuol dire successo) con msg_cd e msg1, che dicono cosa non ha funzionato. Un App Key o App Secret rifiutato (401) di solito vuol dire che una chiave è stata copiata in modo incompleto o appartiene a un conto di trading simulato. Un 403 vuol dire che il servizio Open API non è attivo per il conto, che l'App Key è stato riemesso o che un token è stato richiesto meno di un minuto dopo il precedente: aspetta un minuto e riprova. Se openapi.koreainvestment.com:9443 non è raggiungibile, le connessioni in uscita verso la porta 9443 sono bloccate.

Cosa legge: quotazioni attuali di azioni, ETF ed ETN coreani con variazione, volume, controvalore, limiti di prezzo, intervallo a 52 settimane, PER, PBR, EPS, BPS, capitalizzazione e quota detenuta da stranieri; candele giornaliere, settimanali, mensili e annuali e le barre al minuto della giornata; time and sales; il book a dieci livelli con i prezzi d'asta previsti; acquisti netti di privati, investitori esteri e istituzionali; anagrafiche dei prodotti quotati in Corea; livello e storico di KOSPI, KOSDAQ, KOSPI 200 e indici settoriali; quotazioni, quotazioni dettagliate, storico, book e anagrafiche di azioni di Stati Uniti, Giappone, Hong Kong, Cina e Vietnam; candele di indici esteri, tassi di cambio, titoli di Stato e future sull'oro.

Sola lettura: tutti i 16 tool leggono solo dati di mercato, quindi nessuno è disattivato all'installazione. I dati di mercato hanno solo scopo informativo e non sono una consulenza sugli investimenti.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Korea Investment & Securities, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Come sta andando Samsung Electronics (005930) adesso, e quali sono PER, PBR e quota detenuta da stranieri?"
• "Mostrami le candele giornaliere di SK hynix degli ultimi tre mesi e la chiusura più alta del periodo."
• "Negli ultimi giorni di borsa gli investitori esteri o gli istituzionali sono stati acquirenti netti di NAVER?"
• "A che livello sono KOSPI e KOSDAQ oggi, e quanti titoli del KOSPI salgono e quanti scendono?"
• "Confronta Apple e Toyota: ultimo prezzo, variazione di oggi e massimo e minimo a 52 settimane."

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot