---
title: "Справочник по инструментам | PostNext"
description: "Полный список инструментов сервера MCP PostNext с описанием входных параметров, структуры ответа и готовым примером для каждого."
url: "https://postnext.io/ru-ru/mcp/docs"
language: "ru-RU"
---

# Справочник по инструментам

Human version: [https://postnext.io/ru-ru/mcp/docs](https://postnext.io/ru-ru/mcp/docs)

Полный список инструментов сервера MCP PostNext с описанием входных параметров, структуры ответа и готовым примером для каждого.

[Подключить PostNext](https://postnext.io/ru-ru/mcp/connect)

URL MCP-сервера `https://mcp.postnext.io/api`

```
POST https://mcp.postnext.io/api
```

## Аутентификация

Каждый запрос к https://mcp.postnext.io/api требует заголовок Authorization с Bearer-токеном. Получить токен можно двумя способами.

### OAuth (рекомендуется для ИИ-клиентов)

ИИ-клиенты при первом подключении выполняют Dynamic Client Registration и проводят пользователя через экран согласия OAuth. Страница /mcp/connect делает это автоматически, и клиент получает токен доступа на 30 дней.

### API-ключ

Для скриптов и CI создайте персональный API-ключ в приложении PostNext в разделе Аккаунт → API-ключи. Ключ начинается с apikey\_ и передаётся как обычный Bearer-токен.

### Эндпоинт

Все вызовы инструментов идут на один эндпоинт JSON-RPC 2.0 по HTTPS POST.

POST https://mcp.postnext.io/api

## Инструменты

### `list_scheduled_posts`

Список ваших запланированных публикаций (поставленных в очередь на публикацию, но ещё не отправленных).

#### Аргументы

`limit` number ·необязательный · default 20

Максимальное количество возвращаемых результатов (1-100, по умолчанию 20).

`from` string (ISO 8601) ·необязательный

ISO-метка времени: возвращать только публикации, запланированные не ранее этого момента.

#### Возвращает

Объект с posts: \[{id, platform, content, scheduledAt, status}\]. До limit результатов.

#### Пример

```
curl -X POST https://mcp.postnext.io/api \
  -H "Authorization: Bearer apikey_xxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":1,
       "params":{"name":"list_scheduled_posts",
                 "arguments":{"limit":5}}}'
```

### `list_drafts`

Список ваших черновиков (ещё не запланированных).

#### Аргументы

`limit` number ·необязательный · default 20

Максимальное количество возвращаемых результатов (1-100, по умолчанию 20).

#### Возвращает

Объект с drafts: \[{id, platform, content, updatedAt}\]. До limit результатов.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":2,
 "params":{"name":"list_drafts","arguments":{"limit":10}}}
```

### `list_connected_accounts`

Список социальных аккаунтов, подключённых к вашей команде.

#### Аргументы

Без аргументов.

#### Возвращает

Объект с accounts: \[{platform, handle, providerId, connected, lastSyncAt}\].

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":3,
 "params":{"name":"list_connected_accounts","arguments":{}}}
```

### `get_account_health` Платный тариф

Сводка состояния по всем подключённым платформам.

#### Аргументы

`platform` enum ·необязательный

Социальная платформа: twitter, instagram, linkedin, threads или tiktok.

`windowDays`7 | 30 | 90 ·необязательный · default 30

Период анализа в днях: 7, 30 или 90 (по умолчанию 30).

#### Возвращает

Объект с windowDays, postsScheduled, postsPublished, postsFailed, разбивкой byPlatform и topErrors\[\].

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":4,
 "params":{"name":"get_account_health",
           "arguments":{"windowDays":30}}}
```

### `create_post_draft`

Создание нового черновика публикации. Черновики не публикуются автоматически.

#### Аргументы

`platform` enum ·обязательный

Социальная платформа: twitter, instagram, linkedin, threads или tiktok.

`content` string ·обязательный

Текст публикации (1-2200 символов).

`channelName` string ·необязательный

Какой подключённый аккаунт, если на площадке их несколько.

`providerId` string ·необязательный

providerId аккаунта из list\_connected\_accounts. Он не меняется при смене имени пользователя, поэтому передавайте его вместе с channelName или вместо него.

`mediaUrls` array<string> ·необязательный

До 10 URL-адресов изображений или видео.

`clientRequestId` string ·необязательный

Необязательный ключ идемпотентности. Одинаковый ключ в течение 5 минут возвращает кэшированный результат.

#### Возвращает

Объект с новым черновиком: {id, platform, content, status: "DRAFT", createdAt}.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":5,
 "params":{"name":"create_post_draft",
           "arguments":{"platform":"twitter",
                        "content":"Hello from MCP"}}}
```

### `update_post_draft` Платный тариф

Обновление существующего черновика. Необходимо указать хотя бы одно из полей: content или mediaUrls.

#### Аргументы

`postId` string ·обязательный

Идентификатор публикации PostNext из результатов запроса списка.

`content` string ·необязательный

Текст публикации (1-2200 символов).

`mediaUrls` array<string> ·необязательный

До 10 URL-адресов изображений или видео.

`clientRequestId` string ·необязательный

Необязательный ключ идемпотентности. Одинаковый ключ в течение 5 минут возвращает кэшированный результат.

#### Возвращает

Объект с обновлённым черновиком: {id, platform, content, mediaUrls, status, updatedAt}.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":6,
 "params":{"name":"update_post_draft",
           "arguments":{"postId":"",
                        "content":"Updated copy"}}}
```

### `connect_channel`

Генерация одноразового URL, который пользователь может открыть для авторизации подключения новой платформы.

#### Аргументы

`platform` enum ·обязательный

Социальная платформа: twitter, instagram, linkedin, threads или tiktok.

#### Возвращает

Объект с authUrl (одноразовая ссылка, которую пользователь открывает для авторизации), expiresAt и platform.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":7,
 "params":{"name":"connect_channel",
           "arguments":{"platform":"linkedin"}}}
```

### `schedule_post`

Перемещает черновик (статус DRAFT) в очередь публикации на будущее время. Идемпотентен в пределах дрейфа ±60 секунд; отклоняет попытки перепланирования на другое время без явной отмены. Учитывается в месячном лимите постов тарифа (Free: 10, общий с приложением); каждый пост учитывается один раз, поэтому повторное планирование после отмены или неудачной публикации не считается заново.

#### Аргументы

`postId` string ·обязательный

Идентификатор публикации PostNext из результатов запроса списка.

`scheduledAt` string (ISO 8601) ·обязательный

Метка времени ISO 8601; не более чем на 5 минут в прошлом.

#### Возвращает

Объект с postId, scheduledAt (ISO), status: SCHEDULED.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":8,
 "params":{"name":"schedule_post",
           "arguments":{"postId":"",
                        "scheduledAt":"2026-05-10T09:00:00Z"}}}
```

### `cancel_scheduled_post`

Отменяет запланированный пост и удаляет его из очереди публикации. Базовый черновик сохраняется.

#### Аргументы

`postId` string ·обязательный

Идентификатор публикации PostNext из результатов запроса списка.

#### Возвращает

Объект с postId и status: CANCELLED.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":9,
 "params":{"name":"cancel_scheduled_post",
           "arguments":{"postId":""}}}
```

### `delete_draft`

Окончательно удаляет черновик. Отклоняет посты не в статусе DRAFT (используйте cancel\_scheduled\_post для SCHEDULED).

#### Аргументы

`postId` string ·обязательный

Идентификатор публикации PostNext из результатов запроса списка.

#### Возвращает

Объект с postId и deleted: true.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":10,
 "params":{"name":"delete_draft",
           "arguments":{"postId":""}}}
```

### `get_post`

Возвращает полный PostGroup для postId: контент по платформам, статус и временные метки.

#### Аргументы

`postId` string ·обязательный

Идентификатор публикации PostNext из результатов запроса списка.

#### Возвращает

Объект с postId, status, scheduledAt, createdAt, updatedAt и providers (карта платформа → контент).

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":11,
 "params":{"name":"get_post",
           "arguments":{"postId":""}}}
```

### `search_posts`

Подстрочный поиск (без учёта регистра) по контенту постов активной команды. Фильтры: status, platform, limit (1-100, по умолчанию 20).

#### Аргументы

`query` string ·обязательный

Подстрока для поиска (3-200 символов; regex-метасимволы экранируются).

`status` enum ·необязательный

Опционально: DRAFT | SCHEDULED | PUBLISHED | FAILED | CANCELLED.

`platform` enum ·необязательный

Социальная платформа: twitter, instagram, linkedin, threads или tiktok.

`limit` number ·необязательный · default 20

Максимальное количество возвращаемых результатов (1-100, по умолчанию 20).

#### Возвращает

Объект с posts: \[{postId, status, platforms, snippet, scheduledAt, updatedAt}\]. Snippet содержит совпадающий контекст с многоточием с обеих сторон.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":12,
 "params":{"name":"search_posts",
           "arguments":{"query":"launch","limit":10}}}
```

### `list_teams`

Возвращает команды, которыми владеет или администрирует аутентифицированный пользователь, с пометкой активной команды.

#### Аргументы

Без аргументов.

#### Возвращает

Объект с currentTeamId и teams: \[{teamId, teamName, isCurrent}\].

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":13,
 "params":{"name":"list_teams","arguments":{}}}
```

### `set_current_team`

Переключает активную команду для этого Bearer-токена. Пользователь должен быть участником команды. Сохраняется в OAuth-токене; изменение сразу действует для следующих инструментов в той же беседе.

#### Аргументы

`teamId` string ·обязательный

Целевой teamId из list\_teams. Членство повторно проверяется на сервере.

#### Возвращает

Объект с teamId, teamName, persisted (true для OAuth, false для API-ключа) и опциональным note.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":14,
 "params":{"name":"set_current_team",
           "arguments":{"teamId":"team_xxxxx"}}}
```

### `get_plan_limits`

Возвращает текущий тариф пользователя и квоты по тарифу (каналы, хранилище, ИИ-кредиты, публикация). Доступен на любом тарифе. Полезен перед изменяющими инструментами, чтобы предсказать, будет ли вызов заблокирован.

#### Аргументы

Без аргументов.

#### Возвращает

Объект с tier, tierDisplayName, isPaid, isTrial, limits (channels/storage/aiCalls каждое как {limit, current, exceeded}; posts как {limit, allowed, current}, где current означает число за текущий месяц или null, если его не удалось прочитать) и creditsAvailable ({total, subscriptionRemaining, purchasedBalance} или null).

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":15,
 "params":{"name":"get_plan_limits","arguments":{}}}
```

### `get_post_metrics`

Получает метрики вовлечённости опубликованного поста по каждой платформе, куда он был отправлен. Twitter возвращает лайки, ретвиты, ответы и показы; Instagram возвращает лайки и комментарии. LinkedIn, Threads и TikTok возвращают только статус публикации и URL (сбор вовлечённости появится в следующей версии). Нормализованный итог суммирует метрики по платформам, которые их вернули.

#### Аргументы

`postId` Идентификатор публикации PostNext из результатов запроса списка.

#### Возвращает

Объект с postId, status, providers: \[{platform, publishedPostId, publishedUrl, publishedAt, status, metrics}\] и totals: {likes, comments, shares, impressions}. metrics представляет собой объект числовых счётчиков по платформе или null, если платформа пока не собирает данные вовлечённости.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":16,
 "params":{"name":"get_post_metrics",
           "arguments":{"postId":""}}}
```

### `get_publish_status`

Диагностирует запланированную публикацию: статус очереди, успех/ошибка по платформам, время обработки и jobId воркера. Возвращает isScheduled=false для публикаций, которые существуют как черновики, но не были перемещены в очередь публикации, с подсказкой на schedule\_post.

#### Аргументы

`postId` Идентификатор публикации PostNext из результатов запроса списка.

#### Возвращает

Объект с postId, isScheduled, status, scheduledAt, publishedAt, platforms, processingTimeMs, jobId, topLevelError и results: \[{platform, success, publishedPostId, publishedAt, error}\]. Содержит hint, когда isScheduled равно false.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":17,
 "params":{"name":"get_publish_status",
           "arguments":{"postId":""}}}
```

### `update_brand_profile` Платный тариф

Обновляет активный профиль бренда пользователя. Разрешённые поля: bio, brandVoice, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize. Всё остальное молча отбрасывается. «Активный» профиль ищется так: сначала профиль команды по умолчанию, затем первый собственный активный профиль пользователя.

#### Аргументы

`brandVoice` Массив дескрипторов голоса бренда (например, \["профессиональный", "краткий"\]).

Other patchable fields: bio, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize.

#### Возвращает

Объект с profileId, name, updated: \[имена полей, которые были изменены\] и текущими значениями bio, brandVoice, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize после изменения.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":18,
 "params":{"name":"update_brand_profile",
           "arguments":{"brandVoice":["professional","concise"]}}}
```

### `get_best_time_to_post` Платный тариф

Рекомендует N лучших слотов (день недели, час) для следующего поста на платформе по данным за 90 дней. Twitter и Instagram ранжируются по вовлечённости на пост; LinkedIn, Threads и TikTok только по частоте публикаций. Время в указанном часовом поясе IANA (по умолчанию UTC). Нужен платный тариф.

#### Аргументы

`platform` Социальная платформа: twitter, instagram, linkedin, threads или tiktok.

`timezone` Название IANA-таймзоны (например, Europe/Moscow, America/New\_York). По умолчанию UTC.

`topN` Количество рекомендаций слотов (1-24, по умолчанию 5).

#### Возвращает

Объект с platform, timezone, sampleWindowDays, sampleSize, metricsAvailable и recommendations: \[{dayOfWeek (1-7, Пн=1), dayLabel, hour (0-23), score, basedOn: {posts, avgEngagement}}\]. Содержит hint для случаев cold-start или недоступных метрик.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":19,
 "params":{"name":"get_best_time_to_post",
           "arguments":{"platform":"twitter","timezone":"Europe/Berlin","topN":5}}}
```

### `get_channel_analytics`

Сводная статистика одного подключённого канала или сразу всех. Возвращает показы, охват, лайки, комментарии и вовлечённость за период, изменение к предыдущему периоду такой же длины и динамику подписчиков. Без platform приходит итог по всей команде. Для одной публикации используйте get\_post\_metrics, для планирования используйте get\_best\_time\_to\_post.

#### Аргументы

`platform` Социальная платформа: twitter, instagram, linkedin, threads или tiktok.

`channelName` Какой подключённый аккаунт, если на площадке их несколько.

`providerId` providerId аккаунта из list\_connected\_accounts. Он не меняется при смене имени пользователя, поэтому передавайте его вместе с channelName или вместо него.

`period` Период отчёта: 7d, 30d, 90d или all (по умолчанию 30d).

#### Возвращает

Объект с scope, period, totals, vsPrevious, coverage, dataThrough и followers, где есть trackingSince, current, change и сам ряд.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":34,
 "params":{"name":"get_channel_analytics",
           "arguments":{"platform":"linkedin","period":"30d"}}}
```

### `search_tools`

Ищет в каталоге инструментов MCP по тексту, категории или намерению. Возвращает категории, requiresScope, однострочные описания и теги вариантов использования, которые совпали. Доступно на любом тарифе (это инструмент для поиска).

#### Аргументы

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

`query` Свободный поиск по именам, описаниям и тегам использования инструментов.

`category` Фильтр по одной категории: posts, accounts, analytics, brand, teams, discovery, other.

#### Возвращает

Объект с totalTools, matchCount, categories: \[string\[\]\] и tools: \[{name, category, requiresScope, description, useCases, matchedOn: \[name|category|description|use\_case\]}\]. Содержит hint, когда нет совпадений или нет фильтра.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":20,
 "params":{"name":"search_tools",
           "arguments":{"query":"why did my post fail"}}}
```

### `get_plan`

Тариф и даты оплаты: уровень, дата продления, окончание пробного периода и признак отмены подписки в конце периода. За лимитами и расходом обращайтесь к get\_plan\_limits.

#### Аргументы

Без аргументов.

#### Возвращает

Объект с полями tier, tierDisplayName, isPaid, isTrial, gated, subscriptionStatus, renewsAt, trialEndsAt, cancelAtPeriodEnd и currency.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":21,
 "params":{"name":"get_plan",
           "arguments":{}}}
```

### `upload_asset`

Загрузка изображения или видео в медиатеку прямо в base64. Надёжно работает только для очень маленьких файлов, примерно до 8 КБ: всё, что больше, молча обрезается в аргументах инструмента и сохраняется повреждённым. Для файлов побольше используйте request\_asset\_upload.

#### Аргументы

`filename` Имя файла вместе с расширением, до 255 символов.

`contentType` MIME-тип файла из разрешённого списка изображений и видео.

`base64` Содержимое файла в кодировке base64. Держите его очень маленьким и сначала прочитайте предупреждение выше.

#### Возвращает

Объект с assetId, url, sizeBytes и mimeType. Передайте url в create\_post\_draft как mediaUrls.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":22,
 "params":{"name":"upload_asset",
           "arguments":{"filename":"logo.png","contentType":"image/png","base64":"iVBORw0KGgo..."}}}
```

### `request_asset_upload`

Рекомендуемый способ загрузки, для изображений и видео любого размера. Два шага: вызываете инструмент и получаете подписанную ссылку и готовую команду curl, затем отправляете файл методом PUT по этой ссылке. В ответе на PUT приходит итоговый адрес файла.

#### Аргументы

`filename` Имя файла вместе с расширением, до 255 символов.

`contentType` MIME-тип файла из разрешённого списка изображений и видео.

`sizeBytes` Точный размер файла в байтах, нужен для подписи загрузки.

#### Возвращает

Объект с uploadId, uploadUrl, uploadToken, expiresInSeconds и instructions, где лежит точная команда PUT.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":23,
 "params":{"name":"request_asset_upload",
           "arguments":{"filename":"clip.mp4","contentType":"video/mp4","sizeBytes":4194304}}}
