Twelve Data

MCP-сервер Twelve Data

Подключите Claude, ChatGPT и других ИИ-ассистентов к финансовому API Twelve Data — котировки в реальном времени и исторические данные, 60+ технических индикаторов, фундаментальные показатели, отчёты о прибыли, дивиденды, ETF, корпоративные новости, лидеры рынка и многое другое.

Вам понадобится учётная запись Twelve Data. Зарегистрируйтесь на twelvedata.com.

Есть два способа использования. Большинству пользователей подойдёт облачный сервер (Вариант 1) — ничего устанавливать не нужно.

---

Вариант 1 — Используйте наш облачный сервер (рекомендуется)

Подключите вашего ИИ-ассистента к нашему размещённому серверу:

https://mcp.twelvedata.com/mcp

Вот и всё. Никакой установки, никаких ключей API для копирования и вставки. При подключении откроется окно браузера, и вы войдёте в свою учётную запись Twelve Data — ваш личный ключ API привяжется автоматически и останется связанным с вашей учётной записью.

Как добавить

Claude (Desktop / Web) и ChatGPT поддерживают пользовательские коннекторы / MCP-серверы:

1. Откройте настройки Connectors (или Integrations / MCP servers) вашего ассистента.
2. Добавьте новый коннектор с URL https://mcp.twelvedata.com/mcp.
3. При появлении запроса нажмите Connect / Log in — в браузере откроется страница входа Twelve Data.
4. Авторизуйтесь — и готово. Задавайте вопросы вроде «Какой RSI у AAPL?» или «Покажи последние отчёты о прибыли TSLA».

Точные названия пунктов меню различаются в зависимости от приложения и версии, но порядок действий всегда одинаков: добавьте URL, затем войдите через всплывающее окно браузера.

MCP-хост не выдаёт токены. URL коннектора — https://mcp.twelvedata.com/mcp. Клиент должен следовать метаданным защищённого ресурса по этому URL к серверу авторизации, указанному там. Не указывайте коннектор на корень хоста (он отвечает 404) или на /register или /.well-known/oauth-authorization-server этого хоста.

Perplexity (пользовательский удалённый коннектор)

Пользователи Perplexity Pro, Max и Enterprise могут добавить размещённый сервер как пользовательский удалённый коннектор. Это настройка для каждой учётной записи, а не размещение в публичном курируемом каталоге Perplexity.

1. В Perplexity откройте Account settings → Connectors → + Custom connector и выберите Remote. В Enterprise администратору может потребоваться сначала разрешить пользовательские коннекторы.
2. Установите Name в Twelve Data и MCP Server URL в https://mcp.twelvedata.com/mcp.
3. Выберите OAuth для аутентификации и Streamable HTTP для транспорта. Оставьте Client ID и Client Secret пустыми, чтобы Perplexity могла использовать динамическую регистрацию клиента на сервере авторизации, указанном в метаданных защищённого ресурса сервера.
4. Примите подтверждение пользовательского коннектора Perplexity и нажмите Add. Затем нажмите на карточку коннектора Twelve Data, чтобы начать аутентификацию, войдите в свою учётную запись Twelve Data и авторизуйте доступ.
5. После включения коннектора попробуйте такие запросы:
   • "Use Twelve Data to find the AAPL symbol."
   • "Use Twelve Data to get the latest quote for AAPL, including price and volume."
   • "Use Twelve Data to show the last five daily closing prices for AAPL."
   • "Use Twelve Data to show AAPL RSI."

Каждый пользователь входит в свою собственную учётную запись Twelve Data. Если администратор Enterprise делится коннектором, требуйте индивидуальную аутентификацию для каждого участника. Не вставляйте ключ API Twelve Data в поле аутентификации API Key коннектора.

Если окно OAuth заблокировано, вход не удаётся или инструменты перестают работать после простоя, откройте коннектор Twelve Data, отключите его, включите снова и войдите. Переподключайтесь таким образом, а не переключайте коннектор на аутентификацию API Key. Убедитесь, что URL точно https://mcp.twelvedata.com/mcp без завершающего слэша и что тарифный план Twelve Data включает запрашиваемые данные. См. руководство Perplexity по пользовательским удалённым коннекторам для актуальных экранов настроек.

Codex (CLI, desktop и IDE)

Добавьте размещённый MCP-сервер в Codex без установки этого репозитория или копирования ключа API:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

Команда add запускает OAuth: завершите вход в Twelve Data в браузере. Если позже потребуется авторизоваться снова, выполните codex mcp login twelvedata. В Codex используйте /mcp для проверки подключения, затем спросите: "Use Twelve Data to get the latest quote for AAPL." и "Use Twelve Data to show AAPL RSI." Для отключения выполните codex mcp remove twelvedata.

Публичный репозиторий плагинов — https://github.com/MazeBraker/twelvedata-skills. Он устанавливает навыки и тот же размещённый MCP:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Вариант 2 — Запустите самостоятельно с ключом API

Предпочитаете запускать сервер на своей машине? Вам понадобится только ключ API Twelve Data — никакой настройки OAuth. Получите его на twelvedata.com → ваша панель управления → API Keys.

1. Установка

Требуется Python 3.10+ (рекомендуется 3.12; на macOS brew install python@3.12 или make python-install).

make install

2. Добавьте ключ API

Создайте файл .env в корне проекта с вашим ключом, доступный только вам:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

Сервер читает ключ из .env, и каждый запрос использует его. Шаг входа не нужен.

3. Подключение через stdio

Claude Desktop — добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

Используйте путь .venv/bin/python (не системный Python — в macOS поставляется 3.9, а этому серверу нужен 3.10+). Перезапустите Claude Desktop после редактирования конфигурации.

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. Подключение через HTTP

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Запуск в Docker

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file не позволяет ключу попасть в историю вашей оболочки. Подключайтесь к http://localhost:8000/mcp как в шаге 4. Вход через OAuth в Docker не поддерживается.

6. Безопасность

• make run и Docker обслуживают /mcp без аутентификации, на 0.0.0.0 по умолчанию.
• Каждый вызов обслуживается под вашими учётными данными.
• Любой, кто получит доступ к порту, может вызывать auth_status и oauth_configure. Это включает веб-страницу, которую вы открываете, через DNS rebinding, поскольку привязка по умолчанию не проверяет ни заголовок Host, ни Origin.
• MCP_HOST=127.0.0.1 make run оставляет сервер локальным и включает проверку Host и Origin в MCP SDK.
• С MCP_HOST=127.0.0.1 ngrok работает только при запуске с --host-header=rewrite.

7. Устранение неполадок

Сначала вызовите auth_status из вашего клиента. Он показывает, настроен ли ключ API, сохранённый токен, обнаруженный хост и URI перенаправления — обычно этого достаточно, чтобы понять, чего не хватает.

---

Что можно спрашивать

• Цены — акции, ETF, форекс, криптовалюты, сырьевые товары (в реальном времени и исторические)
• Технические индикаторы — RSI, MACD, SMA, BBANDS, ATR и ещё 60+
• Фундаментальные показатели — финансовая отчётность, прибыль, дивиденды, сплиты, профили компаний, рыночная капитализация, ключевые показатели, календарь IPO
• Фонды — профили ETF и взаимных фондов, доходность, портфели, риски
• Новости — корпоративные новости и пресс-релизы
• Рыночная аналитика — лидеры рынка, обменные курсы, рейтинги аналитиков, целевые цены
• Регуляторная информация — отчётность SEC/EDGAR, инсайдерские сделки, институциональные доли

Форматы символов: акции AAPL, криптовалюты BTC/USD, форекс EUR/USD.

---

Партнёры

Запускаете собственный публичный экземпляр или настраиваете выделенный вход OAuth? Это партнёрское соглашение — свяжитесь с нами на twelvedata.com, и мы предоставим руководство по настройке и учётные данные OAuth.