DataFast MCP

Начало работы с MCP

Подключите своего ИИ-ассистента к DataFast, чтобы запрашивать данные о трафике, выручке и пользовательских целях, а также управлять операциями на сайте, которые вы разрешили. Вам понадобится аккаунт DataFast с доступом к API.

Выберите способ подключения

Выберите один метод. Оба используют Streamable HTTP для связи с DataFast.

• Вход через OAuth — рекомендуется для клиентов, поддерживающих вход через OAuth, включая Codex и Claude Code. Выберите сайты и разрешения в DataFast; клиент автоматически управляет своим токеном подключения. Вам не нужно создавать или копировать API-ключ.
• Использование API-токена — для клиентов, которые запрашивают Bearer-токен. Создайте токен аккаунта с ограниченными правами в DataFast и добавьте его в конфигурацию вашего клиента.

Оба метода предоставляют одинаковый набор инструментов DataFast. Разрешения OAuth позволяют отдельно одобрять аналитику, администрирование сайта, действия с аккаунтом и управление учетными данными. См. справочник инструментов для получения информации о том, что поддерживает каждый метод.

Подключение через OAuth

1. Добавьте DataFast в свой клиент

Добавьте удаленный MCP-сервер с указанным ниже URL и выберите OAuth или «Войти».

https://datafa.st/api/mcp

Для Codex добавьте сервер и завершите вход в браузере:

codex mcp add datafast --url https://datafa.st/api/mcp

Чтобы войти снова позже, выполните codex mcp login datafast. Поддерживаются как документы метаданных клиента, так и динамическая регистрация, включая нативные loopback-обратные вызовы. Если DataFast уже настроен с Bearer-токеном, удалите эти учетные данные из конфигурации DataFast в клиенте перед переходом на OAuth.

Для Claude Code добавьте сервер, затем откройте /mcp внутри Claude Code и авторизуйте DataFast:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. Войдите и одобрите доступ

1. Войдите на datafa.st с помощью существующего аккаунта DataFast.
2. Выберите сайты, к которым этот клиент может получить доступ.
3. Просмотрите запрашиваемые разрешения. Разрешения на чтение выбраны по умолчанию; включайте запись только если хотите, чтобы клиент вносил эти изменения.
4. Нажмите Разрешить доступ, чтобы вернуться к клиенту.

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

3. Попробуйте

Начните разговор с включенным DataFast и спросите:

Перечислите мои доступные сайты, затем покажите посетителей и выручку для моего сайта за последние семь дней.

Подтвердите сайт и диапазон дат перед продолжением. Ваши план и разрешения по-прежнему действуют.

Управляйте подключением или отзывайте его в разделе Настройки → API / MCP → Подключенные приложения. Переподключитесь, когда DataFast попросит вас снова одобрить доступ, или когда вы захотите предоставить доступ к другим сайтам или разрешениям.

Подключение через API-токен

Используйте этот метод, когда ваш клиент запрашивает API-ключ или Bearer-токен. Для MCP начните с токена доступа к аккаунту, который начинается с dft_.

1. Создайте токен аккаунта

1. Откройте Настройки аккаунта → API / MCP.
2. В разделе Новый токен доступа выберите Конкретные сайты, чтобы ограничить доступ, или Все сайты, если это соответствует вашим задачам.
3. Выберите только те разрешения, которые вам нужны. Для аналитического подключения начните с Сайты → Чтение и Аналитика → Чтение, отключив все остальные разрешения.
4. Дайте токену узнаваемое имя, нажмите Создать токен и скопируйте значение dft_. Оно отображается только один раз.

2. Добавьте токен в свой клиент

Используйте https://datafa.st/api/mcp и отправляйте токен как заголовок Authorization: Bearer …. Храните его в настройках учетных данных клиента или в переменной окружения, вне системы контроля версий и чат-сообщений.

Codex: сделайте свой токен доступным как переменную окружения DATAFAST_TOKEN, затем выполните:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: замените dft_xxx на свой токен:

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: добавьте эту запись в свой mcp.json. Сделайте DATAFAST_TOKEN доступным в окружении Cursor; Cursor разворачивает переменную окружения при подключении.

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

Другие клиенты: введите URL сервера и Bearer-токен в их настройках удаленного MCP. Клиентам, поддерживающим только локальные stdio-серверы, потребуется мост, например mcp-remote.

3. Попробуйте и управляйте доступом

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

Управляйте токеном в разделе Ваши токены доступа в Настройки аккаунта → API / MCP. Используйте Изменить разрешения, чтобы изменить его возможности, Перевыпустить, чтобы заменить секрет, или Удалить, чтобы отозвать его. После перевыпуска токена обновите значение в клиенте.

Уже есть df_ API-ключ сайта? Общая конечная точка MCP также принимает их, с доступом, привязанным к этому сайту. Проверьте Аутентификацию API для получения информации о поддерживаемых операциях. Вы также можете ограничить токен аккаунта одним сайтом с помощью опции Конкретные сайты выше.

Как ограничивается доступ

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

DataFast проверяет на сервере учетные данные, разрешенное действие, доступ к сайту, текущее членство и применимые ограничения аккаунта или плана. Идентификатор сайта в запросе инструмента — это цель для проверки, а не доказательство доступа. Например, OAuth-подключение, одобренное для чтения сайта A, не может читать сайт B или редактировать сайт A.

OAuth-подключения имеют доступ только к одобренным сайтам. Сайт, созданный через одобренный OAuth-инструмент, добавляется к этому подключению; сайты, добавленные в другом месте, не передаются автоматически. OAuth-токены истекают через один час, автоматически обновляются до 30 дней с момента выдачи и требуют нового согласия не позднее чем через 90 дней. Токены аккаунта, созданные в панели управления, остаются действительными, пока вы их не перевыпустите или не удалите, с учетом доступа и разрешений вашего аккаунта. API-ключи и токены аккаунта, выданные через OAuth, также зависят от того, что исходное подключение остается действительным.

OAuth-токены работают только на той конечной точке MCP, для которой они были выданы. Их нельзя вставить в публичный REST API или использовать для входа в панель управления DataFast. Токены аккаунта также работают с поддерживаемыми конечными точками REST API.

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

• Начните с ограниченного доступа. Предоставьте клиенту только те сайты и разрешения, которые ему нужны. Действия с аккаунтом, управление учетными данными и полные данные о посетителях требуют отдельных разрешений OAuth, которые по умолчанию отключены.
• Проверяйте изменения. Инструменты записи OAuth требуют подтверждения и ключа повторной попытки. Инструменты API-токена требуют подтверждения для чувствительных операций, таких как удаление данных или выдача учетных данных. Эти проверки дополняют интерфейс подтверждения клиента; они не заменяют выбор надежного клиента.
• Храните учетные данные в тайне. Оба метода используют Bearer-токены: тот, кто получит действительный токен, сможет использовать его разрешенный доступ до истечения срока или отзыва. Никогда не помещайте учетные данные в URL, систему контроля версий или чат-сообщения.
• Отключайтесь при необходимости. Отзыв OAuth-подключения блокирует последующие запросы и обновления. Уже выполняющийся запрос может завершиться, а данные, уже переданные другому приложению, не удаляются при отзыве.
• Операции только для панели управления остаются в панели управления. MCP не может удалять сайты или подключать/отключать платежных провайдеров.