56 инструментов

Command Palette

Search for a command to run...

MCP Server

Подключение MCP-сервера

Model Context Protocol позволяет AI-ассистентам напрямую работать с brandfound. — управлять компаниями, анализировать упоминания и создавать контент из чата. Каждый MCP tool — HTTP-вызов API v1. Часть endpoints оптимизирована под MCP-workflow (context_only для Фабрики, атомарный setup для запросов).

MCP Endpoint

https://app.brandfound.ai/api/mcp/stream

OAuth 2.1 + PKCE

Безопасная авторизация через браузер. API-ключ создаётся автоматически при первом подключении. Токен действует 90 дней. Отозвать доступ можно в настройках.

Авторизация
ПротоколOAuth 2.1
PKCES256
ТранспортHTTP
Токены
Префиксgfx_
TTL90 дней
ФорматBearer
Discovery
Protected Resource/.well-known/oauth-protected-resource
Authorization Server/.well-known/oauth-authorization-server

Выберите AI-ассистента

Нажмите на нужный клиент — откроется инструкция по подключению.

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

56

После подключения коннектор открывает LLM-клиенту доступ к этим функциям brandfound. Клиент сам выбирает нужные в зависимости от задачи.

Окружения (workspaces)

2

Один токен — все доступные окружения

  • •У одного OAuth-токена есть «активное» окружение. По умолчанию — то, в котором ты авторизовался; switch_workspace меняет его на любое другое, где у тебя ACCEPTED-инвайт.
  • •Переключение персистентно: хранится в ApiKey.activeAccountId и видно всем MCP-клиентам этого ключа (Claude Desktop, Cursor и т.п.) на следующем запросе. Переавторизация не нужна.
  • •Доступ проверяется на КАЖДОМ запросе. Если тебя удалили из команды — следующий tool молча вернётся к токеновскому окружению, без 401.
  • •Побочный эффект switch: preferredCompanyId сбрасывается, т.к. он привязан к старому окружению.
  • list_workspaces

    Список доступных окружений (свой + ACCEPTED TeamMember) с пометкой текущего

  • switch_workspace

    Переключить активное окружение для API key (персистентно); preferredCompanyId сбрасывается

    accountId

Компании и продукты

9
  • list_companies

    Список компаний пользователя с поиском и пагинацией

    search, limit, offset, sortBy, sortOrder

  • get_company

    Получить детальную информацию о компании и её продуктах

    companyId

  • create_company

    Создать новую компанию для отслеживания

    name, description, url, country, categoryId, synonyms

  • update_company

    Обновить поля существующей компании

    companyId, name, description, url, country, categoryId, synonyms, isAutoGenerationEnabled

  • get_company_categories

    Справочник категорий компаний (отраслей/ниш)

  • create_competitor

    Создать нового конкурента для отслеживания

    name, companyId, productId, url, synonyms

  • update_competitor

    Обновить данные существующего конкурента

    competitorId, name, url, synonyms

  • create_product

    Создать новый продукт внутри существующей компании

    companyId, name, description, url, intents

  • update_product

    Обновить существующий продукт или переназначить intents

    productId, name, description, url, intents

Интенты (keywords)

8
  • list_keywords

    Список интентов (keywords) с фильтрами по target и состоянию

    companyId, productId, competitorId, state, search, limit, offset, sortBy, sortOrder

  • create_keyword

    Создать или переиспользовать интент + опциональный attach к target

    name, attach

  • update_keyword

    Переименовать интент (единственное редактируемое поле)

    keywordId, name

  • archive_keyword

    Архивировать интент глобально вместе со всеми связями (обратимо)

    keywordId, dryRun

  • delete_keyword

    Полное удаление из БД — требует предварительного archive_keyword

    keywordId, dryRun

  • restore_keyword

    Восстановить интент из архива вместе со связями к живым target

    keywordId

  • attach_keywords

    Bulk-привязка имён интентов к target (find-or-create по name)

    target, names

  • detach_keywords

    Bulk-отвязка интентов от target — сам интент остаётся жить

    target, keywordIds

Аналитика и метрики

15
  • get_competitor_analytics

    Конкурентный анализ: share-of-voice и лидеры

    companyId, productId, timeRange, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode

  • get_brand_visibility

    Brand Mention Rate (BMR) timeline — видимость бренда

    companyId, productId, timeRange, granularity, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode

  • get_tonality

    Анализ тональности: sentiment, fairness, helpfulness и 10+ метрик

    companyId, productId, timeRange, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode, queryType, sentiment

  • list_mentions

    Упоминания бренда в ответах AI-ассистентов с фильтрами

    companyId, productId, competitorId, sourceIds, timeRange, dateFrom, dateTo, sentiment, type, isOurs, search, sortBy, sortOrder, limit, offset

  • list_queries

    Список запросов к AI с ответами и аналитикой

    companyId, productId, hasAnswers, searchText, sourceIds, types, sentiment, dateFrom, dateTo, isFavorite, sortBy, sortOrder, limit, offset

  • get_trending_topics

    Стратегические трендовые темы (7–30 дней) с растущей динамикой

    companyId, timeRange, limit, minGrowthPercent

  • get_trend_pulse

    Тактический пульс трендов (6–72 часа) с event-сигналами

    companyId, window, signals, minSeverity

  • get_analytics_overview

    Дашборд-сводка по компании для быстрого обзора

    companyId, timeRange, productId

  • list_analytics_keywords

    Облако ключевых слов с частотами и категориями

    companyId, timeRange, productId, category

  • get_analytics_timeline

    Временной ряд упоминаний по дням с разбивкой

    companyId, timeRange, granularity

  • get_analytics_trending

    Лента из 10 последних упоминаний с контекстом

    companyId, timeRange, productId

  • list_query_labels

    Список меток/кластеров запросов с количеством queries

    companyId, q, limit, offset, lite

  • get_query_label_analytics

    Аналитика по кластеру: BMR, Share of Voice, Citation Rates

    id

  • list_notifications

    Уведомления пользователя (WIDGET / BANNER / TOAST / EMAIL)

    limit, offset, type, includeDismissed

  • list_geo_analytics

    Разбивка метрик по странам или регионам

    companyId, timeRange, groupBy

Запросы

2
  • setup_queries

    Создать пул запросов для мониторинга в AI-ассистентах

    companyId, clusters, providers

  • generate_queries_preview

    Получить AI-сгенерированные варианты запросов

    companyId, productId, count, queryTypes, userWishes, language, region

Фабрика

15
  • list_content_tasks

    Список задач фабрики (канбан) с фильтрами

    companyId, statuses, types, priorities, search, tagId, aiGenerated, sortBy, sortOrder, limit, offset

  • create_content_task

    Создать новую тему в фабрике

    title, companyId, type, priority, description, targetKeywords

  • update_content_task

    Обновить задачу фабрики (статус, приоритет, описание)

    taskId, status, priority, title, description

  • delete_content_task

    Удалить (архивировать) задачу фабрики

    taskId

  • enrich_content_task

    Обогатить задачу: RAG-поиск, аналитика, анализ конкурентов

    taskId, companyId, topic, description, keywords, mode

  • generate_content_plan

    Сгенерировать план статьи: структура, тезисы, tone

    taskId, prompt, topicId, topicTitle, mode

  • generate_article

    Сгенерировать полнотекстовую статью в Markdown

    taskId, planId, articleLength, mode

  • suggest_topics

    Предложить 10 подтем на основе enrichment-данных

    taskId, mode

  • save_enrichment_analysis

    Сохранить результат анализа от клиентского LLM

    taskId, aiAnalysis, usage

  • save_generated_plan

    Сохранить контент-план (JSON) от клиентского LLM

    taskId, plan, topicId, topicTitle, prompt, usage

  • save_generated_article

    Сохранить статью (Markdown) от клиентского LLM

    taskId, content, planId, usage

  • set_publication_url

    Установить URL опубликованной статьи для отслеживания BMR

    taskId, publishedUrl

  • detect_insights

    Детекция инсайтов (15 типов): content gaps, competitor wins

    companyId, insightType

  • list_content_tags

    Список тегов фабрики с количеством задач

  • list_publications

    Список опубликованного контента + метрики эффективности

    companyId