Conectar Korea Investment MCP con Claude

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Korea Investment & Securities, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Korea Investment & Securities + Claude

Lee datos de mercado coreanos y extranjeros de la KIS Developers Open API de Korea Investment & Securities: cotizaciones de acciones y ETF, gráficos diarios y por minuto, libros de órdenes, flujos por tipo de inversor, los índices KOSPI y KOSDAQ y precios de acciones de EE. UU., Japón, Hong Kong y China. Solo lectura, sin operar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

KIS_APP_KEY, KIS_APP_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos minutos. Necesitas una cuenta de valores en Korea Investment & Securities (한국투자증권) y, para esa cuenta, el servicio Open API de KIS Developers, que te da una App Key y un App Secret.

Solo datos de mercado: el conector lee cotizaciones, gráficos, libros de órdenes, flujos por tipo de inversor, índices y datos maestros. No puede enviar, modificar ni cancelar órdenes, y no lee saldos, posiciones ni depósitos de la cuenta. Tampoco cubre el streaming por WebSocket, futuros y opciones ni la negociación de bonos.

1. Solicita el servicio Open API en apiportal.koreainvestment.com (KIS Developers, API 신청) y elige tu cuenta para operativa real (실전투자).
2. Copia la App Key en KIS_APP_KEY y el App Secret, que aparece a su lado, en KIS_APP_SECRET. La App Key tiene de 20 a 64 letras y dígitos; el App Secret es una cadena larga, de unos 180 caracteres: pégalo entero, sin espacios ni saltos de línea.
3. Instala el conector. Comprueba la conexión con korea_investment_get_stock_price y el código 005930 (Samsung Electronics).

Solo claves de operativa real: las claves de operativa simulada (모의투자) solo funcionan en el host aparte de KIS openapivts.koreainvestment.com:29443, que este conector no usa. Leer cotizaciones con claves reales no ejecuta ninguna operación.

Tokens: el conector cambia la App Key y el App Secret por un token de acceso (POST /oauth2/tokenP) y lo envía en cada llamada, junto con las cabeceras que exige KIS. Un token de KIS dura 24 horas y KIS permite alrededor de una solicitud de token por minuto; pedirlo de nuevo antes de 6 horas devuelve el mismo token, y KIS puede enviar un aviso por KakaoTalk con cada token nuevo. El conector guarda el token y solo pide uno nuevo poco antes de que caduque.

Cloud y self-hosted funcionan igual: ambos usan tu propia App Key y tu App Secret. Un servidor propio debe poder abrir conexiones salientes a openapi.koreainvestment.com en el puerto 9443.

Límites de peticiones y paginación: con claves reales, KIS permite unas 20 llamadas por segundo por cuenta; EGW00201 significa demasiadas llamadas: ve más despacio. Las herramientas de gráficos e historial devuelven unas 100 filas por llamada, y el gráfico por minuto hasta 30 barras: para datos más antiguos, vuelve a llamarlas con una fecha u hora final anterior.

Códigos: las acciones, ETF y ETN coreanos usan el código corto de seis dígitos (005930 Samsung Electronics, 000660 SK hynix, 035420 NAVER, 069500 KODEX 200); los ETN llevan una Q delante. Las cotizaciones vienen de KRX por defecto; de Nextrade (NXT) o de ambos combinados si lo pides. Los índices coreanos tienen cuatro dígitos: 0001 KOSPI, 1001 KOSDAQ, 2001 KOSPI 200. Las acciones extranjeras necesitan un código de bolsa y un ticker, por ejemplo NAS + AAPL, NYS + KO, TSE + 7203, HKS + 00700. Los códigos de índices extranjeros, tipos de cambio, bonos y oro (como SPX o .DJI) están en el archivo maestro de índices extranjeros de KIS.

Fechas, horas y precios: las fechas son YYYYMMDD y las horas HHMMSS, ambas en hora de Corea (KST, UTC+9). Los precios coreanos están en KRW y los extranjeros en la moneda local. KIS responde con abreviaturas coreanas de los campos, como stck_prpr (precio actual), prdy_vrss (variación frente al cierre anterior), prdy_ctrt (variación en porcentaje) y acml_vol (volumen).

Las cotizaciones de EE. UU. pueden llegar con retraso: los precios de EE. UU. en tiempo real requieren una suscripción aparte en la app de KIS. Sin ella, los precios de EE. UU. llegan con retraso.

Errores frecuentes: cada respuesta trae rt_cd (0 significa éxito) con msg_cd y msg1, que indican qué falló. Una App Key o un App Secret rechazados (401) suelen significar que una clave se copió incompleta o pertenece a una cuenta de operativa simulada. Un 403 significa que el servicio Open API no está activo para la cuenta, que la App Key se ha vuelto a emitir o que se pidió un token menos de un minuto después del anterior: espera un minuto y vuelve a intentarlo. Si no se puede llegar a openapi.koreainvestment.com:9443, las conexiones salientes al puerto 9443 están bloqueadas.

Qué lee: cotizaciones actuales de acciones, ETF y ETN coreanos con variación, volumen, importe negociado, límites de precio, rango de 52 semanas, PER, PBR, EPS, BPS, capitalización bursátil y participación extranjera; velas diarias, semanales, mensuales y anuales y las barras por minuto del día; time and sales; el libro de órdenes de diez niveles con los precios de subasta previstos; compras netas de particulares, extranjeros e institucionales; datos maestros de productos cotizados en Corea; nivel e historial de KOSPI, KOSDAQ, KOSPI 200 e índices sectoriales; cotizaciones, cotizaciones detalladas, historial, libros de órdenes y datos maestros de acciones de EE. UU., Japón, Hong Kong, China y Vietnam; velas de índices extranjeros, tipos de cambio, bonos del Estado y futuros del oro.

Solo lectura: las 16 herramientas solo leen datos de mercado, así que ninguna está desactivada al instalar. Los datos de mercado son solo informativos y no constituyen asesoramiento de inversión.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Claude

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Korea Investment & Securities, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

Herramientas disponibles

Ejemplos de prompts

• "¿Cómo cotiza ahora Samsung Electronics (005930) y cuáles son su PER, su PBR y la participación extranjera?"
• "Muéstrame las velas diarias de SK hynix de los últimos tres meses y el cierre más alto del periodo."
• "¿Han sido compradores netos de NAVER los extranjeros o los institucionales en las últimas sesiones?"
• "¿Dónde están hoy el KOSPI y el KOSDAQ, y cuántos valores del KOSPI suben y cuántos bajan?"
• "Compara Apple y Toyota: último precio, variación de hoy y máximo y mínimo de 52 semanas."

FAQ

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot