# FlashData MCP

Предоставьте вашему агенту инструменты Google Search и YouTube. Подключите хост, а затем попросите свой первый результат.

Каноническая ссылка: https://flashdata.dev/ru/docs/integrations/mcp-clients
Разработчик: 2026-11-05 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Официальный сервер MCP
- [Ссылка на MCP](https://flashdata.dev/ru/docs/mcp/reference.md) — Инструменты, параметры и ответы
- [Получите API-ключ](https://flashdata.dev/app/api-keys) — Для хостов, которые используют аутентификацию заголовка

<a id="connect"></a>

## 1. Подключайся и входи

Выберите Codex или OpenClaw для браузера OAuth. Для другого хоста выберите клавишу Remote / API, если она поддерживает потоковые HTTP и пользовательские заголовки, или Local / stdio, если она запускает процессы MCP. Размещенный сервер не нуждается в локальной установке.

### Codex

Слить конфигурацию ниже в ~/.codex/config.toml, затем запустить команду входа. Заполните FlashData регистрацию или вход и согласие в браузере. Начните новый сеанс Codex после входа в систему.

#### config.toml

```toml
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"

[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"
```

#### Войти

```bash
codex mcp login flashdata --scopes mcp:research
```


### OpenClaw

Запустите эти команды в профиле OpenClaw, который использует ваш агент. Заполните регистрацию или вход и согласие в браузере, а затем начните новый сеанс. Врач проверяет сохраненное соединение.

#### Настройка, вход и проверка · Bash / PowerShell 7

```bash
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


### Удаленный ключ / API

Создайте ключ с разрешением Google Search или повторно используйте его. Добавьте сервер в настройки MCP вашего хоста, используя поля ниже. Поместите ключ в защищенное поле заголовка и переподключитесь; команда OAuth не требуется.

#### Настройка MCP

```text
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEY
```

- [Создайте ключ API](https://flashdata.dev/app/api-keys)

### Местный / stdio

Требуется Node.js 22.18+ и ключ API с разрешением Google Search. Слить это в хост, который поддерживает mcpServers JSON. Замените YOUR_API_KEY в локальной защищенной конфигурации, затем перезапустите хост. Используйте npx.cmd на Windows, если хосту требуется исполняемое имя файла.

Пакет npm работает на локальном сервере MCP. Автономный FlashData CLI представляет собой отдельный исполняемый файл.

#### Конфигурация MCP

```json
{
  "mcpServers": {
    "flashdata": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=@flashdata-dev/mcp@0.2.0",
        "flashdata-mcp"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

- [Создайте ключ API](https://flashdata.dev/app/api-keys)
- [Локальная серверная документация](https://github.com/flashdatadev/flashdata-mcp)


<a id="sign-in"></a>

## 2. Проверьте соединение

Отправьте это на новый сеанс агента. Ожидайте успешных звонков get_pricing и get_balance, доступной цены на google_search и доступного кредитного баланса. Нулевой баланс означает, что вам нужны кредиты для поиска; это не означает, что аутентификация не удалась.

### Проверка соединения

```text
Используйте существующее соединение флэш-данных MCP.
Звоните get_pricing с {"source":"google_search","request_count":1}.
Звоните get_balance с {}.
Сообщите, удалось ли сделать оба звонка, есть ли у источника доступная цена.
и доступного кредитного баланса. Нулевой баланс не является ошибкой аутентификации.
Не запускайте поиск или загрузку, не создавайте пробную версию или не меняйте учетные данные.
```


<a id="task"></a>

## 3. Попросите свою первую задачу

Вставьте это в своего агента. Проверки баланса и ценообразования бесплатны; поиск использует кредиты на счетах.

### Первая задача быстро

```text
Используйте FlashData для проверки моего баланса и цены одного поиска Google. Если кредитов достаточно, звоните google_search один раз с запросом "battery recycling research", num 5 и режимом "realtime". Возврат заголовков, источник URLs, короткие выдержки и фактические кредиты. Остановитесь после этой задачи.
```


<a id="result"></a>

### Проверьте результат

Ваш агент должен вернуть исходные ссылки и выдержки, а также фактические использованные кредиты. Базовый результат поиска имеет status: done и results[].organic.. Пустой результат действителен; агент должен сообщить об этом. Приведенный ниже пример является иллюстративным.

#### Пример ответа

```text
Завершен один поиск Google.
1. Исследование утилизации аккумуляторов — https://example.org/recycling
   Пример поисковой выдержки.
Используемые кредиты: 0.02
```


<a id="tools"></a>

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

Звонки API-ключа используют разрешения, предоставленные этому ключу. Откройте инструменты сервера и схемы ввода для полного текущего каталога.

| Задание | Инструмент | Доступ |
| --- | --- | --- |
| Поиск по Google | google_search | mcp:research / API key |
| Найти видео YouTube | youtube_search | mcp:research / API key |
| Читать видео метаданные | youtube_metadata | mcp:research / API key |
| Восстановление существующих подписей | youtube_transcript | mcp:research / API key |
| Скачать видео или аудио | youtube_download | Владелец ключа API + хранилище назначения |
| Проверить счет и цены | get_balance, get_pricing, get_limits, get_usage | Бесплатный аккаунт читать |

- [Все инструменты и параметры](https://flashdata.dev/ru/docs/mcp/reference.md#parameters)
- [Скачать Setup](https://flashdata.dev/ru/docs/guides/youtube-download-guide/reference.md)

<a id="authentication"></a>

## OAuth, разрешения и испытания

OAuth соединяет вашу проверенную учетную запись владельца и позволяет хост-магазину и обновлять токены. Субсидия mcp:research охватывает четыре вышеупомянутых источника исследований. Соединения API-key используют защищенный заголовок X-API-Key и могут включать в себя другие авторизованные источники.

Чтобы попробовать FlashData до создания аккаунта, используйте пробный доступ через CLI. MCP OAuth подключает аккаунт владельца; он не регистрирует и не привязывает пробный доступ. Профиль CLI не передаётся вашему MCP-хосту автоматически.

- [Начать пробный доступ для агента](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#access)
- [Претензия и передача полномочий](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#claim)
- [Использовать сохраненный доступ](https://flashdata.dev/ru/docs/guides/agent-access/reference.md#refresh)
- [Отменить доступ](https://flashdata.dev/ru/docs/guides/agent-access/reference.md#revoke)

<a id="errors"></a>

## устранение неполадок

| Проблема | Попробуйте |
| --- | --- |
| Нет инструментов FlashData | Заканчивайте согласие, подключайтесь и начинайте новую сессию. Проверьте URL и потоковый транспорт HTTP. |
| invalid_client / callback error | Для Codex или OpenClaw используйте его точную конфигурацию клиента и браузер, который может достичь локального обратного вызова. Для другого хоста используйте поддерживаемый API-ключ или настройку stdio выше. |
| 401 | Воссоединитесь с истекшим или отозванным доступом OAuth или проверьте ключ API, предоставленный хосту. Повторите бесплатный чек. |
| 403 | Проверьте запрашиваемый источник и ключевые разрешения. YouTube Download требует наличия ключа API у владельца с youtube_download и хранилищем назначения; mcp:research не включает его. |
| 402 | Проверьте Billing и текущую цену. Воссоединение действительного учетного данных не добавляет кредитов. |
| 429 | Следуйте за Retry-After. Сохраняйте любую существующую работу или результат ID, прежде чем принимать решение о повторном выполнении задачи. |
| Тайм-аут или неполный ответ | Запрос ID и проверка History. Прочитайте продолжение с большим результатом с помощью get_result вместо повторения поиска. |

- [Billing](https://flashdata.dev/app/billing)
- [Запросить историю](https://flashdata.dev/app/jobs)

<a id="client"></a>

## Иди дальше

- [Создайте клиент MCP](https://flashdata.dev/ru/docs/guides/mcp-custom-client/reference.md)
- [Codex детали настройки](https://flashdata.dev/ru/docs/integrations/codex/reference.md)
- [OpenClaw детали настройки](https://flashdata.dev/ru/docs/integrations/openclaw/reference.md)
- [Регулярные задачи](https://flashdata.dev/ru/docs/guides/recurring-tasks/reference.md)
