Как подключить MCP

MCP подключает ИИ-агента к инструментам Re:Activity ключом агента или входом из клиента. После подключения вы сможете поручать ему работу с активностями и контент-планом.

С чего начать#

Подключить агента можно двумя способами: ключом или входом из клиента.

  1. В настройках ключей агентов выпустите ключ rca_* и выберите права для нужной задачи. Секрет показывается один раз: скопируйте его при выдаче и не публикуйте. При потере или утечке отзовите ключ и выпустите новый. Подключите его по инструкции ниже заголовком Authorization: Bearer. Не вставляйте секрет в текст запроса к агенту.
  2. Если клиент поддерживает OAuth, войдите из него. Секрет в настройки клиента не кладётся: права вы подтверждаете на странице согласия. Как устроена страница — в разделе Подключение.
  3. Опишите агенту задачу, укажите канал, даты и часовой пояс. Если информации не хватает, попросите его сначала уточнить детали.

Для работы с активностями нужен боевой ключ и тариф Pro или Enterprise. Тестовый ключ не получает права на активности. Подключение через OAuth всегда боевой ключ, не rca_test_. Ранее выпущенные ключи не получают новые права автоматически. Подробности о ключах и тарифах — в руководстве по ключам.

Активности и контент-план#

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

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

Начните с готовых фраз для создания, изменения и запуска активности.

Для тех, кто пишет интеграцию#

Названия инструментов и параметры записи приведены в описании инструментов активностей.

Подключение#

Адрес один: https://reactivity.me/mcp.

Ключ передаётся заголовком Authorization: Bearer <ключ агента>. В примерах команд он берётся из переменной окружения: export REACTIVITY_AGENT_KEY="<ваш ключ>". Не размещайте ключ в публичной конфигурации или скриншотах.

При входе через OAuth секрет в конфиг клиента не кладётся. Вы подтверждаете права на странице согласия, которую открывает клиент. Заголовок страницы — «Подключение». На странице видны имя приложения и хост возврата. content:read и activities:read уже отмечены, если тариф их позволяет. content:draft, content:publish, generate:image, activities:draft и activities:control остаются выключенными, пока вы их не отметите. Режим по умолчанию — review. Кнопки — «Разрешить» и «Отклонить». Подключение действует, пока вы его не отзовёте. Это всегда боевой ключ, не rca_test_.

Выберите свой клиент ниже.

Claude#

claude mcp add --transport http reactivity https://reactivity.me/mcp \
  --header "Authorization: Bearer $REACTIVITY_AGENT_KEY"

ChatGPT#

В окне chatgpt.com постоянный ключ в заголовок не передаётся. Подключение идёт через OAuth, секрет копировать не нужно.

  1. Откройте «Плагины», нажмите «Добавить» и выберите «Добавить пользовательский сервер MCP».
  2. Укажите название и адрес https://reactivity.me/mcp. Аутентификация — OAuth.
  3. Подтвердите предупреждение и создайте плагин, затем нажмите «Подключить».
  4. Войдите в Re:Activity, если браузер ещё не вошёл. На странице согласия отметьте права и нажмите «Разрешить». Чтение уже отмечено, если его позволяет тариф; запись, генерация и запуск включаются только вами.
  5. В новом чате упомяните плагин через @ и опишите задачу.

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

Ключ по-прежнему работает с ChatGPT через OpenAI Responses API: если вы пишете свой код или агентов на моделях OpenAI, добавьте Re:Activity в запрос как MCP-инструмент (значение $REACTIVITY_AGENT_KEY подставьте в коде из переменной окружения):

{ "type": "mcp", "server_label": "reactivity", "server_url": "https://reactivity.me/mcp",
  "headers": { "Authorization": "Bearer $REACTIVITY_AGENT_KEY" }, "require_approval": "never" }

Gemini#

Для Gemini CLI:

gemini mcp add --transport http -s user \
  --header "Authorization: Bearer $REACTIVITY_AGENT_KEY" reactivity https://reactivity.me/mcp

Или в файле ~/.gemini/settings.json (значение ключа подставьте вместо $REACTIVITY_AGENT_KEY):

"mcpServers": { "reactivity": { "httpUrl": "https://reactivity.me/mcp",
  "headers": { "Authorization": "Bearer $REACTIVITY_AGENT_KEY" } } }

Hermes#

В ~/.hermes/config.yaml или ~/.hermes/profiles/<профиль>/config.yaml.

Ключ (значение подставьте вместо $REACTIVITY_AGENT_KEY):

mcp_servers:
  reactivity:
    url: https://reactivity.me/mcp
    headers:
      Authorization: Bearer $REACTIVITY_AGENT_KEY
    timeout: 120

Вход из клиента: без заголовка Authorization, поле auth: oauth. Клиент откроет браузер для согласия. Вход начинается командой hermes mcp login reactivity.

mcp_servers:
  reactivity:
    url: https://reactivity.me/mcp
    auth: oauth
    timeout: 120

OpenClaw#

Командой или через Control UI (Settings, раздел MCP):

openclaw mcp add reactivity --url https://reactivity.me/mcp --transport streamable-http

В конфиге сервер лежит в mcp.servers.reactivity: поля url и transport: "streamable-http". Для ключа укажите заголовок Authorization: Bearer ${REACTIVITY_AGENT_KEY} и не указывайте auth: oauth: при OAuth статический заголовок игнорируется. Для входа из клиента укажите auth: oauth и не задавайте статический заголовок Authorization. Проверка подключения:

openclaw mcp doctor reactivity --probe

Другие клиенты, например Claude Desktop и Cursor, подключаются через добавление удалённого MCP-сервера по HTTP с заголовком авторизации. Название пункта зависит от приложения.

Если подключение не работает#

Проверьте адрес, Bearer-ключ и то, что он не истёк и не отозван. Если инструмент отсутствует, проверьте право ключа и тариф; для активностей нужен боевой ключ с соответствующим правом. Для запросов запуска и остановки нужен боевой ключ Enterprise с правом activities:control. При 429 подождите перед повтором. Другие коды и действия описаны в таблице ошибок.

Если вход устарел, клиент обновит его сам: новый секрет копировать не нужно. Если подключение отозвано или обновление не удалось, начните вход из клиента заново.

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