```

### `import_chat_file`

Только для ChatGPT. Сохраняет в медиатеку изображения и видео, прикреплённые в чате, чтобы использовать их в create\_post\_draft. ChatGPT передаёт каждый файл временной ссылкой; PostNext скачивает его один раз по HTTPS и по самому файлу проверяет, что это изображение или видео. До 10 файлов за вызов, до 50 МБ каждый, в счёт хранилища вашего тарифа (на Free всего 10 МБ).

#### Аргументы

`files` Заполняет ChatGPT по файлам, прикреплённым в чате: download\_url и file\_id, по желанию mime\_type и file\_name. До 10. Другие клиенты загружают файлы через request\_asset\_upload.

#### Возвращает

Объект с files (assetId, url, sizeBytes, mimeType и fileName для каждого сохранённого файла) и failed (fileName и reason для каждого файла, который не удалось сохранить). Если не удалось сохранить ни одного файла, вызов вместо этого возвращает ошибку первого.

#### Пример

```
{"jsonrpc":"2.0","method":"tools/call","id":35,
 "params":{"name":"import_chat_file",
           "arguments":{"files":[{"download_url":"https://files.oaiusercontent.com/...","file_id":"file_abc123"}]}}}
```

## MCP-ресурсы

Ресурсы представляют собой контекст только для чтения, который клиент может получить через MCP-метод resources/read. Claude загружает их в начале каждой беседы, поэтому имеет контекст аккаунта/команды/бренда без необходимости каждый раз объяснять заново.

### `postnext://account/summary`

E-mail и имя пользователя аккаунта (чтобы Claude мог подтвердить, с каким аккаунтом он работает), тариф, использованные ИИ-кредиты / лимит, количество черновиков, количество запланированных постов, количество подключённых каналов. Каждый счётчик ограничен 100, чтобы данные загружались быстро.

### `postnext://channels/connected`

Та же структура, что у результата list\_connected\_accounts; доступна как ресурс, чтобы Claude загрузил её один раз в начале беседы (без отдельного вызова инструмента).

### `postnext://brand-profiles/active`

Активный профиль бренда пользователя (профиль команды по умолчанию, а если его нет, первый собственный профиль). Возвращает только поля, нужные LLM: bio, expertiseAreas, personalityTraits, brandVoice, mainThemes, audienceSize, preferredHashtags.

### `postnext://teams/current`

Метаданные текущей команды (teamId, teamName) плюс totalTeamsAvailable. Используйте вместе с list\_teams + set\_current\_team для переключения.

## Готовые сценарии

Команды из меню (/), которые объединяют несколько инструментов. Выберите сценарий, и ИИ-ассистент проведёт вас через многошаговую задачу, спрашивая подтверждение перед каждым изменением.

### `/weekly-plan`

Анализирует профиль бренда, подключённые каналы и очередь публикаций, затем предлагает 5-10 черновиков, распределённых с понедельника по пятницу.

### `/draft-thread`

Создаёт тред из 5-10 постов для Twitter или Threads по заданной теме или ссылке голосом вашего бренда.

### `/audit-queue`

Проверяет запланированные публикации на ближайшие 7 дней и отмечает дубликаты, перегруз платформ и пробелы в расписании.

### `/channel-sweep`

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

## Эндпоинты обнаружения и OAuth

Метаданные по стандартам, чтобы любой MCP-клиент мог настроиться автоматически.

- `GET /.well-known/oauth-protected-resource/api` — RFC 9728
- `GET /.well-known/oauth-authorization-server` — RFC 8414
- `GET /oauth/.well-known/openid-configuration` — OIDC
- `POST /oauth/reg` — Dynamic Client Registration (RFC 7591)
- `GET /oauth/auth` — Authorize (PKCE-S256 required)
- `POST /oauth/token` — Token exchange

## Открытый исходный код

Готовые рецепты и справочник для разработчиков размещены в нашем публичном репозитории документации. Лицензия MIT; pull-запросы приветствуются. [github.com/postnextio/postnext-mcp](https://github.com/postnextio/postnext-mcp)

## MCP для соцсетей: Claude, ChatGPT и любой ИИ-агент

MCP-сервер PostNext для соцсетей позволяет Claude, ChatGPT и любому ИИ-агенту планировать посты, готовить черновики и ставить их в расписание. Черновики ждут в вашем календаре, пока вы их не запланируете.

[Открыть в Claude Desktop](https://postnext.io/ru-ru/mcp/connect)
