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-ассистента

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

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

50

После подключения коннектор открывает 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

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

7

v1.1: upsert-инструменты вместо пар create/update

  • •save_company / save_competitor / save_product объединяют прежние create_* и update_*: без id — создание, с id — обновление только переданных полей.
  • •synonyms при обновлении полностью заменяют прежний список (без merge) — расширяя, передавайте полный массив.
  • list_companies

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

    search, limit, offset, sortBy, sortOrder

  • get_company

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

    companyId

  • save_company

    Создать или обновить компанию (upsert: без companyId — создание). regionTargets задают страны замера и страну автоподбора

    companyId?, name, description, url, country, categoryId, synonyms, regionTargets, defaultLanguageId, defaultResponseLanguageId, defaultLocale, autogenQueryTypes, autogenQueriesPerRun

  • get_company_categories

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

  • search_geo

    Справочники стран, городов и языков с их UUID — для regionTargets и defaultLanguageId

    kind, q, countryIso2, limit

  • save_competitor

    Создать или обновить конкурента (upsert: без competitorId — создание)

    competitorId?, companyId, name, productId, url, synonyms

  • save_product

    Создать или обновить продукт, включая переназначение intents (upsert)

    productId?, companyId, name, description, url, intents

Ключевые слова (keywords)

3

v1.1: жизненный цикл через action

  • •manage_keyword объединяет create / rename / archive / restore / delete в один инструмент с параметром action (archive и delete поддерживают dryRun).
  • •link_keywords объединяет attach (по именам, find-or-create) и detach (по keywordIds) — связь с company / product / competitor.
  • list_keywords

    Список ключевых слов с фильтрами по target и состоянию

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

  • manage_keyword

    Жизненный цикл одного ключевого слова: create / rename / archive / restore / delete

    action, keywordId, name, attach, dryRun

  • link_keywords

    Bulk-привязка (по именам) или отвязка (по id) ключевых слов от target

    action, target, names, keywordIds

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

9

v1.1: консолидация отчётов

  • •get_analytics_report — один инструмент с селектором report: overview / keywords / timeline / recent / geo / cluster (заменил 6 прежних инструментов).
  • •get_trends — стратегические темы (scope="topics", 7–30 дней) и тактические сигналы (scope="pulse", 6–72 часа) в одном инструменте.
  • 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_trends

    Тренды: scope="topics" (стратегия, 7–30 дней) или scope="pulse" (сигналы, 6–72 часа)

    scope, companyId, timeRange, limit, minGrowthPercent, window, signals, minSeverity

  • get_analytics_report

    Сводный отчёт: overview / keywords / timeline / recent / geo / cluster

    report, companyId, timeRange, productId, category, granularity, groupBy, labelId

  • list_query_labels

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

    companyId, q, limit, offset, lite

  • list_notifications

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

    limit, offset, type, includeDismissed

Запросы

7

Два пути: агент пишет запросы сам или их подбирает сервис

  • •setup_queries — BYO-LLM: тексты пишет ваш агент, опираясь на карту бренда (get_brand_card) и список конкурентов (get_company). Бесплатно, вы платите только за токены своей LLM.
  • •autogenerate_queries — семантику подбирает сервис (1 FoxCoin за сгенерированный запрос) и кладёт её в ЧЕРНОВИКИ. Нейросети при этом не опрашиваются: опрос стартует только на approve_query_drafts (10 FoxCoin за ответ = запрос × нейросеть). Перед подтверждением сделайте dryRun и покажите смету пользователю.
  • •6 типов запроса: neutral, commercial, informational (без брендов в тексте), comparative (бренд + конкурент из базы), reputational и branded (бренд в тексте). Legacy negative/general принимаются как алиасы.
  • •Язык и страна автоподбора берутся из региональных настроек компании (save_company.regionTargets). Для замера по нескольким странам передайте targets — по задаче на страну, язык по умолчанию государственный (AE → ar, IN → hi).
  • •list_answers — выгрузка ответов пачкой (до 200 за вызов) со ссылками и упоминаниями вместо цикла по каждому запросу.
  • setup_queries

    Создать пул запросов (тексты пишет агент) с кластерами и опциональным платным опросом нейросетей

    companyId, clusters, providers

  • autogenerate_queries

    Автоподбор семантики в черновики, без опроса нейросетей (1 FoxCoin за запрос)

    companyId, productId, count, types, clusters, userWishes, name, region, language, city, includeDistricts, targets

  • get_autogeneration_status

    Прогресс задач автоподбора: RUNNING / OK / FAILED / CANCELLED

    clientToken, runId, limit

  • list_query_drafts

    Сгенерированные запросы, ожидающие подтверждения

    status, companyId, type, page, limit

  • approve_query_drafts

    Подтвердить черновики и запустить платный опрос выбранных нейросетей (dryRun — только смета)

    draftIds, providers, dryRun

  • reject_query_drafts

    Отклонить черновики (бесплатно, ничего не опрашивается)

    draftIds

  • list_answers

    Ответы нейросетей пачкой: ссылки, упоминания, brandDomainCited

    companyId, productId, queryId, provider, type, label, region, language, createdAtFrom, createdAtTo, hasLinks, mentionsOurs, include, limit, offset

