Использование MetalAPI с ИИ-ассистентами (MCP)

Что делает MCP-сервер

MetalAPI предоставляет сервер Model Context Protocol по адресу https://metalapi.com/mcp. После подключения ваш ассистент может узнавать текущие и исторические цены, конвертировать суммы, строить графики временных рядов и проверять ваш тариф и расход запросов — прямо в чате.

Подключиться можно двумя способами:

• Вход в аккаунт (OAuth): Claude, ChatGPT и другие приложения, поддерживающие пользовательские коннекторы. Вы входите в MetalAPI (или создаёте бесплатный аккаунт) и подтверждаете подключение.
• Ключ API: Claude Code, Cursor, VS Code и любой клиент, который умеет передавать заголовок. Используйте ключ из личного кабинета.

Claude (claude.ai и Claude Desktop)

1. Откройте Settings → Connectors и выберите Add custom connector.
2. Назовите его MetalAPI и укажите URL https://metalapi.com/mcp.
3. Нажмите Connect, войдите в MetalAPI и нажмите Allow.

Затем задайте вопрос, например: «Сколько сегодня стоит грамм золота в евро?»

ChatGPT

В разделе Settings → Apps & Connectors создайте коннектор (в режиме разработчика) с URL https://metalapi.com/mcp и аутентификацией OAuth. ChatGPT откроет страницу входа MetalAPI; подтвердите подключение, и инструменты будут готовы к работе.

Claude Code

Добавьте сервер с вашим ключом API:

claude mcp add --transport http metalapi https://metalapi.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

# Или войдите в аккаунт вместо ключа: добавьте сервер без --header, затем выполните /mcp в Claude Code.

Cursor

Добавьте MetalAPI в ~/.cursor/mcp.json (или в .cursor/mcp.json в проекте):

{
  "mcpServers": {
    "metalapi": {
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (GitHub Copilot)

Создайте .vscode/mcp.json; VS Code один раз запросит ключ и надёжно его сохранит:

{
  "inputs": [
    { "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
  ],
  "servers": {
    "metalapi": {
      "type": "http",
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:metalapi-key}" }
    }
  }
}

Инструменты

• get_latest_prices, get_historical_prices, convert, get_timeseries, get_fluctuation, get_ohlc, get_carat_prices: рыночные данные. Каждый вызов засчитывается как один запрос в рамках вашего тарифа — точно так же, как в REST API, — а свежесть данных соответствует вашему тарифу.
• list_symbols, get_account, list_plans, list_api_keys: бесплатно.
• get_upgrade_link: защищённая ссылка на оплату через Stripe для перехода на старший тариф. Ассистент может подготовить её, но оплатить можете только вы.
• create_api_key: создаёт ключ для ваших собственных приложений (только при подключении через вход в аккаунт).

Для ИИ-ассистентов программирования

Создаёте интеграцию с помощью ИИ-инструмента для программирования? Передайте ему llms.txt, полный llms-full.txt или спецификацию OpenAPI: в них описаны все эндпоинты, параметры и ответы.

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

Подключения, созданные через вход в аккаунт, перечислены в разделе Settings → Connected apps вашего личного кабинета, где их можно отключить в любой момент. Ключи API можно перевыпустить или отозвать в разделе API keys; ключ в MCP-конфигурации так же конфиденциален, как ключ в вашем коде.