Подключить Productboard MCP к Gemini CLI

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Productboard, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Productboard + Gemini

Управление продуктом в Productboard через REST API v2: чтение и правка продуктов, компонентов, фич, инициатив, целей и ключевых результатов, релизов, компаний и пользователей как сущностей с пользовательскими полями и связями, сбор и поиск заметок с отзывами клиентов и их привязка к фичам, а также участники и команды.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

PRODUCTBOARD_API_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужно рабочее пространство Productboard на тарифе Pro или выше.

1. В Productboard откройте Settings > Integrations > Public APIs > Access Token и нажмите +, чтобы создать токен. Скопируйте его сразу: он показывается только один раз.
2. Вставьте его в PRODUCTBOARD_API_TOKEN без префикса Bearer. Он передаётся как Authorization: Bearer <token> и действует с правами участника, который его создал, поэтому токен администратора или мейкера рабочего пространства видит больше всего.
3. Установите коннектор и запустите productboard_list_entity_configurations: он подтвердит токен и выведет типы сущностей вашего рабочего пространства.

Только API v2: коннектор использует Productboard REST API v2 (https://api.productboard.com/v2). API v1 объявлен устаревшим в апреле 2026 года и отключён 8 июля 2026 года.

Всё является сущностью: продукты, компоненты, фичи, подфичи, инициативы, цели, ключевые результаты, релизы, группы релизов, пользователи и компании (а также конкуренты и задачи, если они есть в рабочем пространстве) являются сущностями с полем type. Отзывы клиентов хранятся в заметках.

Сначала изучите рабочее пространство: поля в каждом рабочем пространстве свои. productboard_list_entity_configurations и productboard_get_entity_configuration показывают все поля типа (стандартные, например name, description, status, owner, timeframe, teams, tags, и пользовательские с UUID в качестве ключа), какие из них обязательны и какие операции patch они принимают. productboard_list_note_configurations делает то же для заметок, productboard_list_field_values перечисляет варианты поля выбора, тегов или статуса.

Что он читает:

• Роадмап: productboard_list_entities с types (например ["feature"], ["objective", "keyResult"] или ["company"]) и фильтрами по имени, владельцу, статусу, команде, родителю или архивности; productboard_search_entities для структурных фильтров по нескольким id, датам, значениям полей (в том числе пользовательских), родителям и клиентам с выбором возвращаемых полей; productboard_get_entity для одной записи вместе с URL links.html.
• Иерархия: productboard_list_entity_relationships показывает родителя, детей, связи и блокеры, например все фичи компонента.
• Отзывы: productboard_list_notes по дате, владельцу, автору, системе-источнику, признаку обработки или архивности; productboard_search_notes для полнотекстового поиска вместе с тегами, клиентом и привязанными фичами; productboard_get_note и productboard_list_note_relationships для одной заметки, её клиента и привязанных фич.
• Люди: productboard_list_members и productboard_get_member для участников рабочего пространства, productboard_list_teams и productboard_list_team_members для команд.

Что он записывает:

• productboard_create_entity создаёт фичу, компонент, инициативу, цель, ключевой результат, релиз, компанию и другое с type и fields; родитель задаётся через relationships, например [{"type": "parent", "target": {"id": "<component id>"}}].
• productboard_update_entity перезаписывает значения через fields или применяет операции patch (set, addItems, removeItems, clear) к спискам вроде тегов и команд.
• productboard_set_entity_parent переносит сущность под другого родителя; productboard_create_entity_relationship добавляет связь link, isBlockedBy или isBlocking.
• productboard_create_note заносит отзыв во входящие Insights с заголовком, текстом, тегами, владельцем, исходной записью, клиентом и привязанными фичами; productboard_update_note меняет заметку (например, помечает её обработанной); productboard_link_note привязывает заметку к фиче или задаёт её клиента.

Нечего отключать, нечего удалять: при установке ничего не отключено, потому что инструментов удаления у коннектора нет вовсе. Удаление сущности в API v2 удаляет и всех её детей, поэтому удаление остаётся в приложении Productboard.

Форматы данных: ссылки задаются объектами: владельцы как {"email": "[email protected]"} или {"id": "<uuid>"}, статус как {"name": "In progress"}, теги как [{"name": "Q4"}]. timeframe выглядит так: {"startDate": "2026-10-01", "endDate": "2026-12-31", "granularity": "month"}. content заметок и поля с форматированным текстом принимают простой HTML или обычный текст. Списки возвращают data, каждая запись с id, type, fields, links.html, createdAt и updatedAt. Все id являются UUID, время указано в ISO 8601 UTC. Без разрешения members:pii:read email владельцев приходят как [redacted].

Постраничный вывод: если задан links.next, ИИ берёт значение pageCursor из этого URL и передаёт его как page_cursor; он останавливается, когда links.next равен null.

Лимиты и частые ошибки: 50 запросов в секунду на токен; 429 приходит с Retry-After. 401 означает неверный или отозванный токен, 403 токен, у участника которого нет прав на эти данные, 400 или 422 неизвестное поле или тип: в сообщении указано, что принимает рабочее пространство, и ИИ сверяется с конфигурацией.

Коннектор не удаляет сущности и заметки, не меняет настройки, поля и статусы рабочего пространства и не использует отключённый API v1.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Productboard.

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

Примеры запросов

• «Выведи фичи в статусе In progress с владельцем и сроками, сгруппировав по компонентам.»
• «Какие необработанные заметки с отзывами за последние две недели упоминают онбординг? Кратко опиши основные темы.»
• «Создай фичу „Тёмная тема для мобильного приложения“ в компоненте Mobile, владелец [email protected], статус New idea.»
• «Занеси этот тикет поддержки как заметку от [email protected] и привяжи её к фиче экспорта в CSV.»
• «Покажи наши цели и их ключевые результаты на этот квартал со статусом и владельцем.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot