DataFast MCP

Сервер DataFast MCP

Сервер DataFast MCP позволяет MCP-совместимым клиентам, таким как Codex, Claude Code и Cursor, запрашивать вашу аналитику и управлять вашим аккаунтом на естественном языке. Он предоставляет те же функции, разрешения и проверки безопасности, что и REST API и CLI.

Он использует Streamable HTTP по адресу https://datafa.st/api/mcp.

Шаг 1 — Создайте токен аккаунта

Откройте Настройки аккаунта → API / MCP, выберите, к каким сайтам и разрешениям клиент может получить доступ, затем создайте токен. Скопируйте токен dft_, когда он появится — вы будете использовать его на следующем шаге, и он показывается только один раз.

Каждый MCP-запрос использует разрешения и доступ к сайтам, которые вы выбрали для токена.

Шаг 2 — Подключите ваш клиент

Codex

Сохраните скопированный токен в переменной окружения DATAFAST_TOKEN, затем добавьте DataFast:

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

Claude Code

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

Cursor, Claude Desktop и другие клиенты на основе конфигурации

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

Клиенты, поддерживающие только stdio

Мостик через mcp-remote:

{
  "mcpServers": {
    "datafast": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://datafa.st/api/mcp",
        "--header",
        "Authorization: Bearer dft_xxx"
      ]
    }
  }
}

Инструменты

См. полную справку по инструментам — аналитика, сайты, API-ключи, команда, цели, воронки, посетители, оповещения, аккаунт, токены доступа и статус интеграции. Имена инструментов следуют datafast_<resource>_<action>, например datafast_analytics_overview, datafast_websites_list.

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

• Подтверждение: необратимые инструменты или инструменты, выдающие учётные данные (удаление, перевыпуск, создание API-ключей/токенов), требуют явного аргумента confirm: true. Вызов без него возвращает предпросмотр того, что произошло бы, вместо выполнения действия, поэтому агент не может выполнить чувствительное действие с первой попытки.
• Нет утечки секретов: конечные точки списка API-ключей и токенов доступа никогда не возвращают секретные значения, только метаданные (id, имя, префикс, даты) — так же, как REST API.
• Удаление сайта только через дашборд: не существует MCP-инструмента для удаления сайта; удаление не может быть автоматизировано по дизайну.
• Подключение/отключение платежей только через дашборд: MCP может сообщать статус интеграции, но подключение или отключение платёжных провайдеров (и обработка их учётных данных) остаётся в дашборде.
• Ограничено токеном, а не инструментом: каждый вызов инструмента повторно проверяет разрешения на реальном маршруте — транспорт разрешает bearer один раз на запрос, затем повторно использует этот результат для внутрипроцессной аутентификации (без повышенных привилегий только для MCP).

Продвинутый уровень: ограничение MCP одним сайтом

Для более ограниченной настройки используйте API-ключ сайта df_ вместо токена аккаунта. Он ограничивает клиента одним сайтом и в основном аналитикой только для чтения. Создайте его на странице Настройки → API / MCP этого сайта и см. аутентификацию и области действия для подробностей.