Фабрика

13

v1.1: BYO-LLM по умолчанию, платен только явный mode="generate"

  • •enrich_content_task / generate_content_plan / generate_article по умолчанию (mode="context_only") возвращают промпт + контекст: результат пишет LLM клиента и сохраняет через save_* — FoxCoin не списываются.
  • •Явный mode="generate" запускает серверную генерацию как в UI и платен: обогащение 20 FC, план 50 FC, статья 70 FC (при нехватке — 402 INSUFFICIENT_FOXCOINS).
  • •suggest_topics удалён: альтернативные углы темы агент придумывает сам из enrichment-контекста и передаёт topicTitle в generate_content_plan.
  • •manage_content_task объединяет create / update / archive задач канбана в один инструмент с action.
  • list_content_tasks

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

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

  • get_content_task

    Одна задача целиком, включая сохранённую статью

    id

  • manage_content_task

    Создать / обновить / архивировать задачу фабрики (action)

    action, taskId, title, companyId, type, status, priority, description, targetKeywords

  • enrich_content_task

    Обогатить задачу: RAG-поиск, аналитика, анализ конкурентов (context_only бесплатно; generate — 20 FC)

    taskId, companyId, topic, description, keywords, mode

  • generate_content_plan

    План статьи: структура, тезисы, tone (context_only бесплатно; generate — 50 FC)

    taskId, prompt, topicId, topicTitle, mode

  • generate_article

    Полнотекстовая статья в Markdown (context_only бесплатно; generate — 70 FC)

    taskId, planId, articleLength, 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 — бесплатно (rule-based)

    companyId, insightType

  • list_content_tags

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

  • list_publications

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

    companyId

Карта бренда

5

Агент может читать и вести карту бренда целиком

  • •Карта бренда — дерево markdown-файлов: манифест instruction.md (уходит в нейросеть первым), core-файл main / settings.md (применяется всегда) и любые файлы/папки пользователя (продукты, факты, кейсы, FAQ).
  • •Файлы ссылаются друг на друга: [Имя](brandcard://<id>) — id есть в индексе. Ссылка живёт по id и переживает переименование; связанные файлы получают приоритет при генерации (лимит one-shot инжекта ~60 000 символов).
  • •Приватные блоки ```private не уходят в нейросети — при чтении вырезаются автоматически, а save_brand_card_file перезаписывает файл целиком: перед правкой всегда читайте текущее содержимое.
  • •Рекомендуемый цикл: get_brand_card_index (структура + связи) → get_brand_card_file по нужным путям → save_brand_card_file. Готовый плейбук — MCP-промпт manage-brand-card (fill / audit / restructure).
  • get_brand_card

    Вся карта одним markdown (манифест → core → связанные → остальные), приватные блоки вырезаны

    companyId

  • get_brand_card_index

    Индекс карты: манифест + файлы с path, id, isCore и исходящими ссылками (граф связей)

    companyId

  • get_brand_card_file

    Один файл по пути: content (brandcard://-ссылки сохранены дословно) + links с резолвом в пути

    companyId, path

  • save_brand_card_file

    Создать/перезаписать файл по пути; недостающие папки создаются автоматически

    companyId, path, content

  • delete_brand_card_file

    Удалить файл или папку (каскадно); служебный каркас удалить нельзя

    companyId, path