Korea Investment MCP: подключение к Microsoft Copilot

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Korea Investment & Securities, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Korea Investment & Securities + Microsoft Copilot

Читайте корейские и зарубежные рыночные данные из KIS Developers Open API компании Korea Investment & Securities: котировки акций и ETF, дневные и минутные графики, стаканы заявок, потоки по типам инвесторов, индексы KOSPI и KOSDAQ, а также цены акций США, Японии, Гонконга и Китая. Только чтение, без торговли.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

KIS_APP_KEY, KIS_APP_SECRET

Шаг 1 — Получите учётные данные

Настройка занимает несколько минут. Нужны брокерский счёт в Korea Investment & Securities (한국투자증권) и подключённая для этого счёта услуга Open API на KIS Developers, которая выдаёт App Key и App Secret.

Только рыночные данные: коннектор читает котировки, графики, стаканы, потоки по типам инвесторов, индексы и справочные данные. Он не может выставлять, изменять или отменять заявки и не читает остатки по счёту, позиции и депозиты. Потоковые данные через WebSocket, фьючерсы и опционы, а также торговля облигациями тоже не поддерживаются.

1. Подайте заявку на услугу Open API на apiportal.koreainvestment.com (KIS Developers, API 신청) и выберите свой счёт для реальной торговли (실전투자).
2. Скопируйте App Key в KIS_APP_KEY, а App Secret, который показан рядом, — в KIS_APP_SECRET. App Key состоит из 20–64 латинских букв и цифр; App Secret — длинная строка примерно из 180 символов: вставьте её целиком, без пробелов и переносов строк.
3. Установите коннектор. Проверьте подключение через korea_investment_get_stock_price с кодом 005930 (Samsung Electronics).

Только ключи для реальной торговли: ключи для учебной торговли (모의투자) работают только на отдельном хосте KIS openapivts.koreainvestment.com:29443, который этот коннектор не использует. Чтение котировок с ключами для реальной торговли не совершает сделок.

Токены: коннектор обменивает App Key и App Secret на access token (POST /oauth2/tokenP) и передаёт его в каждом вызове вместе с заголовками, которые требует KIS. Токен KIS действует 24 часа, а запрашивать токен можно примерно раз в минуту; повторный запрос в течение 6 часов возвращает тот же токен, и при каждом новом токене KIS может прислать уведомление в KakaoTalk. Коннектор хранит токен и запрашивает новый только незадолго до истечения срока.

Cloud и self-hosting работают одинаково: в обоих случаях используются ваши App Key и App Secret. Собственному серверу нужно разрешить исходящие подключения к openapi.koreainvestment.com на порт 9443.

Лимиты запросов и страницы: с ключами для реальной торговли KIS допускает около 20 вызовов в секунду на счёт; EGW00201 означает слишком много вызовов: снизьте темп. Инструменты графиков и истории возвращают около 100 строк за вызов, минутный график — до 30 свечей: для более старых данных вызовите их снова с более ранней конечной датой или временем.

Коды: корейские акции, ETF и ETN обозначаются шестизначным кратким кодом (005930 Samsung Electronics, 000660 SK hynix, 035420 NAVER, 069500 KODEX 200); перед кодом ETN ставится Q. По умолчанию котировки берутся с KRX; по запросу — с Nextrade (NXT) или с обеих площадок вместе. Корейские индексы имеют четыре цифры: 0001 KOSPI, 1001 KOSDAQ, 2001 KOSPI 200. Для зарубежных акций нужны код биржи и тикер, например NAS + AAPL, NYS + KO, TSE + 7203, HKS + 00700. Коды зарубежных индексов, валютных курсов, облигаций и золота (например, SPX или .DJI) есть в мастер-файле зарубежных индексов KIS.

Даты, время и цены: даты указываются как YYYYMMDD, время — как HHMMSS, оба по корейскому времени (KST, UTC+9). Корейские цены — в KRW, зарубежные — в местной валюте. KIS отвечает корейскими сокращениями полей, например stck_prpr (текущая цена), prdy_vrss (изменение к предыдущему закрытию), prdy_ctrt (изменение в процентах) и acml_vol (объём).

Котировки США могут быть с задержкой: для котировок США в реальном времени нужна отдельная подписка в приложении KIS. Без неё цены США приходят с задержкой.

Частые ошибки: в каждом ответе есть rt_cd (0 — успех), а также msg_cd и msg1, которые объясняют, что пошло не так. Отклонённые App Key или App Secret (401) обычно означают, что ключ скопирован не полностью или относится к счёту для учебной торговли. 403 означает, что услуга Open API для счёта не активна, App Key был перевыпущен или токен запрошен меньше чем через минуту после предыдущего: подождите минуту и повторите. Если openapi.koreainvestment.com:9443 недоступен, исходящие подключения к порту 9443 заблокированы.

Что читает коннектор: текущие котировки корейских акций, ETF и ETN с изменением, объёмом, оборотом, ценовыми лимитами, диапазоном за 52 недели, PER, PBR, EPS, BPS, рыночной капитализацией и долей иностранных владельцев; дневные, недельные, месячные и годовые свечи и минутные свечи текущего дня; ленту сделок; стакан на десять уровней с ожидаемыми ценами аукциона; чистые покупки частных, иностранных и институциональных инвесторов; справочные данные корейских биржевых инструментов; значение и историю KOSPI, KOSDAQ, KOSPI 200 и отраслевых индексов; котировки, подробные котировки, историю, стаканы и справочные данные акций США, Японии, Гонконга, Китая и Вьетнама; свечи зарубежных индексов, валютных курсов, государственных облигаций и фьючерсов на золото.

Только чтение: все 16 инструментов только читают рыночные данные, поэтому при установке ни один не отключён. Рыночные данные носят только информационный характер и не являются инвестиционной рекомендацией.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Microsoft Copilot

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Korea Investment & Securities.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Как сейчас торгуется Samsung Electronics (005930) и какие у неё PER, PBR и доля иностранных владельцев?»
• «Покажите дневные свечи SK hynix за последние три месяца и самое высокое закрытие за этот период.»
• «Были ли иностранцы или институционалы чистыми покупателями NAVER в последние торговые дни?»
• «Где сегодня KOSPI и KOSDAQ и сколько акций KOSPI растёт, а сколько падает?»
• «Сравните Apple и Toyota: последняя цена, изменение за сегодня, максимум и минимум за 52 недели.»

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

Следующие шаги

• Страница коннектора
• Подключить к Claude