Conectar Korea Investment MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

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

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Korea Investment & Securities.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude